Updating the Actuate BIRT iHub System license file
After performing an installation of Actuate 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 Actuate BIRT iHub System using a license file and for obtaining a license file
Actuate_iHub_key_XXXXXXX.xml
Actuate BIRT iHub System license
An Actuate license file is an XML file. Actuate Licensing sends this XML file inside of a TXT file because transmitting a file with an .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 Configuration Console. For example, type http://localhost:8900/acadmin/config/ in Address of a browser, and use the system configuration password that you specified during installation.
3 Choose Update License. If you do not see Update License, choose Simple view in the upper right corner.
4 On Actuate iHub update license, choose 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 OK 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.
If this message appears, perform the following tasks:
1 Stop iHub system by choosing Stop system.
2 Copy the new license file to the shared location specified by the <AC_CONFIG_HOME> attribute of the <Server> element in the acpmdconfig.xml file. The <AC_CONFIG_HOME> attribute in the acpmdconfig.xml files for all nodes in a cluster point to this shared location.
3 Delete the old acserverlicense.xml file.
4 Rename the new license file to acserverlicense.xml.
5 Start iHub System.
5 Restart any node where the node-key configuration changed.
If you change the machine on which you installed Actuate 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 Actuate Management Console, contact Actuate Licensing and provide the current Actuate 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 9‑1 shows the node key information the license contains, obtained from the acmachineid output you submitted to Actuate Licensing.
Listing 9‑1 Viewing license node key information
<NodeKeys>
<NodeKey MachineId="E0RREHs0Jk6tu0o8AbCrVL61x7kDpLlQKwS2t1W7qM67GbO8 VjcFs6pcuAgbtZauSbFFa2mRejwVJc7ZjKfMEVl1suXglMKmZLiwtLykDa/ wJisqMS0EhYe5sCYoKjG+XL2UEnL2GGhLtI9fJUMYzZORKk23jrxaSwUDig Ksvlc1A6q8UbmrrAYHD8GgtpuiAmxWt4xjEM6rqlmsNEW/4Vjm40KxlkSv" ServerName="W7CLSTRNODE1"/>
<NodeKey
MachineId="I0RREHs0Jk6tu0o8AbCrVL61x7kDpLlQKwS2t1W7qM67GbO8 VjcFs6pcuAgbtZauSbFFa2mRejwVJc7ZjKfMEVl1suXglMKmZLiwtLykDa/ wJisqMS0EhYe5sCYoKjG+XL2UEnL2GGhLtI9fJUMYzZORKk23jrxaSwUDsg Ksvlc1A6q8UbmrrAYHD8GgtpuiAmxWt4xjEM6rqlmsNEW/4ViMC0KDBkSn"
ServerName="W7CLSTRNODE2"/>
</NodeKeys>