Building a custom Java Component context root

An Actuate Java Component web application resides in a context root. You specify the Java Component 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 Component web content to the JSPs in the context root.

You can create several Actuate Java Component 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:8900/marcom

For example, to access their application’s login page they would choose a web page hyperlink with the following URI:

http://MyCorp:8900/marcom/login.do

1	Extract the contents of the Java Component 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 Component 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 Component 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 Component 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 8900.

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 Component web application called marcom. The application looks like the default Actuate Java Component application because you have not customized its appearance.

Copyright Actuate Corporation 2012