How do I activate Webtrends from the command line using the wtlicman utility?
For products:
Webtrends Analytics 9.2x
Webtrends Analytics 8.x
Webtrends Enterprise 7.x
Webtrends Professional 7.x
Webtrends Small Business 7.x
Webtrends Log Analyzer 7.x
A video attachment showing how to manually de-license and license a server, then obtain an output of license usage is provided at the bottom of this knowledge base article.
Last modified: 1/1/2011
Introduction:
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.
1. On the Webtrends server, open a command line window 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 : <base license key>...
Deactivation of Authorization Key <base license key> succeeded.
Warning: Your product is now deactivated and should be terminated.
3. Now type the following command:
wtlicman -a -k
<base license key>
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
Activating: <base license key>...succeeded
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 : <base license 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 <name_of_text_file>.
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 : <base license key>...
Deactivation of Authorization Key <base license key> succeeded.
Warning: Your product is now deactivated and should be terminated.
8. Type the following command to reactivate the product:
wtlicman -a -k
<base 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: <base license key>...
Manual Activation Process Required. The Manual Activation HTML will be written to the file <base license key>.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 <name_of_text_file>.
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 <base license key>.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
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.
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):
WebTrends Licensing Tool
Copyright 1996-2009 WebTrends Inc. All rights reserved.
wtLicenseManager build number: 465
Reading Manual Text from file...
Activating from Manual Text...succeeded
succeeded
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.
Solution Attachments:
wtlicman_how_to.avi
Related Articles
How do I activate Webtrends from the command line using the wtlicman utility?
For products: Webtrends Analytics 9.2x Webtrends Analytics 8.x Webtrends Enterprise 7.x Webtrends Professional 7.x Webtrends Small Business 7.x Webtrends Log Analyzer 7.x Last modified: 1/1/2011 Introduction: For Webtrends servers with internet ...
Error: 'Unable to initialize the license manager' when licensing Webtrends from the command line
For products: Webtrends Analytics 9.2a Webtrends Analytics 8.7d Webtrends Analytics 8.5x Last modified: 12/9/2010 Situation: When attempting to use the wtlicman utility from the command line on 64-bit operating system, the following error displays: ...
The Pages report shows secure pages using http, not https
For products: Webtrends On Demand Webtrends Analytics 9.2x Webtrends Analytics 8.x Last modified: 3/1/2011 Situation: The pages report shows secure pages with the "http" protocol, when "https" is the expected protocol. Solution: By default, Webtrends ...
What are the advantages of using the v10 tag?
Products Webtrends On Demand Question What are the advantages of using the v10 tag? Answer Webtrends Streams This only works with the v10 tag. Social analytics features built-in Webtrends is the leader in social analytics: in addition to our ...
Webtrends On Premises Backup
Before making non-trivial changes to a Webtrends On Premises installation it is recommended a backup of the system's core components be made to allow recovery of the installation should issues arise. Webtrends services needs to be stopped during the ...