An Actuate Java Components web application resides in a context root. You specify the Java Components context root by naming the WAR file. For example, if your web archive (.war) file were named ActuateJavaComponent.war and you deployed it on an Apache Tomcat web server, the URL to access the application is:
http://<web server>:<port>/ActuateJavaComponent/
Apply a similar process to setup other application servers and servlet engines. By configuring the context root, the application server will route requests from the user’s browser for Java Components web content to the JSPs in the context root.
You can create several Actuate Java Components context roots. Each context root can contain a web reporting application that uses a different design. For example, you can create different web reporting applications for particular language groups or departments.
How to create a new context root
In the following example, you create a custom reporting web application for MyCorp’s Marketing Communications group. You want your Marketing Communications users to use the following URI prefix to access their custom application:
http://MyCorp:8080/marcom
For example, to access their application’s login page they would choose a web page hyperlink with the following URI:
http://MyCorp:8080/marcom/login.do
1 Extract the contents of the Java Components WAR or EAR file into a temporary directory.
On a Windows server, open a command window and type the following commands, replacing the E: DVD drive letter with the path of your Java Component WAR file:
cd C:\Temp\jc
copy E:\ActuateJavaComponent.war
jar -xf ActuateJavaComponent.war
The Java Components files appear in the temporary directory. Leave the command window open.
On a LINUX or UNIX server, type the following commands, replacing the DVD drive name with the path of your Java Component WAR file:
cd /temp/jc
cp /dev/dsk/cd/ActuateJavaComponent.war .
jar -xf ActuateJavaComponent.war
The Actuate Java Components files appear in the temporary directory.
2 Use the jar utility to create a marcom.war file. Type the following command:
jar -cf ../marcom.war *
This command creates marcomt.war in the parent directory. This new Java Components WAR file now has the context root marcom.
3 Deploy the marcom.war file to the application server or servlet engine on the MyCorp host as an application. Set the service port to 8080.
4 Restart your application server or JSP engine. For example, to restart Apache Tomcat on a Windows XP system, perform the following steps:
1 From the Windows Start menu, choose All Programs➛Administrative Tools➛Services.
2 On Services, select Apache Tomcat service.
3 From the menu, choose Action➛Restart.
4 Close Services.
After you stop and restart the server, your Marketing Communications users can access the Java Components web application called marcom. The application looks like the default Actuate Java Components application because you have not customized its appearance.
On a Windows server, open a command window and type the following commands, replacing the E: DVD drive letter with the path of your Java Component WAR file: