Technical Notes

Installing Reflection for the Web Metering Server in UNIX
Technical Note 1824
Last Reviewed 30-May-2008
Applies To
Reflection for the Web 2008 (All Editions)
Reflection for the Web version 8.0 through 9.x
Summary

Follow the steps in this technical note to manually install and configure Reflection for the Web's optional metering server feature on UNIX systems. This information is helpful if you experience difficulties with an automated installer or if no automated installer is available to install Reflection for the Web on your platform.

For information about manually installing Reflection for the Web on UNIX or Linux, refer to Technical Note 1699.

Before You Begin

• Java version 1.5 or higher is strongly recommended to configure Reflection for the Web 2008 metering server; Java version 1.4 or higher for earlier versions. You can download the J2SE SDK (JDK) from http://java.sun.com/j2se if your server does not have this version. 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.
• Beginning in Reflection for the Web 2008, the Tomcat directory no longer includes the version number, /jakarta-tomcat/; previous versions did, for example, /jakarta-tomcat-5.0.28/. This technical note will refer to the current Tomcat directory, /jakarta-tomcat/.

Installing and Configuring the Metering Server

This section provides details on installing and configuring the Reflection for the Web 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:

1. From the Reflection for the Web downloaded product files (or the product CD), copy the zipped rwebmeter file, at \install\nonautomated\rwebmeter.zip to /opt/ReflectionServer/jakarta-tomcat/webapps.

2. Use the following command to unzip rwebmeter.zip:

3. Navigate to the /usr/local/ directory and create a new directory named ReflectionData (if one does not already exist).
4. Following the steps below to edit the web.xml file.
   1. Navigate to /usr/local/jakarta-tomcat/webapps/rwebmeter/WEB-INF.
   2. Open the file web.xml in the editor of your choice.
   3. 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:

5. Save the file.
6. 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.

1. Open the Administrative WebStation and on the table of contents (left-navigation bar) under Tools, click Settings.
2. In the Settings tool, click the Metering tab.
3. In the "Metering web server name" field, enter the fully-qualified name or IP address of the server where the Reflection for the Web metering component is installed.
4. In the "Metering web server port" field, enter the HTTP port number (the default is 80—if you are using a different port number for the Reflection management server, modify this port number accordingly.)

5. 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".
6. 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:

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 Installation Guide.

Creating Metered Terminal Sessions

Once the metering server has been installed and configured, you can create metered terminal sessions in the Administrative WebStation.

1. In the Administrative WebStation table of contents (left-navigation bar), click Session Manager under Tools.
2. Click the Add button or click a session name to edit it.
3. On the Configure a Session page, click the Launch button.
4. In the emulation window on the Administration menu, click Metering Setup.
5. 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.
6. Click OK, close the emulation window, and save your changes.

Related Technical Notes

1699	Installing Reflection for the Web on UNIX or Linux
1812	Setting Up the Reflection for the Web Security Proxy Server in UNIX, Linux, or Mac OS X