Appendix F.2 Setting up batch servers

This subsection describes the setup of batch servers configuring an Application Server system.

During the default settings, the batch server name is the host name. When multiple batch servers are to be started on the same host, allocate a separate name to each batch server. For details on the precautions to be taken when allocating a server name, see F.2 (4) Precautions to be taken when starting multiple batch servers.

The procedure for setting up batch servers is as follows. For details on the precautions to be taken when setting up batch servers, see F.2 (3) Precautions to be taken during setup, and take action, if necessary.

Organization of this subsection
(1) In Windows
(2) In UNIX
(3) Precautions to be taken during setup
(4) Precautions to be taken when starting multiple batch servers

(1) In Windows

To set up a batch server in Windows:

  1. Move the current directory using the following command:
    cd Cosminexus-installation-directory\CC\server\bin
  2. Set up the batch server using the cjsetup command.
    cjsetup -batch server-name
    An example of setting up a batch server is as follows. In this example, the Cosminexus installation directory is C:\Program Files\Hitachi\Cosminexus, and the server name is MyServer.

    C:\>cd C:\Program Files\Hitachi\Cosminexus\CC\server\bin
    C:\Program Files\Hitachi\Cosminexus\CC\server\bin>cjsetup -batch MyServer

(2) In UNIX

To set up a batch server in UNIX:

  1. Set up the batch server using the cjsetup command. You must have the root permission (when the Component Container Administrator is not set up), or the permission of the Component Container Administrator (when the Component Container Administrator is set up), to execute the command.
    /opt/Cosminexus/CC/server/bin/cjsetup -batch server-name
    An example of setting up a batch server is as follows. In this example, the server name is MyServer.

    /opt/Cosminexus/CC/server/bin/cjsetup -batch MyServer

(3) Precautions to be taken during setup

(4) Precautions to be taken when starting multiple batch servers

A batch server is identified by the server name. During installation, the host name of the already installed host is set up as the default server name. Therefore, when multiple batch servers are started on the same host, a serve name is allocated to each batch server, and the batch servers are set up.

When allocating a server name to a batch server, you cannot set up more than one batch server with the same server name on the same host. If you use the same server name to set up another batch server, an error will occur.

The precautions to be taken regarding the setup of the host name and port number of the CORBA Naming Service to be connected to the batch server are as follows:

Setting up the host name and port number
When starting multiple batch servers simultaneously on the same host, make sure that no two host names or port numbers used to connect to the CORBA Naming Service are same. Set up the host name and port number in usrconf.properties.
Furthermore, specify the different values for the port numbers set up in the webserver.connector.ajp13.port key and ejbserver.http.port key of usrconf.properties for batch servers that are started simultaneously.