Hitachi

JP1 Version 12 JP1/IT Desktop Management 2 - Agent (For UNIX Systems)


5.6.2 Syntax of the environment settings file

Organization of this subsection

(1) Format

[NETMDMGF_HOKAN=directory-for-installation-scheduled-packages]
[LOGFileDirectory=log-file-directory]
[LOGFileRecordMax=number-of-records]
[SystemLogOutputLevel={0|1|2|3}]
[EvntlogLevel={0|1|2}]
[CommandWait=timeout]
[GF_WatchTimer={ON|OFF}]
[ERR_CONTINUE={ON|OFF}]
[NETMDMGF_UAPGEN=UAP-installation-work-directory]
[NETMDMGF_UPTGEN=UAP-installation-work-directory]

(2) Details

NETMDMGF_HOKAN directory-for-installation-scheduled-packages ~ <1 to 64 alphanumeric characters> <</NETMDMGF/HOKAN>>

This attribute specifies the name of the directory for temporarily storing the installation-scheduled packages that are not installed yet. If a directory that does not exist is specified, distribution that uses generator tools cannot be performed.

LOGFileDirectory log-file-directory ~ <1 to 64 alphanumeric characters> <</NETMDMGF>>

This attribute specifies the name of the directory for storing log files. If a directory that does not exist is specified, logs cannot be output to files.

LOGFileRecordMax number-of-records ~ <numerics>((1 to 9999)) <<100>>

This attribute specifies the maximum number of records that the log file can contain. This attribute is effective only when you initialize the log file.

SystemLogOutputLevel ~ <numerics> {0|1|2|3} <<3>>

This attribute specifies the output level of the messages that may be output to the syslog file. However, if you specify or omit both of these attributes in the environment settings file, the value that SystemLogOutputLevel explicitly or implicitly specifies prevails.

0

Does not output messages.

1

Outputs messages only during startup, shutdown, and when an error occurs.

2

Outputs messages only during startup, shutdown, and when an error or warning occurs.

3

Outputs only start, termination and runtime messages. The runtime messages include messages about normal processing and abnormal processing.

The following table lists the messages that the generator tools output to syslog.

Message ID

Facility

Level

KDGFnnnn-E

LOG_USER

LOG_ERR

KDGFnnnn-S

LOG_USER

LOG_CRIT

KDGFnnnn-W

LOG_USER

LOG_WARNING

KDGFnnnn-I

LOG_USER

LOG_INFO

Legend:

nnnn: A four-digit number is displayed as the message code.

EvntlogLevel ~ <numerics> {0 | 1 | 2} <<0>>

This attribute specifies the level for outputting messages as JP1 events.

0

Does not output messages.

1

Only outputs messages at the start of installation or when an error occurs.

2

Outputs messages during startup/shutdown, UAP startup/shutdown, and when an error occurs.

CommandWait timeout ~ <numerics>((1 to 9999)) <<3600>>

This attribute specifies the timeout (in seconds) for the command waiting until the target file is unlocked. Specifying 9999 prevents the timeout from occurring. The command waiting time indicates the waiting time that occurs due to an exclusive control for the rdsupt command that runs as an extended function of the client services and that is executed by the user.

GF_WatchTimer ~ <characters> {ON|OFF} <<ON>>

This attribute specifies whether to monitor the UAP execution time.

ON

Monitors the execution time.

If the user command does not terminate although this attribute is set to ON and a timeout occurs, the system assumes that the user command failed and continues processing. If this occurs, the user command is not forcibly terminated. The timer uses the time specified in the APWatchTimer attribute in the packaging information file. The initial value of APWatchTimer is 300.

OFF

Does not monitor the execution time.

ERR_CONTINUE ~ <characters> {ON|OFF} <<ON>>

This attribute specifies whether to terminate the processing if an error occurs in the rdsupt command.

ON

Continues the processing even when an error occurs.

OFF

Terminates the processing when an error occurs.

If OFF is specified and an error occurs during installation processing by the rdsupt command, the installation of the next package is not executed.

NETMDMGF_UAPGEN UAP-installation-work-directory ~ <1 to 64 alphanumeric characters> <</usr/bin/UAPGEN>>

Specify the name of the work directory for UAP-based installation. Note that storing other subdirectories and files in the specified directory will cause an installation error.

NETMDMGF_UPTGEN UAP-installation-work-directory ~ <1 to 64 alphanumeric characters> <</usr/bin/UPTGEN>>

Specify the name of the work directory for UAP-based installation that is used during installation on the day of application. Note that storing other subdirectories and files in the specified directory will cause an installation error.