Attachmate Worldwide  |   Contact Us  |   NetIQ.com
Home » Support » Solution Library » Technical Notes

Technical Notes

Configuring Windows-based Reflection Session to Report to the Reflection Metering Server
Technical Note 2393
Last Reviewed 13-Nov-2008
Applies To
Reflection Administrator 2008
Reflection Administrator version 9.x
Reflection for the Web 2008
Reflection for the Web version 9.x
Reflection for IBM 2008
Reflection for IBM 2007
Reflection for IBM version 9.0 through 14.x
Reflection for UNIX and OpenVMS 2008
Reflection for UNIX and OpenVMS version 12.0 through 14.x
Reflection for HP with NS/VT version 12.0 through 14.x
Reflection X 2008
Reflection X version 12.0 through 14.x
Summary

This technical note describes how to configure Windows-based Reflection sessions to report to the Reflection metering server, a web-based tool that is included in Reflection for the Web and Reflection Administrator.

Note the following:

  • The term "Windows-based Reflection products" refers to non web-based Reflection products, such as Reflection for UNIX and OpenVMS, Reflection for IBM, and Reflection X.
  • Web-based management is available to Reflection administrators who have obtained the Reflection Administrator add-on component for use with their Reflection Windows-based products, or who have installed and configured Reflection for the Web with the appropriate licensing.
  • If you are licensed for Reflection for the Web, you have the server components necessary to centrally manage Reflection Windows-based session; however, you must still obtain the appropriate licensing to run Reflection in this manner. Licensing is provided by purchasing the Reflection Administrator add-on product.

If you do not have Reflection for the Web, to use Reflection to manage Windows-based Reflection sessions, obtain a copy of Reflection Administrator. This gives you both the required Reflection servers, and a license to use the servers to manage Windows-based Reflection sessions.

  • Windows-based Reflection sessions are available only from Windows workstations that have the supporting Windows-based Reflection client software installed.

Which Products and Versions can be Metered?

You can use the Reflection metering server to audit, control access to, and report the usage of the flowing Windows-based Reflection products and versions.

Product and Version
Metering Support
Reflection Standard Suite 2008 *
Yes
Reflection for UNIX and OpenVMS 2008 *
Yes
Reflection for UNIX and OpenVMS 12.0 - 14.x
Yes
Reflection for HP with NS/VT 12.0 - 14.x
Yes
Reflection for IBM 2008 *
Yes
Reflection for IBM 2007
No
Reflection for IBM 12.0 - 14.x
Yes
Reflection X 2008
No
Reflection X 12.0 - 14.x
Yes
Reflection FTP Client 12.0 - 14.x
Yes

* To meter the Reflection 2008 products, note the following:

  • Reflection 2008 products require Reflection for the Web 2008 R2 or Reflection Administrator 2008 R2 for metering support.
  • The Reflection for the Web 2008 login/links list does not currently support Reflection Standard Suite 2008, Reflection for UNIX and OpenVMS 2008, Reflection for IBM 2008, or Reflection X 2008 connections. These products can be metered, but cannot be started from the login/links list, shown below.

Configuring Metering

To meter Windows-based Reflection sessions, you must:

Install and Configure the Metering Server

For information about installing, and configuring the metering server, and viewing metering reports, see Technical Note 2189—Reflection for the Web Usage Metering Explained.

Once the metering server has been installed and configured, return to this technical note and proceed with Configuring Reflection Workstations to Report to the Metering Server.

Configure Reflection Workstations to Report to the Metering Server

To configure Windows-based Reflection products to report to the metering server, you can use the Customization Tool or Reflection's Group Policy (or both).

  • Use the Customization Tool to create a customized Reflection installation that includes metering configuration information. Use this tool to create custom transforms that can be used to enable metering when Reflection is deployed.

Note: The Customization Tool can only configure settings at the time of installation; it cannot be used to update the URL after your customized installation is complete. (If you use Group Policies at your site, you will probably prefer to use that approach to configuring metering, as described below. Group Policy settings are easily updated, but can not be used to configure the Meter As property.)

  • Use Reflection's Group Policy settings to configure metering information, excluding the Meter As property. This technique is convenient if you use Active Directory or if you already have a Windows-based Reflection client installation base, as group policies can be used to modify existing installations, and can be easily updated.

Note: If you want to set the Meter As property to specify the products you are licensed for, you must use the Customization Tool. All other settings can be configured using Group Policies.

