Job Management Partner 1/Software Distribution Client Description and User's Guide

[Contents][Glossary][Index][Back][Next]

12.1.2 Failure information during package distribution or file collection

The status of a UNIX machine to which packages are being distributed or from which files are being collected is sent to the managing server as a status code (end status or user status). The UNIX managing server stores the status code in the job management file. For the meanings of status codes, see B Status Codes.

If a failure occurs at the distribution-destination system, detailed information is also stored in the managing server's job management file. For details about the storage method, see 13.1.2 Formats for messages output during package distribution or during file collection.

Figure 12-1 shows the storage of failure information during package distribution or file collection.

Figure 12-1 Storage of failure information during package distribution or file collection

[Figure]

For the file names of MAIN.LOGF, PPINS.LOGF, and CF.LOGF, see (2) Checking the local system's failure information.

If you cannot identify the failure cause by referring to the status code, MAIN.LOGF, PPINS.LOGF, or CF.LOGF, you need to acquire the failure information of JP1/Software Distribution Client on the UNIX machine. For the acquisition method, see 12.3 Acquiring failure information.

Organization of this subsection
(1) Checking the managing server's failure information
(2) Checking the local system's failure information
(3) Checking the messages in the syslog file

(1) Checking the managing server's failure information

To check the details of the managing server's failure information, you can use one of the commands or the window described below.

For the UNIX version of JP1/Software Distribution Manager
rdsdmind -c command or rdsdmind -l command

For the UNIX version of JP1/Software Distribution Client
rdsafind -l command

For the Windows version of the managing server
Job Status window

(2) Checking the local system's failure information

You can use the cat command or a pager command such as pg and more to check the details of the message log files listed below.

Functions Contents of the message log file Message log file name
Client services Failure information about distribution of data/user programs and failure information during file collection

For systems other than HP-UX
/NETMRDS/rdsprm/MAIN.LOGF

For HP-UX
/var/opt/NETMDMW/rdsprm/MAIN.LOGF
Failure information about distribution of program products

For systems other than HP-UX
/NETMRDS/rdsprm/PPINS.LOGF

For HP-UX
/var/opt/NETMDMW/rdsprm/PPINS.LOGF
Failure information about distribution of another company's software

For systems other than HP-UX
/NETMRDS/rdsprm/ISVSOFT.LOGF

For HP-UX
/var/opt/NETMDMW/rdsprm/ISVSOFT.LOGF
Failure information about installing OS patches

For systems other than HP-UX
/NETMRDS/rdsprm/OSPATCH.LOGF

For HP-UX
/var/opt/NETMDMW/rdsprm/OSPATCH.LOGF
Failure information about unarchiving OS patches

For systems other than HP-UX
/NETMRDS/rdsprm/UNACV.LOGF

For HP-UX
/var/opt/NETMDMW/rdsprm/UNACV.LOGF
Failure information about applying patches

For systems other than HP-UX
/NETMRDS/rdsprm/PPPATCH.LOGF

For HP-UX
/var/opt/NETMDMW/rdsprm/PPPATCH.LOGF
Failure information about external program processing for collection

For systems other than HP-UX
/NETMRDS/rdsprm/CF.LOGF

For HP-UX
/var/opt/NETMDMW/rdsprm/CF.LOGF
Distributor tools Message log file

For systems other than HP-UX
/NETMAF/dmprm/MAIN.LOGF

For HP-UX
/opt/NETMAF/dmprm/MAIN.LOGF

An example of the MAIN.LOGF file as displayed by the cat command follows.

[Figure]

  1. Message output number
    Indicates the output location of the message in the message log file.
  2. Output date and output time
    Indicates the date and time when the message is output. The date and time follow the local standard time and are in the time zone of the parent process that started JP1/Software Distribution Client, and results adjusted for Daylight Savings Time are stored.
  3. Process ID
    Indicates the process ID of the JP1/Software Distribution Client process that output the message.
  4. Serial message output number in process
    Indicates the serial message output number within the JP1/Software Distribution Client process.
  5. Message
    Contains text indicating the nature of the failure. The language type of the message depends on the language environment of the process that activated JP1/Software Distribution Client.
  6. JP1/Software Distribution Client maintenance information 1
    Indicates maintenance information for JP1/Software Distribution Client.
  7. JP1/Software Distribution Client maintenance information 2
    Indicates maintenance information for JP1/Software Distribution Client.
  8. JP1/Software Distribution Client maintenance information 3
    Indicates maintenance information for JP1/Software Distribution Client. When JP1/Software Distribution Client maintenance information 2 contains a system call name, the second number in maintenance information 3 indicates the error number (errno) of the system call.
    For distribution of another company's software, the second number in maintenance information 3 indicates the return value of the OS installation command.

(3) Checking the messages in the syslog file

Messages that are output to /NETMRDS/rdsprm/MAIN.LOGF (/var/opt/NETMDMW/rdsprm/MAIN.LOGF in the case of HP-UX) are output to the syslog file. For the storage location of the syslog file, see the manual of the applicable OS.

Messages issued during system shutdown are not output to the syslog file.

The storage format of the syslog file follows.

[Figure]

  1. Output date and output time
    Indicates the date and time when the message is output. The date and time follow the local standard time and are in the time zone of the parent process that started JP1/Software Distribution Client, and results adjusted for Daylight Savings Time are stored.
  2. Host name
    Indicates the host name of the managing server that output the message.
  3. Process ID
    Indicates the process ID of the JP1/Software Distribution Client server process that output the message.
  4. Message
    Contains text indicating the nature of the failure.

If an error occurs during file transfer, the message text that is output to the syslog file is always the same, regardless of the actual source message. Therefore, the message text output to the syslog file does not match the message code. However, message text that correctly matches the message code is output to the MAIN.LOGF file of the distribution-destination system at the file-transfer request source.

The following shows the message text that is output to the syslog file when an error occurs during file transfer.

KDDM9xxx-*: An error occurred in the file transfer server.

Legend:
xxx: Message code
*: Message type

[Contents][Back][Next]

[Trademarks]

All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.