Deploying the Web Component Adapter

The Web Component Adapter (WCA) is a Java web application that runs on your Web Application Server. The WCA hosts web components, including a CSP plug-in that allows you to run CSP applications on your Java Web Application Server. You must deploy the WCA to run the Crystal Management Console and CSP applications in a Java Crystal Enterprise environment.

The installation script configures the Web archive file that implements the WCA (webcompadapter.war) with specific information:

• The name and location of your Crystal Management Server.
• The default display name of the WCA.
• The location of the directories where the WCA can find CSP applications.
• The location it should use for log files.

In most situations you should not need to change these default values. If you do, see Changing the default deployment values for the WCA.

To deploy the WCA, you must first configure your Java web application server to source the env.sh script on startup, which sets a variety of environment variables used by Crystal Enterprise. (For details, see Installing a Java application server.) Then you must make cewcanative.jar available to your Java application server as a shared resource (either by placing cewcanative.jar in the application server's shared lib directory, or by adding cewcanative.jar to the CLASSPATH environment variable. Consult your application server documentation for details.) Finally you must deploy the Web Component Adapter archive webcompadapter.war as a web application.

To deploy the WCA using Tomcat on UNIX

1. Shut down Tomcat if it is running. Type $CATALINA_HOME\bin\shutdown in your terminal window.
2. Copy the Java archive file cewcanative.jar (found in crystal_root/enterprise/java/applications) to $CATALINA_HOME/shared/lib

   Substitute the root directory of your Crystal Enterprise installation for crystal_root

3. Open the file $CATALINA_HOME/conf/server.xml, in a text editor such as vi.
4. Add the following lines directly above the line <!-- Tomcat Examples Context -->:

   <Context path="/crystal"
   

   docBase="crystal_root/enterprise/java/applications/webcompadapter.war"
   

   debug="0" reloadable="false"/>
   

   where crystal_root is the root directory of your Crystal Enterprise installation.

5. Save the file.
6. Restart Tomcat by typing $CATALINA_HOME/bin/startup
7. To test the deployment of the WCA, launch the Crystal Management Console by typing http://servername:8080/crystal/enterprise10/admin in the address bar of a web browser.

   For servername, substitute the name of the machine where you installed Tomcat. If you chose to use a port number other than the default value, substitute that value for 8080.

8. Log on to the Crystal Management Console (CMC) as Administrator.

   By default, the Administrator account has no password.

9. Go to the Crystal Applications area of the CMC, and click Web Desktop.
10. On the Properties tab, ensure that the WCA context path is set to /crystal.
11. Click Update.

    You can now view reports in the Crystal Enterprise web desktop using the Active X and Java viewers.

To deploy the WCA using BEA WebLogic on UNIX

1. Make sure that your BEA WebLogic server is not running.
2. Edit your CLASSPATH environment variable to include crystal_root/enterprise/java/applications/cewcanative.jar

   Substitute the root directory of your Crystal Enterprise installation for crystal_root

3. Start your BEA WebLogic server.
4. Open a web browser, and type http://servername:7001/console in its address bar to start the BEA WebLogic Administrative Console. For servername, substitute the name of the machine where you installed BEA WebLogic. If you use a port number other than the default value, substitute that value for 7001.
5. Deploy the Web Component Adapter as a new web application. Use the .war file found at crystal_root/enterprise/java/applications/webcompadapter.war, and set the context root to /crystal (for example, by changing the name of webcompadapter.war to crystal.war)

   Note:    If the context root is not set to /crystal, the link to the Crystal Management Console from the Crystal Enterprise Admin Launchpad will not work.

6. To test that you have deployed the WCA correctly, launch the Crystal Management Console by opening a web browser and typing http://servername:7001/crystal/enterprise10/admin in its address bar. For servername, substitute the name of the machine where you installed BEA WebLogic. If you chose to use a port number other than the default value, substitute that value for 7001.
7. Log on to the Crystal Management Console (CMC) as Administrator.

   By default, the Administrator account has no password.

8. Go to the Crystal Applications area of the CMC, and click Web Desktop.
9. On the Properties tab, ensure that the WCA context path is set to /crystal.
10. Click Update.

    You can now view reports in the Crystal Enterprise web desktop using the Active X and Java viewers.

To deploy the WCA using IBM WebSphere on UNIX

1. Make sure that your IBM WebSphere server is not running.
2. Edit your CLASSPATH environment variable to include crystal_root/enterprise/java/applications/cewcanative.jar

   Substitute the root directory of your Crystal Enterprise installation for crystal_root

3. Start your IBM WebSphere Server, and launch the Administrative Console (at http://servername:9090/admin/). For servername, substitute the name of the machine where you installed IBM WebSphere. If you chose to use a port number other than the default value for the administrative console, substitute that value for 9090.
4. Deploy the Web Component Adapter as a new application. Use the .war file found at crystal_root/enterprise/java/applications/webcompadapter.war, and set the context root to /crystal

   Note:    If the context root is not set to /crystal, the link to the Crystal Management Console from the Crystal Enterprise Admin Launchpad will not work.

5. Start the new application.
6. To test that you have deployed the WCA correctly, launch the Crystal Management Console by opening a web browser and typing http://servername:9080/crystal/enterprise/admin/admin.cwr in its address bar.

   For servername, substitute the name of the machine where you installed IBM WebSphere. If you chose to use a port number other than the default value, substitute that value for 9080.

7. Log on to the Crystal Management Console (CMC) as Administrator.

   By default, the Administrator account has no password.

8. Go to the Crystal Applications area of the CMC, and click Web Desktop.
9. On the Properties tab, ensure that the WCA context path is set to /crystal.
10. Click Update.

    You can now view reports in the Crystal Enterprise web desktop using the Active X and Java viewers.