Using the Customization Tool

You can use the Attachmate Customization Tool (Reflection 2008) or the Reflection Customization Manager (Reflection 12.0 - 14.x) to create a customized Reflection installation that automatically configures Reflection workstations for metering.

In Reflection for the Web/Reflection Administrator Version 2008

  1. Run the Attachmate Customization Tool from the command line or create a shortcut point to it.

To access the Attachmate Customization Tool, you must have already set up an Administrative Installation. For more information about creating an administrative installation, see the "Perform an Administrative Installation" topic in the product guide for Reflection 2008: http://docs.attachmate.com/Reflection/2008/R1/Guide/en/user-html/admin_install_image_pr.htm.

From the Command Line: At the command prompt or the Start menu Run command, enter the following command to open the Attachmate Customization Tool:

<path_to_setup>\setup.exe /admin

To create a shortcut:

    1. Right-click on the Setup.exe file and choose Create Shortcut.
    2. Right-click on the shortcut and choose Properties.
    3. In the Target field, add /admin to the end of the target line (after the last quote mark):

For example: "C:\Program Files\RAdmin" /admin

    1. Rename the shortcut as desired.
    2. Double-click the shortcut to run the Attachmate Customization Tool.
  1. In the Select Customization dialog box, choose to "Create a new Setup customization file" or "Open an existing Setup file or Companion installer," and then click OK.
  2. In the left pane, select "Licensing and session metering."
  3. Select "I accept the terms of the Software License Agreement."
  4. Entering a VPA number to identify the metered product is optional. The VPA number is required only if you want to monitor multiple Reflection products and these products are licensed under different VPA numbers. If you omit this value, the metering server uses zero.
  5. In the Meter As drop-down menu, select the product name.
  6. In the Metering URL field, enter the URL of your metering server.

Syntax:

http://[host name]:[port number]/[metering server context name]/meter.do

For example:

http://Myserver.com:80/rwebmeter/meter.do

Note: If you used the default port, you can omit the colon and port number.

  1. Select "Require metering" only if you want to prevent users from launching Reflection when the metering server is not available. (Enabling this setting can be useful when you are creating a trial installation and want to test to see if the metering server is running and available.)
  2. Click File > Save As, name the transform file (*.mst), and then click Save.
  3. Test your customized installation. Because the metering web server URL that you specify becomes a permanent part of the Reflection installation, you should always test your customized Reflection installation carefully on a test workstation to ensure that the server is successfully monitoring Reflection activity on that workstation.

Reminder: The Customization Tool can configure settings only at the time of installation; it cannot be used to update the URL after your customized installation is complete. (If you use Group Policies at your site, you may prefer to use that approach, since Group Policy settings are easily updated.)

  1. For information about how to deploy the transform while installing Reflection, see the Deploying the Transform section of Technical Note 2369.

In Reflection for the Web/Reflection Administrator Version 9.x

For information about configuring metering using the Reflection Customization Manager, refer to the Metering Reflection Products section of the Reflection Administrator Guide.

http://support.attachmate.com/manuals/radmin.html

Use Reflection's Group Policy Settings

An alternative way to configure metering is to use Reflection’s Group Policy support. This technique is convenient if you use Active Directory and for existing Reflection Web-based installations.

Note: If you want to set the Meter As property to specify the products you are licensed for, you must use the Customization Tool. All other settings can be configured using Group Policies.

To configure Group Policies to meter Reflection, follow the instructions in the version-specific references:

  • For Reflection 2008, see Technical Note 2392.
  • For Reflection 12.0 - 14.x, see the Reflection System Administrator Guide at http://docs.attachmate.com/reflection/14.0/r14sag.pdf. Refer to the following sections:
    • Expand "Locking Down Reflection Features: Profilers and Group Policies" > "Group Policy Settings" > "How To Install and Use Group Policies."
    • Expand "Metering Reflection Products" > "Configuring Metering" > "Configuring Reflection Workstations to Report to the Metering Server."
Related Technical Notes
1740 Web-based Management of Windows-based Reflection Sessions
2189 Reflection for the Web Usage Metering Explained
2369 Creating and Deploying Transforms and Companion Packages Using the Attachmate Customization Tool
2392 Using Group Policy to Meter Reflection 2008

horizontal line

Did this technical note answer your question?

Yes    No    Somewhat     Not sure yet

Additional comments about this tech note:

Need further help? For technical support, please contact Support.