How do I activate Webtrends from the command line using the wtlicman utility?

Products

Webtrends Analytics 9.x
Webtrends Analytics 8.x

Cause

How do I activate Webtrends from the command line using the wtlicman utility?

Resolution

For Webtrends servers with internet connectivity, the following steps will guide you through the activation process using the command line. Before proceeding, open the Webtrends user interface and under Administration > Licensing > License Keys, copy the license keys and save them to a text file, noting which key is the Base License key.

The following process must be done by logging in to the Webtrends Primary Install machine with the same user account that is assigned to the Webtrends services. A standard O/S system Administrator account will not have the proper access rights.

1. On the Webtrends server, Right Click open a command line window, choose Run as Administrator and navigate to the following location: \Webtrends\common\lib
2. To deactivate the license key, type the following command: wtlicman -d

Output similar to the following should display (the date and build number will vary between versions):

WebTrends Licensing Tool
Copyright 1996-2009 WebTrends Inc. All rights reserved.
wtLicenseManager build number: 465
Deactivating Authorization Key : …
Deactivation of Authorization Key succeeded.
Warning: Your product is now deactivated and should be terminated.

3. Now type the following command: wtlicman -a -k <license key>

4. Verify the license has been successfully activated by typing the following command: wtlicman -s

When activated, detailed information will display and fill the buffer of the command line window.

Installations without external internet access or with access restrictions require manual activation and deactivation, detailed below.

1. To deactivate the license key, type the following command: wtlicman -d

This command is the same as used in the examples above for installations without access restrictions, but when the application is unable to contact the licensing server a message similar to the following displays (the date and build number will vary between versions):

WebTrends Licensing Tool
Copyright 1996-2009 WebTrends Inc. All rights reserved.
wtLicenseManager build number: 465
Deactivating Authorization Key : …
Manual Deactivation Process Required. The Manual Deactivation HTML will be written to the file DeactivateProduct.
Steps:
1. Take the HTML file to a computer with internet access
2. Double-click the filename in a file browser, e.g. Explorer, or open the file in your internet browser
3. Save the returned file when prompted by your browser
4. Bring that file back to this computer and use the following command: wtlicman -D -f .

The output from the command line provides terse instructions for deactivating the product. This article aims to provide additional clarity. It must be noted that the file to which it refers, DeactivateProduct, will be located in the same folder in which the wtlicman utility was run. It lacks an extension, but it is of html format and the file can be renamed and this extension added, or it can be opened using the “Open with” dialogue box to select a web browser as the application.

2. Copy the DeactivateProduct file to another machine on the network capable of accessing the external internet.

3. Open the file in a web browser.

4. A page will display an orange banner on top with the Webtrends logo on the left, with text below stating “Sending Manual Product Licensing Request.” This should automatically transmit the licensing information to the licensing servers. If users running Internet Explorer see a yellow ActiveX controls warning above the banner, right-click and select “Allow Blocked Content…” to ensure licensing information can be successfully transmitted. In the event it is not, click the “Click here if download does not begin automatically” button to force the prompt for download.

5. The File Download dialogue box appears and displays the following message:

Do you want to open or save this file?

Name: licensechange.txt
Type: Text Document
From: license.webtrends.com

Select the option to save the file. Note the size of the file saved. The nature of the request determines the size of the file but it will always be at least a few bytes in size. At times, latency or other technical issues may interfere with the download and result in a file of 0 kilobytes. If this occurs, either refresh the page or click the button again to repeat the process until the file returned contains content.

6. Copy licensechange.txt to the Webtrends server, saving it in the following location: \Webtrends\common\lib

7. Return to the command line window on the server and type the following command: wtlicman -D -f licensechange.txt

Note: The spelling of “license” follows U.S. convention.

Output similar to the following should display (the date and build number will vary between versions):

WebTrends Licensing Tool
Copyright 1996-2009 WebTrends Inc. All rights reserved.

wtLicenseManager build number: 465

Deactivating Authorization Key : …

Deactivation of Authorization Key succeeded.
Warning: Your product is now deactivated and should be terminated.

8. Type the following command to reactivate the product: wtlicman -a -k <license key>

As before, when the application is unable to contact the licensing server a message similar to the following displays (the date and build number will vary between versions):

WebTrends Licensing Tool
Copyright 1996-2009 WebTrends Inc. All rights reserved.

wtLicenseManager build number: 465

Activating: …
Manual Activation Process Required. The Manual Activation HTML will be written to the file .htm.
Steps:
1. Take the HTML file to a computer with internet access
2. Double-click the filename in a file browser, e.g. Explorer, or open the file in your internet browser
3. Save the returned file when prompted by your browser
4. Bring that file back to this computer and use the following command: wtlicman -A -f .

If Activation is successful and you are using serial number for an older version of this product, be sure to write down your new Authorization Key. The old serial numbers will not be usable again. The new Authorization Key must be used instead.

The file generated when attempting to manually activate the product will be named after the base license key, with an .htm extension, and will be found in the same location.

9. Copy .htm to another machine on the network capable of accessing the external internet.

10. Open the file in a web browser.

11. A page will display an orange banner on top with the Webtrends logo on the left, with text below stating “Sending Manual Product Licensing Request.” This should automatically transmit the licensing information to the licensing servers. If users running Internet Explorer see a yellow ActiveX controls warning above the banner, right-click and select “Allow Blocked Content…” to ensure licensing information can be successfully transmitted. In the event it is not, click the “Click here if download does not begin automatically” button to force the prompt for download.

12. The File Download dialogue box appears and displays the following message:

Do you want to open or save this file?

Name: licensechange.txt
Type: Text Document
From: license.webtrends.com

13. Copy licensechange.txt to the Webtrends server, saving it in the following location: \Webtrends\common\lib

14. Return to the command line window on the server and type the following command: wtlicman -A -f licensechange.txt

Note: The spelling of “license” still follows U.S. convention.

Output similar to the following should display (the date and build number will vary between versions):

15. Verify the license has been successfully activated by typing the following command: wtlicman -s

The application will now be accessible and capable of analysis.

More Information

Under certain conditions, it is possible that the licensing command may return a message saying it has failed to write to the database. This is not always the case and may just be due to a slow database response. To verify the license has been successfully activated by typing the following command: wtlicman -s