cjsetup (set up or delete J2EE server environment)

Format

For setup

cjsetup -batch [server-name]

For unsetup

cjsetup -d server-name

To Page Top

Function

This command sets up the environment of batch servers with specified names.

The default user definitions are created for batch servers set up in the following directory:

• In Windows

  Cosminexus-installation-directory\CC\server\usrconf\ejb\server-name\

• In UNIX

  /opt/Cosminexus/CC/server/usrconf/ejb/server-name/

When the -d option is specified, the batch server environment (directories and files) shown below is deleted:

• In the storage directory for user-definition files

  • In Windows

    Cosminexus-installation-directory\CC\server\usrconf\ejb\server-name\

  • In UNIX

    /opt/Cosminexus/CC/server/usrconf/ejb/server-name/

• In a temporary work directory

  • In Windows

    Cosminexus-installation-directory\CC\server\repository\server-name\

  • In UNIX

    /opt/Cosminexus/CC/server/repository/server-name/

• In the work directory (default)

  • In Windows

    Cosminexus-installation-directory\CC\server\public\ejb\server-name\

  • In UNIX

    /opt/Cosminexus/CC/server/public/ejb/server-name/

Note that if you specify values other than the default values in the ejb.public.directory key of the user definition file (usrconf.cfg), this setting will delete all the folders and files under that work directory.

To Page Top

Arguments

server-name

Specifies server names of the batch servers to be set up. If the server name is omitted, the host name is used as the server name. However, the server name cannot be omitted for the unsetup processing. Furthermore, if the host name contains characters that cannot be used in server names, an error will occur.

You can use single-byte alphanumeric characters (0-9, A-Z, and a-z), the underscore (_), and the hyphen (-) in the server name. The first character must be an alphanumeric character. Specify the server name with maximum of 255 characters and the length calculated by referring to Appendix C.2 Work directory of the batch server in the uCosminexus Application Server System Setup and Operation Guide.

-batch

Specified when setting up the environment of batch servers.

-d

Specifies that the environment of the batch server is to be deleted. You cannot omit server names.

To Page Top

Return values

0:

The command terminated normally.

1:

The command terminated abnormally.

To Page Top

Notes

• To execute the cjsetup command on UNIX, you must have root permission (if a Component Container Administrator has not been set) or the Component Container Administrator permission (if a Component Container Administrator has been set).

• When you execute unsetup (cjsetup -d server-name) in UNIX, all directories and files for deletion will be deleted regardless of their access permission settings and usage status.

• If the name of a server that has already been set up is specified and re-setup (cjsetup -batch server-name) is executed, an error occurs.

• In Windows, server names are not case sensitive. For the server name of cjsetup, if you specify a character string that matches with the name of an already created server except for the capitalization, the command runs as follows:

  • For setup (cjsetup -batch server-name)

    Setup fails.

  • For unsetup (cjsetup -d server-name)

    The command deletes the server that has already been created and matches server-name except for the differences in case.

• When you specify the server name as an argument in a server management command or the start or stop command for the batch server and you execute the command, you must specify a case-sensitive character string that matches the name of the server that was created with the cjsetup command.

• Do not execute unsetup (cjsetup -d server-name) for running batch servers.

• In Windows, do not use the -d option to delete a target file that has the read-only attribute or is being used.

• A batch server can be built only in V9 compatibility mode.

To Page Top