Technical Note 1824
Last Reviewed 02-Jun-2011
Reflection for the Web 2008 (All Editions)
Use the steps in this technical note to manually install and configure the Reflection for the Web 2008 metering server on UNIX systems.
This technical note is helpful if an automated installer is not available to install Reflection for the Web 2008 on your platform. For information about manually installing Reflection for the Web 2008 on UNIX or Linux, refer to Technical Note 1699.
If you are installing the Reflection for the Web 2014 or 2011 metering server in a UNIX environment, follow the instructions in the Installation Guide:
Reflection for the Web 2014:
Reflection for the Web 2011:
Before You Begin
- Java version 1.5 or higher is strongly recommended to configure Reflection for the Web 2008 metering server. For more information on installing the Java SDK for UNIX or Linux see the "Obtaining and Installing the Java SDK" section in Technical Note 1699.
- The Reflection for the Web metering server component must be installed as a servlet within a servlet runner. The Tomcat servlet runner is supplied with Reflection for the Web. For more information on manually installing the Tomcat servlet runner, see the "Installing and Configuring Tomcat" section in Technical Note 1699.
- This technical note refers to the Tomcat directory in Reflection for the Web 2008, which is /jakarta-tomcat/. (In Reflection for the Web 2011, the Tomcat directory is /apache-tomcat/.)
Installing and Configuring the Metering Server
This section provides details on installing and configuring the Reflection for the Web 2008 metering server. This feature is not required to run Reflection for the Web.
Installing the Metering Server
Before installing the metering server, note the following:
- The metering server can be installed on either the same machine as the Reflection management server or on a different machine.
- To install the metering server, you must be logged in to the server as root.
Follow these steps to install the metering server:
- From the Reflection for the Web 2008 downloaded product files (or the product CD), copy the zipped rwebmeter file, at \install\nonautomated\rwebmeter.zip to /opt/ReflectionServer/jakarta-tomcat/webapps.
(If you did not install to the default location, modify the path accordingly.)
- Use the following command to unzip rwebmeter.zip:
jar xf /usr/local/jakarta-tomcat/webapps/rwebmeter.zip
- Navigate to the /usr/local/ directory and create a new directory named ReflectionData (if one does not already exist).
- Following the steps below to edit the web.xml file.
- Navigate to /usr/local/jakarta-tomcat/webapps/rwebmeter/WEB-INF.
- Open the file web.xml in the editor of your choice.
- Locate the line with rwebdata_location_placeholder as the <param-value>. Replace rwebdata_location_placeholder with /opt/ReflectionServer/ReflectionData. The resulting lines look like this:
- Save the file.
- Stop and restart Tomcat.
- To stop Tomcat, navigate to /usr/local/jakarta-tomcat/bin and type ./shutdown.sh
- To start Tomcat, navigate to /usr/local/jakarta-tomcat/bin and type ./startup.sh
Configuring Metering Host Information
Before you can create a metered terminal session, the metering server must be added to the Administrative WebStation Settings tool list.
- Open the Administrative WebStation and on the table of contents (left-navigation bar) under Tools, click Settings.
- In the Settings tool, click the Metering tab.
- In the "Metering web server name" field, enter the fully-qualified name or IP address of the server where the Reflection for the Web 2008 metering component is installed.
- In the "Metering web server port" field, enter the HTTP port number (the default is 80if you are using a different port number for the Reflection management server, modify this port number accordingly.)
If "Use HTTPS" is selected, then enter the HTTPS port number.
Note: Use HTTPS for metering only if you have a CA-signed certificate for the metering server. Although a self-signed certificate can be used with the metering server, the configuration steps are complex.
- In the "Metering servlet context" field, enter the name of the directory where the metering component is installed (just the name; no path is required). The default location is "rwebmeter".
- Click Add to Table.
Opening the Metering Configuration Tool
Use the metering configuration tool to configure options for the metering server. To open the tool, open a browser and enter the metering configuration URL:
http://[host name]:[port number]/[metering server context name]/AdminStart.html
For example, if you used the default settings, the URL might be:
The default password is admin.
You can also use the metering configuration tool to configure license pools and view reports on metering activity. For more information, see the Reflection for the Web 2008 Installation Guide: http://support.attachmate.com/manuals/rweb2008.html.
Creating Metered Terminal Sessions
Once the metering server has been installed and configured, you can create metered terminal sessions in the Administrative WebStation.
- In the Administrative WebStation table of contents (left-navigation bar), click Session Manager under Tools.
- Click the Add button or click a session name to edit it.
- On the Configure a Session page, click the Launch button.
- In the emulation window on the Administration menu, click Metering Setup.
- Select the "Enable usage metering" check box, and make sure the correct metering server is selected in the Metering web server box. The "Require metering host" check box is cleared by default so that connections are made even if the metering server is unavailable. Select this check box if you want connections to be made only when the metering server is available.
- Click OK, close the emulation window, and save your changes.