After installing BIRT iHub System using a temporary license file, such as an evaluation license, you must collect information about the machines running BIRT iHub software and send it to Actuate Licensing. During the installation process, the install program prompts you to provide the location of the license file. After providing the location of the license file, the install program issues a prompt similar to the following message.:
The iHub system license file is locked to the machines that are used in the iHub system. The following machine id must be used to request a node key license file from Actuate:
Please contact Actuate Licensing (licensing@actuate.com or http://www.actuate.com/licensing), or your representative, and request a node locked iHub system license.
The machine id required for the node locked iHub system license can also be generated by using the acmachineid utility that can be found in the ACTUATE_HOME\iHub\bin folder.
The format of the alphanumeric string for the machine ID and location of the license file are different depending on the operating system. On a Windows system, the unique identifier for the network card is the source of the machine ID. You must have at least one network card enabled on the BIRT iHub machine to be able to obtain the machine ID.
After installing BIRT iHub, you must run the utility, acmachineid, from the command line to generate the machine ID information. Copy the machine ID in the command prompt to a file or e-mail message and send it to Actuate Licensing. Actuate Licensing processes your request and sends the new license file for BIRT iHub System.
How to use the acmachineid utility
Use the acmachineid utility to obtain the machine ID information by performing the following tasks:
1 Open a command prompt and navigate to AC_SERVER_HOME\bin.
2 Type the following command and press Enter:
acmachineid
The utility provides output in the following format:
Send the licenselocation.txt file automatically generated by the execution of the acmachineid utility to Actuate Licensing as an email attachment.
How to obtain a license file
To register as a new user and obtain a new license file for a product, go to the Actuate Support web site at the following location:
http://support.actuate.com/SiteRegister
Enter the new user account and license key request information.
A maintenance customer should have login information for the Actuate e.Support web site. If you do not have access, please contact Actuate Licensing at licensing@actuate.com.
If you are not a direct Actuate customer, contact the partner or distributor who supplies the product for the license file. If you have a problem obtaining a license file from this source, please contact Actuate Licensing at licensing@actuate.com.
Updating the BIRT iHub System license file
After performing an installation of BIRT iHub System and transmitting the required machine ID information to obtain a license, Actuate sends an e-mail containing an attached .txt (TXT) file. Replace the .txt extension with a .zip (ZIP) extension and open the file. This ZIP file contains the following files:
readme.txt
Instructions for installing BIRT iHub System using a license file and for obtaining a license file
Actuate_iHub_key_XXXXXXX.xml
BIRT iHub System license
An Actuate license file is an XML file. Actuate Licensing sends this XML file inside a ZIP file with its extension altered to TXT because transmitting a file with a .xml extension can cause problems in an e-mail system.
How to install the license file
To install the license file, perform the following steps:
1 Extract the contents of the ZIP file to a location on your local file system.
2 Log in to System Console. For example, open a browser and type the following URL address, http://localhost:8500/sysconsole, and log in using the system administrator ID and password.
3 In Clusters—License, choose Update License.
4 On Update License, choose Choose File and browse to navigate to the location where you extracted the contents of the ZIP file. Select the Actuate BIRT iHub System license file and choose Save to apply the license.
If iHub requires a system restart to update the license file, the following message appears:
The license file cannot be applied without a server restart. Please copy the license file to the iHub license file location and restart the iHub system.
5 Restart any node where the node-key configuration changed.
If you change the machine on which you installed BIRT iHub, you must re‑apply to Actuate Licensing for a new license file. If you replace the network card on some machines, such as a Windows system, you may have to obtain a new license file since the unique identifier for the network card may be the source of the machine ID. If you have a license file installed and a reminder message appears when logging into System Console, contact Actuate Licensing and provide the current BIRT iHub System license file with the output from the machine ID utility.
Actuate_iHub_key_XXXXX.xml will contain the node key information for the stand‑alone machine or all machines in a cluster. There is no separate node license file for each machine.
Listing 4‑1 shows a sample of the node key information the license contains obtained from acmachineid output submitted to Actuate Licensing.
readme.txt