Licensing a Java Component in a WAR file

The installation files include an evaluation license for using each of the components for a limited time. After installation, check the evaluation license expiration date by opening the reportService log in the following directory:

<Tomcat install directory>/webapps/newJavaComponent/logs

Figure 3‑7 shows the reportService log on Windows.

Figure 3‑7 Checking the license expiration date and supported options

When you complete the evaluation, replace the evaluation license with a permanent license. After obtaining a new license key file, as explained earlier, perform the steps in the following procedure:

How to license a BIRT Java Component

1 Rename the BIRT Java Component license file that Actuate sent you to ajclicense.xml.

2 Decompress the BIRT Java Component WAR file.

jar -xf ActuateJavaComponent.war

The BIRT Java Component files appear.

3 Copy the ajclicense.xml file into the extracted <context root>\WEB-INF directory. For example, assuming you named the file newJavaComponent.war, the path to access the WEB-INF directory is:

<Tomcat install directory>/webapps/newJavaComponent/WEB-INF

4 Assuming WEB-INF is your current directory, move up one directory and type the following command on Windows or Linux:

jar -cf MyJavaComponent.war *

This command creates MyJavaComponent.war. This WAR file contains the license. The WAR file now has the context root MyJavaComponent.

5 Deploy MyJavaComponent.war to the application server or servlet engine as an application, as described earlier.

6 Restart the application server or servlet engine.