Configuring virtual path mappings on Windows

If Crystal Enterprise is running on Windows, you can use the Crystal Configuration Manager (CCM) to configure the virtual path mappings for the Web Connector.

To create a virtual path

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\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. If you want to make unmanaged Crystal reports available on your web site, repeat steps 4 to 8 for .rpt files.
10. 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.