DistributorServer

A DistributorServer runs as a Nucleus component on each HTTP server machine. When a DistributorServer receives a connection from a DistributorSender, the DistributorServer creates a DistributorReader. The DistributorReader handles the processing of the put or fileCheck command from the DistributorSender.

Installing the DistributorServer

To install a DistributorServer on Windows:

  1. Make sure the HTTP server machine has a Java Virtual Machine installed.

  2. Download the ATG Web Server Extensions distribution file, ATGWebServerExtensions2007.3.exe, from www.oracle.com.

  3. Run the ATG Web Server Extensions file.

  4. The installer displays the Welcome dialog box. Click the Next button to continue.

  5. The installer displays the software license agreement and asks if you accept the terms. Click the Yes button to continue.

  6. Select the installation directory, and then click the Next button to continue. The default directory is C:\ATG\ATGWeb2007.3.

  7. The installer displays the list of Web server extensions you can configure during the installation process. Make sure the DistributorServer is selected, and click the Next button to continue. (If you want to install the Publishing Web Agent as well, see the ATG Content Administration Programming Guide.)

  8. Specify the port that the DistributorServer should use to listen for connections from DistributorSender components, and click the Next button to continue. The default is 8810.

  9. Specify the directory that the DistributorServer should use to cache files, and click the Next button to continue. The directory can be the HTTP server’s document root, or any subdirectory within it. The default is the home\doc subdirectory of the installation directory you previously specified.

  10. Enter a name for the Program Folder, and click the Next button to continue. The default is <ATG2007.3dir>\ATGWebServerExtensions.

  11. The installer displays the settings you selected. If you need to make any changes, click the Back button. Otherwise, click Next to proceed with the installation.

To install a DistributorServer on Unix:

  1. Make sure the HTTP server machine has a Java Virtual Machine installed.

  2. Download the ATG Web Server Extensions distribution file, ATGWebServerExtensions2007.3.jar, from www.oracle.com.

  3. Unpack the ATGWebServerExtensions2007.3.jar file:

    jar xvf ATGWebServerExtensions2007.3.jar

    The installer creates an ATGWeb2007.3 subdirectory in the current directory. This subdirectory includes the files and directories needed to install the Web server extensions.

  4. Change to the ATGWeb2007.3/home directory and enter the following command (or its equivalent) to set read and write permissions for the Install script:

    chmod 755 bin/Install

  5. Run the Install script:

    bin/Install

  6. The installer displays the list of Web server extensions to install. Type A to install the DistributorServer. (If you want to install the Publishing Web Agent as well, see the ATG Content Administration Programming Guide.)

  7. Specify the port that the DistributorServer should use to listen for connections from DistributorSender components. The default is 8810.

  8. Specify the directory that the DistributorServer should use to cache files. The directory can be the HTTP server’s document root, or any subdirectory within it. The default is the home/doc subdirectory of the installation directory.

Configuring the DistributorServer

The DistributorServer component is an instance of atg.server.distributor.DistributorServer. You can configure it by editing the DistributorServer.properties file in the home\localconfig\atg\dynamo\server subdirectory of the ATG Web Extensions installation directory. The DistributorServer has the following properties:

Property Name

Description

enabled

If true, the DistributorServer service is enabled. Default is true.

port

The port on which the DistributorServer should listen for connections from DistributorSender components. Default is 8810.

cacheDirectory

Directory on the HTTP server in which the DistributorServer stores files. Default is the home\doc subdirectory of the ATG Web Extensions installation directory.

allowedSenders

A comma-separated list of <host>:<port> entries. If this property is set, the DistributorServer accepts connections only from these hosts. By default the property is not set, which means the DistributorServer will accept connections from any host running a DistributorSender.

Starting the DistributorServer

To start up Nucleus and run the DistributorServer component, use the following command:

startNucleus -m Distributor

If you also have a configured ATG Publishing Web Agent on the Web server, you can start up the Distributor and PublishingWebAgent modules at the same time. In this case, use the following command:

startNucleus –m PublishingWebAgent:Distributor

For information about the ATG Publishing Web Agent, see the ATG Content Administration Programming Guide.

 
loading table of contents...