Before You Begin
Before installing the Reflection for the Web or Reflection Security Gateway (hereinafter called Reflection) portlet, you must have the following installed and configured.
- WebSphere Portal Server 5.x or higher
- Reflection must be running on an application server with sessions configured for your users. The following technical notes provide examples of installing Reflection on an application server: Technical Note 1779 and Technical Note 2332.
Obtaining the RWebPA.war File
Prior to installing the portlet, you must obtain the RWebPA.war file, which you will use to install the Reflection portlet.
- If you have WebSphere Application Server installed, the RWebPA.war file is located in %WASHOME%installedAppsRWebWASAS6Node01Cellrweb_war.earrweb.warWEB-INFmisc.
- If you do not have WebSphere Application Server installed, you can extract the RWebPA.war file from the rweb.war file located in the nonautomated directory of the downloaded product files (or on the Reflection CD). Use an archiving utility, such as WinZip, to extract the .war file.
Installing Reflection Portlet on the WebSphere Portal Server
With Reflection installed and configured on your application server, you are ready to install the Reflection portlet to the WebSphere Portal Server.
- Copy the RWebPA.war file to a temporary directory on the WebSphere Portal Server.
- Open a browser and log in to the portal with an account that has administrative rights.
- Click the Administration option in the upper-right corner of the screen.
- Click Portlet Management on the left pane to open the Manage Web Modules page.
- Click Install and enter the path, including the filename RWebPA.war, or browse to the RWebPA.war file (for example, C:tempRWebPA.war or /u/local/RWebPA.war).
- Click Next, and then click Finish.
- Under Portlet Management, click Portlets. From the list of portlets, select “RWeb portlet.”
There are multiple pages listing the portlets. You can use the Search tool to locate the RWeb portlet; select “Title starts with” or “Title contains” from the Searchby drop-down list, and enter rweb in the Search field. If RWeb portlet is not listed, you may have to logout and log back into the portal server for the portlet to be listed.
- On the right side of the Portlet row, click the Configure icon to setup the portlet.
- Two parameters are listed for the RWeb portlet. Make a note of the parameters and values listed; they will be used later.
- To provide the correct URL for the portlet, you must delete the parameter RWebURL, and then add it back:
- Delete RWebURL.
- Under New parameter, enter RWebURL. (This parameter is case sensitive).
- Under New value, enter the URL exactly as it was displayed in the example (for example, http://myserver:9080/rweb/LoginPage.do?appletOnly=true), but update the localhost name and port with the DNS name (or IP address) and port of the Reflection for the Web server.
To launch a session automatically when the user opens the portal page, enter that specific session’s URL (which can be copied from the Session Manager on the Administrative WebStation) as the RWebURL value.
- Click Add, and then click OK.
You can now add the Reflection portlet to any of the WebSphere portal pages.
Configuring the Shared Secret between the Portlet and the Reflection Server
The RWebPA.properties file contains the shared secret that the portlet uses to authenticate to the Reflection server. The shared secret needs to match what is configured on the Reflection server.
- Create a text file named RWebPA.properties at the location defined in the value of AC.RWebSSOSharedKeyPropsFile; see step 9 in Installing Reflection Portlet on the WebSphere Portal Server.
- In the RWebPA.properties file add the following line:
Replace sharedsecret (case sensitive) with the value you want to use to authenticate the portlet to the Reflection for the Web server.
- Save the file.
- Launch the Reflection Administrative WebStation.
- Under Tools, click Access Control Setup > Configure.
- Under “Choose authentication method,” click Portal, and then click Next.
- Enter the shared secret (case sensitive) that was added to the RwebPA.properties in step 2, and then click Next.
- Select the authorization method that best meets your needs and click Next.
- Click Save Settings.
- Click Access Mapper and assign the sessions you would like users to see.
Configuring the WebSphere Application Server
If you run Reflection on a WebSphere Application Server (WAS), then you must enable “URL rewriting” on the WAS server.
If you run Reflection on another application server (not WAS), skip this section and proceed to Adding the Portlet to the WebSphere Portal (An Example).
Note: At this time, you can enable “URL rewriting” on the WAS at the server level only, not at the application level.
- Open and log in to the WAS Administration Console.
- Click Servers > Application servers.
- Click the server on which Reflection is installed.
- Click Session management.
- Select the “URL rewriting” check box to enable it.
- Click OK.
- Click Save to save the change to the master configuration.
- Stop and restart the WAS server.
Adding the Portlet to the WebSphere Portal (An Example)
The following steps describe one way to add the Reflection portlet to a WebSphere portal page.
- Open and log in to the portal with an account that has administrative rights.
- Click the Administration option in the upper-right corner of the screen.
- Under the left pane, click Portal User Interface > Manage Pages.
- Click My Portal under the Title column.
- Click the Edit Page Layout icon on the right of the Welcome page row.
- In one of the three columns, click Add portlets.
- Scan the list of portlets and select the “RWeb portlet” check box.
- Click OK. The portlet should be added to the configuration of the Welcome page.
- Click Done.
Test the Portlet
Follow these steps to ensure that the portlet works.
- Log in to the WebSphere Portal server.
- Select the web page to which the portlet was added.
- Verify that Reflection sessions are listed in the portlet.
Before You Begin
Before installing Reflection for the Web or Reflection Security Gateway (hereinafter referred to as Reflection), you must have all of the following installed and configured on your host.
- WebSphere Application Server 5.0.2 or higher.
- Java Developer Kit 1.5 or higher.
- Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files. For details, see Applying the JCE Unlimited Strength Jurisdiction Policy Files.
- The most recent WebSphere cumulative and group program temporary fixes (PTFs) must be applied.
- Reflection requires 220 MB of free disk space in the hosts /tmp file during installation.
- If you want to use security (HTTPS, SSL) with the WebSphere Application Server (WAS), refer to your IBM documentation to properly configure the WAS.
Installing Reflection for the Web
After the WebSphere Application Server has been properly installed and tested, follow the steps below to install Reflection.
Prepare the rweb.war File
Follow these steps to prepare the rweb.war file:
- Copy the rweb.war file located with the downloaded product files to a temporary folder on your PC. The file location depends on your Reflection product:
Reflection for the Web 2014 or 2011 or Reflection Security Gateway 2014: /install_manual/components/rweb.war
Reflection for the Web 2008: /nonautomated/rweb.war
- During download, the rweb.war file may be named rweb.war.zip. If so, rename rweb.war.zip to rweb.war.
Note: When renaming the file, you may receive an error stating that the file may become unstable. Click Yes to proceed.
Update the WebSphere Server Settings
Follow the steps below to update the WebSphere Server settings:
- Open the WebSphere Administration Console. By default, this is accessed from http://<myserver>:9060/admin or http://<myserver>: 9060/ibm/console.
- On the left-navigation bar, expand Applications, and then click Install New Application.
- In the main window, select the “Local file system” radio button and enter the path to the rweb.war file. For example:
C:Temprweb.war –or– /u/local/rweb.war
- Select the “Show me all installation options and parameters” radio button.
- In the Context root entry field, enter /rweb, and then click Next.
- Select the “Generate Default Bindings” check box, leave all other values at default, and then click Next.
- Click Next through the Install New Application dialog box, accepting defaults.
- Select the rweb.war check box, make sure the Virtual Host is set to default_host, and then click Next.
- Print the Summary page for your records, and then click Finish.
The new rweb.war application is installed and the Administration Console screen opens. If you expand the Applications menu and select Enterprise Applications, the application state for rweb should be Stopped.
Click Save to update the master configuration.
Update the web.xml File
There are two copies of the web.xml file, located in the following directories:
– and –
Note: If this is a WebSphere Application Server Network Deployment, there is an additional web.xml that must be updated:
In both (or all three) files, locate the <param-name>ReflectionData</param-name> section and modify the file to include the data in red below, entering your path to ReflectionData (for example, C:ReflectionData or /u/local/ReflectionData), and substituting your own sslport value for 443. Note: If the ReflectionData directory does not already exist, you must manually create it.
Reflection stores configuration information in the ReflectionData directory. If this is a UNIX installation, ensure that rights are set so that Reflection can write to the ReflectionData directory.
Note: In Reflection, the sslport parameter is located in the PropertyDS.xml file, which is located in the ReflectionData folder. If you want to use a port other than default port 443; you must edit PropertyDS.xml after Reflection for the Web is started in WebSphere.
Once you have updated and saved both (or all three) of the web.xml files, return to the Administrative Console window and follow the steps below.
- Expand the Applications menu item, and then click Enterprise Applications.
- In the Enterprise Applications dialog, select the rweb check box, and then click Start. The application status will change to a started, indicated by a green arrow in the Status field.
- Update the sslport parameter in the PropertyDS.xml, if you need to. Once updated, restart the Application Server using the WebSphere Administrative Console, performing steps 1 and 2 above.
Reflection is now installed. To access Reflection, open a browser and enter the URL, WAS port, and context root to your server.
For example: http://rweb.atm.com:9080/rweb
Applying the JCE Unlimited Strength Jurisdiction Policy Files
Reflection Security Gateway 2014 R2 and Reflection for the Web 2014 R2 require the Java Cryptography Extension (JCE) Unlimited Strength Policy Files. “Unlimited strength” policy files contain no restrictions on cryptographic strengths, in contrast to the “strong” but limited cryptography policy files bundled in a JRE.
To apply the policy files:
- Download the Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files from Oracle or IBM. Be sure to download the correct policy file updates for your version of Java:
- Uncompress and extract the downloaded file. The download includes a Readme.txt and two .jar files with the same names as the existing policy files.
- Locate the two existing policy files local_policy.jar and US_export_policy.jar in the following directory:
– Windows:C:Program FilesJavajre<version>libsecurity
- Replace the existing policy files with the unlimited strength policy files you extracted.