22 Configuring the Site Capture Application Server

Site Capture can run as a single application or in a clustered installation.

This chapter contains the following topics:

• Section 22.1, "Configuration Options"

• Section 22.2, "Configuring Tomcat Application Server"

• Section 22.3, "Configuring WebLogic Application Server"

• Section 22.4, "Configuring WebSphere Application Server"

22.1 Configuration Options

In this chapter, you will configure an application server to support Site Capture running as a single instance or in cluster mode.

Note :

Before proceeding with the configuration steps, note that the Site Capture application must run on context root / to support previewing of archives. (Site Capture serves pages from within archives, which can have any context root.)

Complete one of the following procedures:

• Section 22.2, "Configuring Tomcat Application Server"

• Section 22.3, "Configuring WebLogic Application Server"

• Section 22.4, "Configuring WebSphere Application Server"

22.2 Configuring Tomcat Application Server

If you are creating a clustered installation, complete the following steps on all cluster members.

To configure Tomcat

1. Open server.xml in <apache-tomcat-6.0.29 directory>\conf and do the following:

   1. Replace port 8080 with the Site Capture port (on which the application server is listening):

      Note:

      For clustered installations, specify a unique port number for each cluster member.

      <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />

   2. Configure the data source for Site Capture.

      Note:

      For clustered installations, configure the same data source on each cluster member.

      Refer to Table 22-1 for information about configuring the driver class name and URL for your selected driver.

      Below is a sample DB2 configuration:

      <Context path="" docBase="ROOT" debug="5" reloadable="true" crossContext="true">
         <Resource name="scDataSource" 
             auth="Container" 
             type="javax.sql.DataSource" 
             url="jdbc:db2://<hostname>:<port>/CLUSTDB" 
             driverClassName="com.ibm.db2.jcc.DB2Driver" 
             username="xxxxx" 
             password="xxxxxxx" 
             maxActive="20" 
             maxIdle="10" 
             maxWait="-1" />
      </Context>
      

   Table 22-1 Database Driver Parameters

   Database Driver	Parameter	Value
   SQL Server	DriverClass	net.sourceforge.jtds.jdbcx. JtdsDataSource
   SQL Server	Required .jar files	jtds-1.2.jar
   SQL Server	URL	jdbc:jtds:sqlserver://<server>:<dbport>/<dbname> For example: jdbc:jtds:sqlserver://192.0.2.1:1433/SC70
   DB2	DriverClass	com.ibm.db2.jcc.DB2Driver
   DB2	Required .jar files	db2jcc.jar, db2cc_license_cu.jar
   DB2	URL	jdbc:db2://<hostname>:<dbport>/<dbname> For example: jdbc:db2://192.0.2.1:5000/ SC70
   Oracle	DriverClass	oracle.jdbc.driver.OracleDriver
   Oracle	Required .jar files	Ojdbc6.jar
   Oracle	URL	jdbc:oracle:thin:@//<hostname>:1521/<dbname> For example: jdbc:oracle:thin:@//godzilla.fatwire.com:1521/SC70

   
   

2. Copy the required database driver jar file to <apache-tomcat-6.0.29 directory>\lib.

3. Once you have completed configuring the application server(s), continue to Chapter 23, "Procedures for Installing Site Capture."

22.3 Configuring WebLogic Application Server

If you are creating a clustered installation, complete the following steps on all cluster members.

To configure WebLogic

1. Create a domain in WebLogic and configure the administrator user name and password for the domain.

2. Start the WebLogic Admin Server from the command prompt:

   • Windows: startweblogic.cmd

   • UNIX: ./startweblogic.sh

3. Log in to the console.

   1. Create a managed server <managed_server_name> in the domain you just created.

      Note:

      For clustered installations, specify a unique port number for each cluster member.

   2. Create a data source and map it to the managed server <managed_ server_name>.

      Note:

      For clustered installations, configure the same data source on each cluster member.

4. Once you have completed configuring the application server(s), continue to Chapter 23, "Procedures for Installing Site Capture."

22.4 Configuring WebSphere Application Server

If you are creating a clustered installation, complete the following steps on all cluster members.

To configure WebSphere

1. Create a WebSphere application server instance.

   Note:

   For clustered installations, specify a unique port number for each cluster member.

2. Create a data source for the newly created server instance.

   Note:

   For clustered installations, configure the same data source on each cluster member.

   1. Copy the required database driver into <websphere_install_dir>/websphere/AppServer/universalDriver/lib. (refer to Table 22-1 for the required driver).

   2. Log in to the WebSphere console and do the following:

      Add the user name and password of the database by creating an alias (go to Security, select Global security, then Java Authentication and Authorization Service, and then select J2C authentication data).

      Create a JDBC provider and data source (go to Resources, and then select JDBC).

3. Once you have completed configuring the application server(s), continue to Chapter 23, "Procedures for Installing Site Capture."