Installing Reflection

Security Proxy

To run the security proxy server and the Security Proxy Wizard, Java Runtime Environment (JRE) 1.2 or above must be installed and configured on your computer.

If you want to use a Java Runtime Environment other than the one automatically installed with Reflection (Sun JRE 5.0), if you are installing on a platform for which an automated installer is not provided, or if you cannot run the automated installer for any reason, use rwebproxy.zip to install the security proxy (located on the CD-ROM for your platform in the \install\nonautomated\ directory).

Installing rwebproxy.zip

1. Locate the rwebproxy.zip file in the \install\nonautomated\ directory of the product CD.
   
   
2. Extract rwebproxy.zip into any directory. The default path in automated installations is [Reflection management server installation]\securityproxy\.

Configuring the Security Proxy

The security proxy component includes the Security Proxy Wizard and the security proxy server, both of which require some additional initial configuration when installed manually.

Windows

1. In a text editor, open the SecurityWizard.bat and SecurityProxy.bat files located in the [installation path]\securityproxy\bin\ folder. Complete the following edits in both files.
   
   
2. Add the path to java.exe at the JAVA_EXE line. For example, the resulting line might look like this:
   
       set JAVA_EXE=C:\Sun\AppServer\jdk\bin\java.exe
   
   
3. If you run the wizard from a Command Prompt directly from the securityproxy folder, retain the default directory setting. In other cases, enter the complete path to the lib folder. For example, the line might look like this:
   
       set LIB_DIR=C:\Program Files\ReflectionServer\securityproxy\lib
   
   
4. If you are using a Java version prior to 1.4, uncomment this line:
   
       set CP=%LIB_DIR%/KeyToolsPro_jdk1-2.jar;%CP%
   
   and comment out the lines that include the KeyToolsPro files used for Java versions 1.4 and later.
   
   
5. Save your changes.
   
   

UNIX or Linux

The Security Proxy Wizard requires an X11 window to display its graphical interface. Use the console of an X window, or an X session, as provided with Reflection X, and open a terminal window.

1. In a text editor, open the SecurityWizard.sh file located in the [installation path]/securityproxy/bin/ directory.
   
   
2. Add the path to java at the JAVA_EXE line. For example, the resulting line might look like this:
   
       set  JAVA_EXE=/usr/java/jdk/bin/java
   
   
3. If you run the wizard directly from the securityproxy directory, retain the default directory setting. In other cases, enter the complete path to the lib directory. For example, the line might look like this:
   
       set  LIB_DIR=/usr/local/ReflectionServer/securityproxy/lib
   
   
4. If you are using a Java version prior to 1.4, uncomment this line:
   
       CP=$CP:"${LIB_DIR}/KeyToolsPro_jdk1-2.jar"
   
   and comment out the lines that include the KeyToolsPro files used for Java versions 1.4 and later.
   
   
5. Save your changes.
   
   
6. Open [installation path]/securityproxy/bin/SecurityProxy.sh in a text editor.
   
   
7. At the JAVA_HOME line, add the path to the directory above the bin directory. The resulting line might look like this:
   
       JAVA_HOME=/usr/java/jdk
   
   
8. If you installed the security proxy in default folders, retain the default WRQ_PROXY_HOME setting. In other cases, enter the complete path to the security proxy. For example, the resulting line might look like this:
   
       WRQ_PROXY_HOME=/usr/ReflectionServer/securityproxy


9. If you are using a version of Java prior to 1.4, uncomment the proxy classpath line that reads:
   
   PROXY_CLASSPATH=$WRQ_PROXY_HOME/lib/KeyToolsPro_jdk1-2.jar:$PROXY_CLASSPATH
   
   and comment out the lines that include the KeyToolsPro files used for Java versions 1.4 and later.
   
   
10. Save your changes.
    
    

After you have installed the security proxy server and completed this initial configuration, generate or import a management server security certificate.