Hitachi

uCosminexus Application Server Command Reference Guide


H.1 System environment variables common to OSs

The following table lists the system environment variables to be specified in common to the OSs. The setting of system environment variables differs depending on whether the system uses the scheduling functionality by CTM.

Table H‒1: Setting values and settings of system environment variables (Common to OSs)

System environment variable name

Explanation

Setting value

Settings of the environment variable

When not using CTM

When using CTM

LIBPATH, LD_LIBRARY_PATH#1 #2

Specifies the path.

/opt/Cosminexus/TPB/lib

Y

Y

/opt/Cosminexus/PRF/lib

Y

Y

/opt/Cosminexus/CTM/lib

--

Y

/opt/hitachi/common/lib

Y

Y

PATH

Specifies the path.

  • In Windows

    Application-Server-installation-directory\jdk\bin#3

  • In UNIX

    /opt/Cosminexus/jdk/bin#3

Y

Y

  • In Windows

    Application-Server-installation-directory\TPB\bin

  • In UNIX

    /opt/Cosminexus/TPB/bin

Y

Y

  • In Windows

    Application-Server-installation-directory\PRF\bin#4

  • In UNIX

    /opt/Cosminexus/PRF/bin#4

Y

Y

  • In Windows

    Application-Server-installation -directory\CTM\bin#4

  • In UNIX

    /opt/Cosminexus/CTM/bin#4

--

Y

ProgramFiles\Common Files\Hitachi#5

N

N

/bin#1

Y

Y

/usr/bin#1

Y

Y

TPDIR

Specifies the installation directory of TPBroker.

  • In Windows

    Application-Server-installation-directory\TPB

  • In UNIX

    /opt/Cosminexus/TPB

Y

Y

VBROKER_ADM

Specifies a management directory of the log output destination.

  • In Windows

    Application-Server-installation-directory\TPB\adm#6

  • In UNIX

    /opt/Cosminexus/TPB/adm#6

Y

Y

PRFSPOOL

Specifies the execution environment directory of the performance tracer. An installer creates a default directory. To change the default directory, create the execution environment directory of the performance tracer and specify the directory in this environment variable. Specify such that the total length of the setting value of PRFSPOOL and the PRF identifier (maximum length is 32 bytes) is less than 201 bytes. If the environment variable is not specified, the performance tracer fails to operate.

In Windows, when changing the directory to other than the default directory, set the access permission for the specified directory and all the directories included in the path of the specified directory, to full control, and specify Everyone as the users to whom the full control is to be assigned.

In UNIX, set access permission (777) to all the execution environment directories and all the directories included in the path to the execution environment directory.

  • In Windows

    Application-Server-installation-directory\PRF\spool

  • In UNIX

    /opt/Cosminexus/PRF/spool

N#7

N#7

OSAGENT_PORT

Specify a port number used by Smart Agent (osagent) in the range of 5,001 through 65,535.

14000#6

--

R

CTMDIR

Specify the CTM installation directory.

  • In Windows

    Application-Server-installation-directory\CTM

  • In UNIX

    /opt/Cosminexus/CTM

--

Y

CTMSPOOL

Specify the execution environment directory of CTM. An installer creates a default directory. To change the default directory, create the execution environment directory of CTM and specify the created directory in this environment variable. Use a case sensitive path name.

  • In Windows

    %CTMDIR%\spool

  • In UNIX

    /opt/Cosminexus/CTM/spool

--

R

TZ

Specify a time zone.

JST-9#6

Y

Y

Legend:

Y: Specification is required.

N: As it is set by the installer, the setting is not required.

R: The setting according to system environments is required.

--: The setting is not required.

When not using CTM: Indicates a system that does not use the scheduling functionality provided by CTM.

When using CTM: Indicates a system that uses the scheduling functionality provided by CTM.

#1: An environment variable to be specified in UNIX. Do not specify this variable in Windows.

#2: The environment variables that you specify differ depending on the OSs.

#3: In the following case, specify at the beginning of the environment variable PATH.

#4: When starting the CTM domain manager or CTM, do not concurrently specify a path of the performance tracer (Application-Server-installation-directory\PRF\bin). If you concurrently specify a path of the performance tracer, an error occurs when CTM loads libraries of the performance tracer and the performance tracer fails to start.

#5: An environment variable to be specified in Windows. Do not specify this variable in UNIX. An installer specifies ProgramFiles\Common Files\Hitachi by default in the system environment variable. ProgramFiles is a directory that is normally specified in the system environment variable %ProgramFiles%.

#6: Specify this value generally. However, you can also specify other values.

#7: In Windows, an installer specifies the same. An installer does not specify this in UNIX.

Important note

CLASSPATH is disabled. Specify class paths for the add.class.path key in the option definition file for J2EE servers.