B.2 Setting up J2EE servers

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

J2EE servers are already setup during the installation of the product. During the default settings, the J2EE server name is the host name. If you want to change the server name to another name, set up the J2EE server. When multiple J2EE servers are to be started on the same host, you must allocate a separate name to each J2EE server, and therefore, you must set up the J2EE servers.

The procedure for setting up a J2EE server is as follows. For details on the precautions to be taken when setting up a J2EE server, see B.2 (3) Precautions to be taken during setup, and take action, if necessary. For details on the precautions to be taken when allocating server names during the startup of multiple J2EE servers on the same host, see B.2 (4) Precautions to be taken when starting multiple J2EE servers.

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 J2EE servers

(1) In Windows

To set up a J2EE server in Windows:

Move the current directory using the following command:

cd Cosminexus-installation-directory\CC\server\bin
Set up the J2EE server using the cjsetup command.

cjsetup server-name

An example of setting up a J2EE 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\binC:\Program Files\Hitachi\Cosminexus\CC\server\bin>cjsetup MyServer
```

To Page Top

(2) In UNIX

To set up a J2EE server in UNIX:

Set up the J2EE 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 server-name

An example of setting up a J2EE server is as follows. In this example, the server name is MyServer.
```
/opt/Cosminexus/CC/server/bin/cjsetup MyServer
```

To Page Top

(3) Precautions to be taken during setup

Set up the J2EE server only once. If you specify the settings for setting up an already set up J2EE server, an error message will be output.
If you do not customize the J2EE server after setup, a CORBA Naming Service with the host name localhost and port number 900 will be invoked automatically and used in the J2EE 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. Change the startup mode of the CORBA Naming Service with the ejbserver.naming.startupMode key of usrconf.properties.
Before starting the J2EE server, make sure that the value of the environment variable OSAGENT_PORT and the value of the vbroker.agent.port key of usrconf.properties are 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 2.2 Commands used for operating J2EE 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 details on estimating the path length of the work directory, see Appendix C.1 Work directory of the J2EE server in the uCosminexus Application Server System Setup and Operation Guide.

To Page Top

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

A J2EE 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 J2EE servers are started on the same host, a serve name is allocated to each J2EE server, and the J2EE servers are set up.

When allocating a server name to a J2EE server, you must consider the following two conditions:

You cannot set up more than one J2EE server with the same server name on the same host. If you use the same server name to set up another J2EE server, an error will occur.
If you are using the same CORBA Naming Service, you cannot set up more than one J2EE server with the same server name even in different hosts.

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 J2EE server, and also regarding the setup of the Smart Agent to be used in the CORBA Naming Service are as follows:

Setting up the host name and port number

When starting multiple J2EE 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 different values for the port numbers set up in the webserver.connector.nio_http.port key and ejbserver.http.port key of usrconf.properties for J2EE servers that are started simultaneously.

Setting up the Smart Agent

When you want to use a Smart Agent in the CORBA Naming Service to which the J2EE server is connected, use a unique J2EE server name within the same Smart Agent (when the connection is established using the same port number). If you do not use a unique J2EE server name, the message KDJE37302-E will be output by the server management command, and the server management command might not run.

Note that the Smart Agent can be used in the CORBA Naming Service in the following cases:

When the CORBA Naming Service is invoked manually as an out-process: When you invoke the CORBA Naming Service by specifying manual in the ejbserver.naming.startupMode key, specify vbroker.agent.enableLocator=true (the default value is true) in the argument during the invocation of the CORBA Naming Service.
When the CORBA Naming Service is invoked automatically as an out-process or in-process: When you invoke the CORBA Naming Service by specifying automatic or inprocess in the ejbserver.naming.startupMode key, specify vbroker.agent.enableLocator=true (the default value is false) in usrconf.properties to enable the usage of the Smart Agent.

To Page Top