Changing the default deployment values for the WCA

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.

You may need to change some of these values to change the location of the WCA log files, if you want to deploy your custom CSP applications in a location other than the default directory, or if you plan to deploy multiple WCAs. To do so, edit the web.xml file contained in the WEB-INF directory of the archive.

Note:    See Installing multiple Web Component Adapters for further instructions before you install multiple WCAs.

To change the deployment values for the WCA

1. Stop your Java application server, if it is running.
2. Extract web.xml from webcompadapter.war using a tool such as WinZip.

   The webcompadapter.war archive file is stored in the C:\Program Files\Crystal Decisions\Enterprise 10\java\applications directory.

3. Open web.xml in a text editor such as Notepad.

   To alter the values of cspApplication.dir (the directory for your CSP applications), or log.file (the location of the log files created by the WCA), edit the following lines to change the values between the <param-value></param-value> tags:

   <context-param>
   

   <param-name>cspApplication.dir</param-name>
   

   <param-value>C:\Program Files\Crystal Decisions\Enterprise 10\Web Content</param-value>
   

   </context-param>
   

   <context-param>
   

   <param-name>log.file</param-name>
   

   <param-value>C:\Program Files\Crystal Decisions\Enterprise 10\Logging\wca</param-value>
   

   </context-param>
   

   Note:    The values shown here are the default locations that the Crystal Enterprise setup program creates when you use the default installation directory for Crystal Enterprise.

4. Edit the value between the <display-name> </display-name> tags to edit the display name of your WCA. Use the format wcaname.wca. Changing the display name of your WCA is equivalent to changing the server name of the WCS in a Windows deployment of Crystal Enterprise.
5. Edit the connection.cms context parameter to edit the name of your Crystal Management Server. (Add the name of your CMS between the <param-value> </param-value> tags for this context parameter.)
6. Save web.xml, then reinsert the file into the WEB-INF directory within webcompadapter.war.

   Tip:    To reinsert web.xml into WEB-INF using WinZip, right-click the WEB-INF directory that contains your edited web.xml file, and select "Add to Zip File...". Adding the file in this way ensures that it is placed in the correct directory inside the archive.

7. Restart your application server and redeploy webcompadapter.war (for BEA WebLogic), or restart the application (for IBM WebSphere). The WCA should now use the new values from web.xml.