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 other CSP applications, in a Java Crystal Enterprise environment.

The Crystal Enterprise setup program 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 use the cewcanative.jar archive file. Then you must deploy the Web Component Adapter archive webcompadapter.war as a web application.

To deploy the WCA using Tomcat on Windows

1. Shut down Tomcat if it is running. Type %CATALINA_HOME%\bin\shutdown in the Command Prompt window.
2. Add C:\Program Files\Crystal Decisions\Enterprise 10\win32_x86\ to the PATH environment variable. (This directory contains Crystal Enterprise DLLs that the WCA uses.)

   See To set the JAVA_HOME environment variable on Windows for instructions on how to set a Windows environment variable.

3. Copy the Java archive file cewcanative.jar (found in C:\Program Files\Crystal Decisions\Enterprise 10\java\applications) to %CATALINA_HOME%\shared\lib.
4. Open the file %CATALINA_HOME%\conf\server.xml, in a text editor such as Notepad.
5. Add the following lines directly above the line <!-- Tomcat Examples Context -->:

   <Context path="/crystal"
   

   docBase="C:\Program Files\Crystal Decisions\Enterprise 10\
java\applications\webcompadapter.war"
   

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

   Note:    If you installed Crystal Enterprise in a location other than the default installation directory of C:\Program Files\Crystal Decisions\Enterprise 10\
java\applications, adjust the path descriptions to match your install directories.

6. Save the file.
7. Restart Tomcat by typing %CATALINA_HOME%\bin\startup at the command prompt.
8. 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.

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

   By default, the Administrator account has no password.

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

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

To deploy the WCA using BEA WebLogic on Windows

1. Make sure that your BEA WebLogic server is not running.
2. Add C:\Program Files\Crystal Decisions\Enterprise 10\win32_x86\ to the PATH environment variable. (This directory contains Crystal Enterprise DLLs used by the WCA.)

   See To set the JAVA_HOME environment variable on Windows for instructions on how to set a Windows environment variable.

3. Edit your CLASSPATH environment variable to include C:\Program Files\Crystal Decisions\Enterprise 10\java\applications\cewcanative.jar
4. Start your BEA WebLogic server.
5. 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 chose to use a port number other than the default value, substitute that value for 7001.

6. Deploy the Web Component Adapter as a new web application. Use the .war file found at C:\Program Files\Crystal Decisions\Enterprise 10\
java\applications\webcompadapter.war, and set the context root to /crystal
7. To test the deployment of the WCA, launch the Crystal Management Console by 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.

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 Crystal Enterprise using the Active X and Java viewers.

To deploy the WCA using IBM WebSphere 5 on Windows

1. Make sure that your IBM WebSphere server is not running.
2. Add C:\Program Files\Crystal Decisions\Enterprise 10\win32_x86\ to the PATH environment variable. (This directory contains Crystal Enterprise DLLs used by the WCA.)

   See To set the JAVA_HOME environment variable on Windows for instructions on how to set a Windows environment variable.

3. Edit your CLASSPATH environment variable to include C:\Program Files\Crystal Decisions\Enterprise 10\java\applications\cewcanative.jar

   Note:    IBM WebSphere is case-sensitive. Make sure that you add the filename and path exactly as it appears here.

4. 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.

5. Deploy the Web Component Adapter as a new application. Use the .war file found at C:\Program Files\Crystal Decisions\Enterprise 10\java\
applications\webcompadapter.war, and set the context root to /crystal
6. Start the new application.
7. 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/enterprise10/admin/admin.cwr in the address bar of a web browser.

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

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 Crystal Enterprise using the Active X and Java viewers.