Configuring the Web Connector for a remote WCS

If you installed the Web Connector and the Web Component Server (WCS) on different machines, follow these steps to provide the Web Connector with the information it requires in order to communicate with the remote WCS.

To configure the Web Connector for a remote WCS on Windows

1. From the Crystal Enterprise program group, click Crystal Configuration Manager.
2. In the CCM, click Configure web connector.

   The Web Connector Configuration dialog box appears.

   

3. In the Web Component Servers area, ensure that the WCS Host Name and Port number correspond to your system configuration.

   In the example above, the WCS is running on a machine named PBROWNSEYA, and it is listening on the default port (6401).

4. In the Path Mapping area, click Add.

   The Path Mapping dialog box appears.

   

5. In the Virtual Path field, type /crystal

   This entry must match the name of your web server's virtual directory that is mapped to the Crystal Enterprise web content directory on the web server. By default, this virtual directory is named /crystal.

6. In the Extension field, type .csp

   This entry flags .csp files as exceptions, so the web server does not attempt to send the file directly to the user's browser.

7. In the Actual Path field, type the absolute path of the Crystal Enterprise web content directory on the Web Component Server.

   This entry must specify the physical drive path on the Web Component Server, because this denotes the directory where the WCS will look for any .csp files that it must process.

   On Windows, the default web content directory path is:

   "C:\Program Files\Crystal Decisions\Enterprise 10\Web Content"

   Note:    If the Actual Path contains spaces, enclose the string in double-quotes.

8. Click OK.

   Now, before it forwards .csp requests to the WCS, the Web Connector translates the path to the .csp file so that the WCS can locate the corresponding .csp file on its local drive.

9. In the Virtual Path field, type /crystalreportviewers10

   This entry must match the name of your web server's virtual directory that is mapped to the Crystal Enterprise viewers directory on the web server. By default, this virtual directory is named /crystalreportviewers10.

10. In the Extension field, type .csp

    This entry flags .csp files as exceptions, so the web server does not attempt to send the file directly to the user's browser.

11. In the Actual Path field, type the absolute path of the viewers directory on the Web Component Server.

    On Windows, the default viewer directory path is:

"C:\Program Files\Common Files\Crystal Decisions\2.5\crystalreportviewers10"

Note:    If the Actual Path contains spaces, enclose the string in double-quotes.

12. Click OK.
13. Click OK and restart your web server and all associated services.

Note:    

• The CCM does not allow you to specify multiple actual paths for one virtual directory. Consequently, when you are running more than one WCS machine, the actual path to your .csp files (and any other Crystal Enterprise file types) must be identical on each WCS machine.
• If you require additional information about the mappings that must be set up between the WCS and the Web Connector, see the "Troubleshooting Path Mapping" section of the Crystal Enterprise Administrator's Guide.