Installing a domainlinker script 

---

Overview

CentreVu Internet Solutions provides the following scripts that you can use to link your ICM server and Web server(s). All scripts are located in the installation directory on the ICM server.

• domainlinker.class and domainlinker$myX509TrustManager.class �Java Servlets

• domainlinker.pl�Perl script (does not support SSL)

We recommend that you use the Java Servlet version. If your Web site cannot run Java Servlets, then try the Perl script.

Implementing the Java servlet domainlinker script for PC installations

To implement the Java servlet script for PC installations, do the following for each Web server:

1. Locate the domainlinker scripts (domainlinker.class and domainlinker$myX509TrustManager.class) on the ICM installation directory and install them on your Web server. You can install the scripts at any location on the Web server that you choose.

2. Create an IIS virtual directory to access the location of the domainlinker scripts.

3. Find and open the web.xml file according to your servlet engine:

   • If you are using Tomcat, open the web.xml file from the directory where Tomcat is installed (for example, jakarta-tomcat\Webapps\root\Web-inf ).

   • If you are using JRun, open the web.xml file from the directory where JRun is installed (for example, C:\Program Files\Allaire\JRun\servers\defaultapp\Web-inf)

4. Edit the web.xml to include the following values:

   • domainlinker

   • ICM_isSSL

   • true (ONLY if SSL is used; otherwise set this parameter to false)

   • domainlinker

5. Save and close the web.xml file.

6. Stop and then restart the servlet engine service.

7. Test the domainlinker script by entering the following URL in your browser: http://{web_server_domain_name}/servlet/domainlinker

   Result:
   

   A Web page indicating success appears.

8. Inform the ICM of the new script using one of the following methods:

   • If you are linking to only one Web server domain, you can set the domainlinker parameter to the domainlinker URL through the default/systemParms.txt file: domainlinker=http://{web_server_domain_name}/servlet/domainlinker

   • If you are linking to more than one Web server domain, you must set your domainlinker parameter in the Caller Web page for each Web server domain. See the Web Page Guidelines documentation on the CVuIS ICC Software CD-ROM for more information about Caller Web pages.

Implementing the Java servlet domainlinker script for Solaris installations

To implement the Java servlet script for Solaris installations, do the following for each Web server:

1. Locate the domainlinker scripts (domainlinker.class and domainlinker$myX509TrustManager.class) on the ICM installation directory and install them on your Web server. You can install the scripts at any location on the Web server that you choose.

2. Move the icm.properties on the ICM server to the directory on your Web server that defines servlets (for example, /usr/local/apache1.3.12/conf).

3. Open the icm.properties file in a text editor, and do the following:

   1. Uncomment the domainlinker configuration information.

   2. Ensure that the servlets.startup=domainlinker line is present.

   3. Save and close the file.

4. Open the jserv.properties file in a text editor, and do the following:

   1. Add the following lines:

      • zones=icm

      • icm.properties={servlet path}/icm.properties

   2. In the Execution Parameters section, add the following lines:

      • wrapper.classpath=/export/home/itg.ss/icm/vdir

      • wrapper.classpath=/export/home/itg.ss/icm/vdir/jnet.jar

      • wrapper.classpath=/export/home/itg.ss/icm/vdir/jsse.jar

      • wrapper.classpath=/export/home/itg.ss/icm/vdir/jcert.jar

   3. Save and close the file.

5. Open the httpd.conf file (located in the servlet directory, for example /usr/local/apache1.3.12/conf) in a text editor and do the following:

   1. Add an alias to point to the location of domainlinker (for example, Alias /icm/ "/export/home/itg.ss/icm/vdir"

   2. Save and then close the file.

6. Stop and then restart Apache by doing the following:

   1. Log in as root.

   2. Enter {Apache directory}/bin/apachectl stop to stop Apache.

   3. Enter {Apache directory}/bin/apachectl start to restart Apache.

7. Test the domainlinker script by entering the following URL in your browser: http://{web_server_domain_name}/servlet/domainlinker

   Result:
   

   A Web page indicating success appears.

8. Inform the ICM of the new script using one of the following methods:

   • If you are linking to only one Web server domain, you can set the domainlinker parameter to the domainlinker URL through the default/systemParms.txt file: domainlinker=http://{web_server_domain_name}/servlet/domainlinker

   • If you are linking to more than one Web server domain, you must set your domainlinker parameter in the Caller Web page for each Web server domain. See the Web Page Guidelines documentation on the CVuIS ICC Software CD-ROM for more information about Caller Web pages.

Implementing the Perl domainlinker script on PC and Solaris installations

To implement the Perl domainlinker script�which does not support SSL�do the following:

1. Locate the domainlinker.pl script in the ICM installation directory and install it in one of the following directories:

   • PC: the IIS scripts directory

   • Solaris: the cgi-bin directory of Apache

2. Edit the first line of domainlinker.pl to point to where Perl is installed on your system.

3. Test the domainlinker script by entering one of the following URLs in your browser:

   • PC: http://{web_server_domain_name}/domainlinker.pl

   • Solaris: http://{web_server_domain_name}/cgi-bin/domainlinker.pl

   Result:
   

   A Web page indicating success appears.

4. Inform the ICM of the new script using one of the following methods:

   • If you are linking to only one Web server domain, you can set the domainlinker parameter to the domainlinker URL through the default/systemParms.txt file:

     • PC: domainlinker=http://{web_server_domain_name}/domainlinker.pl

     • Solaris: domainlinker=http://{web_server_domain_name}/cgi-bin/domainlinker.pl

   • If you are linking to more than one Web server domain, you must set your domainlinker parameter in the Caller Web page for each Web server domain. See the Web Page Guidelines documentation on the CVuIS ICC Software CD-ROM for more information about Caller Web pages.