Installing Reflection

Management Server

The Reflection Administrator management server (Emulation & Administration) must run as a servlet within a servlet runner. If you use a servlet runner other than the one supplied with Reflection, see the documentation supplied with your servlet runner for information on where to install web applications and what settings to configure.

If you want to use a servlet runner other than the one automatically installed with Reflection (Tomcat), 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 rweb.zip or rweb.war to install the management server (located on the CD-ROM for your platform in the \install\nonautomated\ directory).

Installing rweb.zip or rweb.war

If you have installed tomcat.zip, follow these steps:

1. If you are using the rweb.war file, create an rweb directory within the webapps directory. The path to the rweb directory might be:
   
      /usr/local/ReflectionServer/jakarta-tomcat-[version number]/webapps/rweb/
   
   In this procedure, the sample paths given are for UNIX or Linux installations. The equivalent path in Windows, in this example, would be:    c:\Program Files\ReflectionServer\jakarta-tomcat-[version number]\webapps\rweb\
   
   If you are using the rweb.zip file, the rweb directory will be created when you unzip the file. Extract rweb.zip into /usr/local/ReflectionServer/jakarta-tomcat-[version number]/webapps/.
   
   
2. Check the directory structure to make sure that the rweb directory is within the webapps directory, and that the rweb directory has not been duplicated.
   
   

Configuring the management server

1. Open the web.xml file in a text editor, such as Notepad. The path to the file is /usr/local/jakarta-tomcat-[version number]/webapps/rweb/WEB-INF/web.xml.
   
   
2. In the web.xml file, replace the value for rwebdata_location_placeholder with /usr/local/ReflectionServer/ReflectionData (or the location and name of the directory you define) and the value for https_port_placeholder with the HTTPS port number. The HTTPS port should be unused; the default is 443. The resulting lines look like this:
   

   <context-param>
  <param-name>ReflectionData</param-name>
   <param-value>/usr/local/ReflectionServer/ReflectionData</param-value>
</context-param>
<context-param>
   <param-name>sslport</param-name>
   <param-value>443</param-value>
</context-param>

3. Edit server.xml found in /usr/local/jakarta-tomcat-[version number]/conf/ if you did not use default settings. Modify the SSL port, non-SSL port, and non-SSL redirectPort values. Ensure that the port numbers are not in use elsewhere.
   
   
4. If you want to use HTTPS to access the web application and you have installed tomcat.zip, import or create a certificate using the Certificate Wizard.
   
   

After you have installed the management server and completed this initial configuration, start the servlet runner and run the Administrative WebStation.