Installing a Web Connector on a UNIX web server

The default installation of Crystal Enterprise on Windows requires that you install a Web Connector on your web server to enable communications between the web server and the Web Component Server. You can install this web connector on either a Windows or a UNIX web server.

To install the Web Connector on a UNIX web server, run the install_webcon.sh script on that machine. This script installs the Web Connector, various configuration files, and all the Crystal Enterprise web content that is required by your web server.

Note:    You do not need a Web Connector for a Crystal Enterprise installation (on UNIX or Windows) that uses the Crystal Enterprise Java SDK. The Java version of Crystal Enterprise uses a 3rd party Java application server, and does not install a Web Component Server.

On the web server machine, ensure that you have completed the preparatory steps described in the following sections:

• Meeting the host name and network requirements
• Checking for required commands and utilities

To install the Web Connector

1. Copy the install_webcon.sh script, the licensetext file included with your product distribution, and the files containing the Crystal Enterprise binaries (with the extension .gz) to your HOME directory.

   Note:    If you transfer the files by FTP to the UNIX machine, be sure to specify binary mode for the transfer.

2. When prompted, press Enter to continue.

   The script displays the product license agreement. Press the spacebar to read through the information in its entirety.

3. Press Enter, and then type yes and press Enter to accept the license agreement and to proceed with the installation.

   The script prompts you for the absolute path of the installation directory.

4. Type the path to the directory where you want to install the Web Connector and the web content files that are required by your web server.

   The script will create a crystal directory below the directory that you specify here. The Crystal Enterprise subdirectories and files are installed below this crystal directory.

5. Press Enter.

   The script notifies you that it has collected all of the required information, and asks you if you are ready to have the installation begin.

6. Type begin and press Enter.

   The installation script unpacks the archived installation files. This may take a few minutes. When finished, the script runs the webconsetup.sh script automatically, and prompts you for the port that the Web Connector should use to communicate with the Web Component Server (WCS).

7. Press Enter to accept the default port, which is 6401.

   The script asks if you want to connect to a web server on the local machine.

8. Type yes and press Enter.

   The script displays additional information. In particular, it shows the absolute path of the directory where it has saved the templates for your Web Connector configuration files. Note this directory, which should be $HOME/crystal/ enterprise/PLATFORM_PATH/wcs/conf/.

9. Press Enter to continue.

   The script prompts you for a list of WCS hosts.

10. Press Enter to accept the default.

    You must now configure your web server so it gives Crystal Enterprise requests to the Web Connector. For information on configuring the appropriate Web Connector for your web server, proceed now to Configuring Web Connectors.