Configuring Windows-based Reflection Session to Report to the Reflection Metering Server
Technical Note 2393
Last Reviewed 25-Aug-2010
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 2011
Reflection for IBM 2008
Reflection for IBM 2007
Reflection for IBM version 14.x
Reflection for UNIX and OpenVMS 2011
Reflection for UNIX and OpenVMS 2008
Reflection for UNIX and OpenVMS version 14.x no
Reflection for HP with NS/VT version 14.x
Reflection X 2008
Reflection X version 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 2011 *
|
Yes
|
Reflection Standard Suite 2008 *
|
Yes
|
Reflection for UNIX and OpenVMS 2011 *
|
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 2011 *
|
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 2011 or 2008 products, note the following:
- Reflection 2011 or 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 2189Reflection 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 2011 or 2008) or the Reflection Customization Manager (Reflection 14.x) to create a customized Reflection installation that automatically configures Reflection workstations for metering.
In Reflection for the Web/Reflection Administrator Version 2011 or 2008
- 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 2011: http://docs.attachmate.com/Reflection/2011/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
- Right-click on the Setup.exe file and choose Create Shortcut.
- Right-click on the shortcut and choose Properties.
- 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
- Rename the shortcut as desired.
- Double-click the shortcut to run the Attachmate Customization Tool.
- 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.
- In the left pane, select "Licensing and session metering."
- Select "I accept the terms of the Software License Agreement."
- 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.
- In the Meter As drop-down menu, select the product name.
- In the Metering URL field, enter the URL of your metering server.
http://[host name]:[port number]/[metering server context name]/meter.do
http://Myserver.com:80/rwebmeter/meter.do
Note: If you used the default port, you can omit the colon and port number.
- 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.)
- Click File > Save As, name the transform file (*.mst), and then click Save.
- 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.)
- 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 2011 or 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 2011 or 2008 |