Appendix F.2 Setting up batch servers
(1) In Windows
To set up a batch server in Windows:
- Move the current directory using the following command:
cd Cosminexus-installation-directory\CC\server\bin
- 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:
- 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
- Set up the batch server only once. If you specify the settings for setting up an already setup batch server, an error message will be output.
- If you do not customize the batch server after setup, a CORBA Naming Service with the host name localhost and port number 900 will be invoked automatically and used in the batch server as an in-process. Change the CORBA Naming Service to be used with the ejbserver.naming.host key and ejbserver.naming.port key of usrconf.properties.
- Before starting the batch server, make sure that the value of the environment variable OSAGENT_PORT and the value of the vbroker.agent.port key of usrconf.properties is matching.
- For details on the characters that can be used in the server name, see the explanation about the cjsetup command. For details on the cjsetup command, see 3.2 Commands used for operating batch servers.
- The server name is used as a directory name within the work directory. Specify the server name in consideration of the fact that the path length below the work directory does not reach the upper limit of the platform. For estimating the path length of the work directory, see Appendix C.2 Work directory of a Batch server in the uCosminexus Application Server Setup and Operation Guide.
(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.