Installing the Web Connector on a separate machine

To install the Web Connector on a separate UNIX machine that is running your web server, run the webconn_install.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.

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 webconn_install.sh script and the licensetext file included with your product distribution to the web server machine.

   Note:    If you transfer the script by FTP from a Windows machine to the UNIX machine, be sure to specify Binary mode for the transfer. (The webconn_install.sh script includes all of the binaries required by the Web Connector.)

2. Go to the directory where you copied the files and run the installation script:

   ./webconn_install.sh

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

3. 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 installation script copies the required 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).

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

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

8. Press Enter to continue.

   The script prompts you for a list of WCS hosts.

9. Press Enter to accept the default (the single WCS that you are installing).

   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 UNIX Web Connectors.