sockssetup.sh

The sockssetup.sh script is installed to the crystal directory of your installation. The script provides a text-based program that enables you to configure the Web Component Adapter (WCA) and the Crystal Management Server (CMS) when they must communicate across one or more SOCKS proxy server firewalls. For technical information about Crystal Enterprise and firewalls, see Firewalls overview.

This script does not configure the Web Connector to communicate with the WCS through a SOCKS server. If a SOCKS server separates your web server from the WCS, you must manually configure the Web Connector configuration file that corresponds to your web server. For more information, see Configuring the Web Connector for SOCKS servers.

To modify SOCKS configuration

1. Go to the crystal directory of your installation.
2. Issue the following command:

   ./sockssetup.sh

3. Type wca to configure the communication between the WCA and the CMS. Or, type servers to configure SOCKS information between the remaining servers.

   The script may prompt you for the name or "friendly name" of the server. By default, each server's name is hostname.servertype. To check the name of a server, view the contents of ccm.config and look for the server's launch string. The server's current name appears after the -name option.

   The "friendly name" of the WCA by default is hostname.wca. To check the name of the WCA, look for the <display-name> of the WCA as listed in the web.xml file in the WEB-INF directory of the webcompadapter.war archive. (This archive is found in the crystal_root/enterprise/JavaSDK/applications directory, where crystal_root is the root directory of your Crystal Enterprise installation.)

4. Specify one of the available actions:
   • Type show to display any SOCKS servers that have already been entered with this script. A blank list is displayed if no servers have been added.
   • Type create to add a new SOCKS server to the list.
   • Type modify to change one of the SOCKS servers in the list.
   • Type delete to remove a SOCKS server from the list.
   • Type moveup or movedown to modify the sequence of SOCKS servers.
5. Proceed through the script and provide any additional information that it requests:
   • If you are creating a new entry in the list, you will typically need to provide the name or IP address of the SOCKS server, the port number it is listening on, the version number of the SOCKS server (4 or 5), and any authentication information that the Crystal Enterprise servers will require in order to establish a connection with your SOCKS server.
   • If you choose to delete, modify, or move an existing entry, you will be asked to specify the server "by index." Type the number that corresponds to the SOCKS server you want to modify.

     For details about SOCKS and the importance of the sequence of servers, see Configuring for SOCKS servers.