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

12.2.1 Failures in the client services

Organization of this subsection

(1) Failures during program product setup

(2) Installation failure during system stop

(3) Failures in the recovery facility

(4) Insufficient hard disk space

(1) Failures during program product setup

Phenomena Method of investigation Corrective actions

The end status of the package status file of JP1/Software Distribution Manager is AF The distributed program product is not installed properly.
This is recorded as an error job in both the package status file and in the job management file. In this case, investigate the cause of the failure using the following procedure.

Confirm whether the prerequisite program products for the distributed program product are properly installed.

Use the cat command to reference the following file to check the cause of the abnormal termination of program product installation.
For systems other than HP-UX:
/NETMRDS/rdsprm/PPINS.LOGF
For HP-UX:
/var/opt/NETMDMW/rdsprm/PPINS.LOGF

If the version of the prerequisite program is incorrect, re-distribute just the applicable version of the program product. The program product that resulted in the error does not need to be re-distributed.

Phenomena	Method of investigation	Corrective actions
The end status of the package status file of JP1/Software Distribution Manager is AF	The distributed program product is not installed properly. This is recorded as an error job in both the package status file and in the job management file. In this case, investigate the cause of the failure using the following procedure. Confirm whether the prerequisite program products for the distributed program product are properly installed. Use the cat command to reference the following file to check the cause of the abnormal termination of program product installation. For systems other than HP-UX: /NETMRDS/rdsprm/PPINS.LOGF For HP-UX: /var/opt/NETMDMW/rdsprm/PPINS.LOGF	If the version of the prerequisite program is incorrect, re-distribute just the applicable version of the program product. The program product that resulted in the error does not need to be re-distributed.

(2) Installation failure during system stop

Phenomena Method of investigation Causes and corrective actions

Package installation failure Because power is shut off immediately after this failure, the failure cannot be checked at that time. At the next startup of the system, a message appears showing up to ten packages for which installation failed. The number of these packages is also displayed.
See the following log files for failure information.

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

For HP-UX
/var/opt/NETMDMW/rdsprm/MAIN.LOGF
/var/opt/NETMDMW/rdsprm/PPINS.LOGF

Resolve the problem and retry.

Program product installation failure The package that failed installation cannot be used during the next system startup, because this package may prevent the daemon process from being started.
See the following log files for failure information.

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

For HP-UX
/var/opt/NETMDMW/rdsprm/PPINS.LOGF

Perform one of the following according to the failure information.

For insufficient disk space
Delete unneeded files, and then re-distribute the program product.

For a system error
Request the system administrator for repair of the UNIX machine file system. After repairs are completed, re-distribute the program product.

For a text busy error
Because the installed program product was operating until power was shut off, you cannot install it, with JP1/Software Distribution Client again.
Install the program product from the setup of the operating system.

Phenomena	Method of investigation	Causes and corrective actions
Package installation failure	Because power is shut off immediately after this failure, the failure cannot be checked at that time. At the next startup of the system, a message appears showing up to ten packages for which installation failed. The number of these packages is also displayed. See the following log files for failure information. For systems other than HP-UX /NETMRDS/rdsprm/MAIN.LOGF /NETMRDS/rdsprm/PPINS.LOGF For HP-UX /var/opt/NETMDMW/rdsprm/MAIN.LOGF /var/opt/NETMDMW/rdsprm/PPINS.LOGF	Resolve the problem and retry.
Program product installation failure	The package that failed installation cannot be used during the next system startup, because this package may prevent the daemon process from being started. See the following log files for failure information. For systems other than HP-UX /NETMRDS/rdsprm/PPINS.LOGF For HP-UX /var/opt/NETMDMW/rdsprm/PPINS.LOGF	Perform one of the following according to the failure information. For insufficient disk space Delete unneeded files, and then re-distribute the program product. For a system error Request the system administrator for repair of the UNIX machine file system. After repairs are completed, re-distribute the program product. For a text busy error Because the installed program product was operating until power was shut off, you cannot install it, with JP1/Software Distribution Client again. Install the program product from the setup of the operating system.

(3) Failures in the recovery facility

Phenomena Method of investigation Causes and corrective actions

Recovery failed The execution results of recovery, and the storage status of backup, are notified to the job management file and package status file of the managing server. For details on the recovery status, see Appendix B. Status Codes. The procedure for retrying recovery is as follows:

Analyze the recovery status at the managing server.

Confirm the backup storage status.

Execute the Recovery job at the managing server.

If it is not possible to retry recovery from the managing server, retry recovery or check the storage status of backup using the following procedure:

Execute the rdsrecover command on a UNIX machine. This step is unnecessary when recovery has already been retried or the backup has already been deleted.

Execute the Get installed package status job from the managing server, and acquire the execution results for the command.

Insufficient free space in the backup directory N/A Use one of the following methods to delete unnecessary backup to acquire free disk space.

Execute the Delete backup file job from the managing server.

Execute the rdsbkclear command from the UNIX machine. Afterwards, execute the Get installed package status job from the managing server, and then apply the deletion results.

Legend:

N/A: Not applicable

Phenomena	Method of investigation	Causes and corrective actions
Recovery failed	The execution results of recovery, and the storage status of backup, are notified to the job management file and package status file of the managing server. For details on the recovery status, see Appendix B. Status Codes.	The procedure for retrying recovery is as follows: Analyze the recovery status at the managing server. Confirm the backup storage status. Execute the Recovery job at the managing server. If it is not possible to retry recovery from the managing server, retry recovery or check the storage status of backup using the following procedure: Execute the rdsrecover command on a UNIX machine. This step is unnecessary when recovery has already been retried or the backup has already been deleted. Execute the Get installed package status job from the managing server, and acquire the execution results for the command.
Insufficient free space in the backup directory	N/A	Use one of the following methods to delete unnecessary backup to acquire free disk space. Execute the Delete backup file job from the managing server. Execute the rdsbkclear command from the UNIX machine. Afterwards, execute the Get installed package status job from the managing server, and then apply the deletion results.

(4) Insufficient hard disk space

The client services of JP1/Software Distribution Client require at least five megabytes of space in the hard disk. Delete any unnecessary files to acquire free disk space.

[Contents][Back][Next]

[Trademarks]