This section discusses deploying a BIRT Java Component WAR file. For example purposes, deployment on Tomcat 6 is shown.
To deploy the WAR file on an application server other than Tomcat 6, use your application server’s deployment tools. If your application server does not have deployment tools, add the Java Components context root to your application server. Typically, you modify the application server's configuration file.
Deploying the WAR file on Apache Tomcat
Perform the steps in the following procedure to deploy the WAR file by putting it in the /webapps directory.
How to deploy the WAR file on Apache Tomcat
1 Stop the Apache Tomcat service.
2 Copy the renamed BIRT Java Component WAR file from the working directory to the /webapps directory of your Tomcat installation files, as shown in Figure 2‑3.
Figure 2‑3 Copying the WAR file to /webapps on Linux
3 Start Tomcat.
The Tomcat log confirms the deployment of the WAR file and the location of the /temp directory that you created earlier.
Figure 2‑4 shows an example of a Tomcat log file on Linux.
Figure 2‑4 Tomcat log file confirms deployment
Deploying Actuate Java Components EARs to JBoss 6
To deploy Actuate BIRT Java Component EARs to JBoss 6, you must remove the commons-logging.jar library from the EAR file before deploying it. Leaving this file in the EAR causes JBoss 6 to throw an exception during deployment.
The commons-logging.jar file is still necessary for deployments to JBoss 5 and JBoss 7.
To deploy Java Components to JBoss 6, perform the following steps:
1 In a separate directory, extract the contents of JBOSS_ActuateBIRTJavaComponent.ear by typing the following command into a command prompt:
jar -xf JBOSS_ActuateBIRTJavaComponent.ear
Keep all extracted files together in their original relative locations.
2 Copy JBOSS_ActuateBIRTJavaComponent.war into a separate directory and extract the contents of JBOSS_ActuateBIRTJavaComponent.war by typing the following command into a command prompt:
4 Compress the all files in the directory into a war file by typing the following command:
jar -cf JBOSS_ActuateBIRTJavaComponent.war *
5 Copy JBOSS_ActuateBIRTJavaComponent.war into the separate directory containing the extracted files from JBOSS_ActuateBIRTJavaComponent.ear. Compress these files into a ear file by typing the following command:
jar -cf JBOSS_ActuateBIRTJavaComponent.ear *
6 Deploy JBOSS_ActuateBIRTJavaComponent.ear to the JBoss 6 server.
