Job Management Partner 1/Software Distribution Administrator's Guide Volume 2
If an error occurs in a remote installation job, the cause of the error is displayed as a maintenance code. You should check the maintenance code in the Detailed Information dialog box, which is displayed from the Job Status window.
This section explains the cause of the error and the action to be taken for each maintenance code.
The 9th and 10th digits from the left in the maintenance code represent the user status, where return codes from the JP1/Software Distribution execution result, from a non-JP1/Software Distribution installer, and from an external program are displayed. If a 32-bit value is returned as a return code, the lower 1 byte is displayed. For return codes that are generated by programs other than JP1/Software Distribution, contact the developer of the installer or the external program.
The table below shows the cause of principal maintenance codes that are returned from ordinary installation jobs, and procedures for resolving the problems.
If the destination is a UNIX client, a value other than 00 is displayed as the user status even when the external program processing is successful and the remote installation job ends normally. However, this does not indicate a problem and can be ignored.
Table 6-1 Remote installation maintenance codes
Maintenance code | Cause | Action |
---|---|---|
300092020000 | Large software was remotely installed; the client is unable to allocate the disk space necessary for installation and work space. | See 5.3.3 Disk space requirements in the manual Description and Planning Guide. Calculate the hard-disk space required on the client during the remote installation. If the remote installation is on a PC that does not have adequate hard-disk space, delete any unneeded files before proceeding. Install the JP1/Software Distribution Client only on a drive that has adequate free space. |
300093010000 | The package to be installed remotely is not supported by the client. | Upgrade the client to a version that supports the package to be installed remotely. |
300097010000 | Files to be remotely installed cannot be created for the following reasons:
|
Resolve the cause indicated in reasons 1 through 3. If the client executes an Install when system starts remote installation on a program that is registered in the Startup group, the installation fails due to reason 1. In this case, move any programs that have started since the startup time to Software Distribution Client Startup; the system starts the program after executing the installation processing. For details about how to move the NETM_DM_P Startup folder, see 11.2.2(2) Moving startup programs in the manual Administrator's Guide Volume 1. For reason 4, distribute any high-compression packages after packaging them in a compatible compression mode. |
3000980Exx00# | The pre-processing program failed to start. | None. |
3000980F0000 | The external program monitoring timed out without a response from the pre-processing program. | Check the pre-processing program. Make sure that external program monitoring time is set to an appropriate value. |
30009A01xx00# | The post-processing program failed to start. | When xx is 00, check the path of the external program. When xx is other than 00, check the user status. |
30009A060000 | The external program monitoring timed out without a response from the post-processing program. | Check the post-processing program. Make sure that external program monitoring time is set to an appropriate value. |
30009F090000 | The power for the client PC was turned off during the downloading or installation of the package; the installation of the package failed. | None. |
900090009000 |
|
When creating a job, specify Replace existing package to install an identical package to that which may exist in the remote installation destination. The existing package is overwritten. |
#: xx denotes a return code from the pre- or post-processing program.
Tables 6-2 and 6-3 show maintenance codes, their meanings, and actions to be taken when JP1/Software Distribution Client, or other Hitachi program products are installed remotely.
The xx part of the maintenance code that is returned in the 3000AF00xx00 format is a job result return code. A return code also is displayed on the client screen upon termination of the remote installation of JP1/Software Distribution Client (client).
Table 6-2 Maintenance codes from remote installation of JP1/Software Distribution Client
Maintenance code | Cause | Action |
---|---|---|
300077030000 | A JP1/Software Distribution Client (client) that was not compatible with the destination OS was distributed; the installation failed. | Check the OS at the destination and the applicable OS for JP1/Software Distribution Client (client); remotely install the JP1/Software Distribution Client (client) that is compatible with the destination OS. |
3000AF000000 | Normal termination. | None. |
3000AF008000 | Analysis of installation setup file (setup.inf) failed. | Notify the system administrator. |
3000AF008100 | Installation file not found on the medium (no PP files). | Possibly invalid media. Notify the system administrator. |
3000AF008200 | Registration of icon failed (post-installation error). | The operating environment for JP1/Software Distribution may be invalid. Manually perform overwrite installation. |
Program folder for remote control agent missing. | The operating environment for JP1/Software Distribution may be invalid. Manually perform overwrite installation. | |
3000AF008300 | Registration of registry for remote control agent failed. | The operating environment for JP1/Software Distribution may be invalid. Manually perform overwrite installation. |
Registration of permitted controller for remote control agent failed. | The operating environment for JP1/Software Distribution may be invalid. Manually perform overwrite installation. | |
Installation directory in the registry missing. | The operating environment for JP1/Software Distribution may be invalid. Manually perform overwrite installation. | |
Registration of a module required for searching for information about Microsoft Office and anti-virus products failed. | COM Object Save Command Failed is output to Windows-directory\Temp\DMPINST.LOG. Take one of the following actions:
|
|
3000AF008500 | Error during file copy (disk-access error). | Make sure that the hard disk is operating normally. If the hard disk is operating normally, it is possible that the installation directory is being used. Either close all applications that are using the installation directory or reboot the PC. |
3000AF008500 | Creation of file copy directory failed during automated distribution of JP1/Software Distribution Client (client). | Make sure that the hard disk is operating normally. If the hard disk is operating normally, it is possible that the installation directory is being used. Either close all applications that are using the installation directory or reboot the PC. |
3000AF008600 | Insufficient free hard-disk space for installation directory. | Either rerun the remote installation after increasing the amount of free hard-disk space or rerun the remote installation by specifying another installation drive. |
3000AF008600 | Backup of execution file failed. | Rerun the remote installation after increasing the amount of free hard-disk space. |
3000AF008700 | Reading of installer DLL failed. | Notify the system administrator. |
Disk replacement requested during automated distribution of JP1/Software Distribution Client (client). | Notify the system administrator. | |
Invalid disk number during automated distribution of JP1/Software Distribution Client (client). | Check the disk number and try packaging again. | |
Error during decompression of installation file. | Notify the system administrator. | |
Remote control agent failed to read installation DLL (file open error). | Notify the system administrator. | |
3000AF008B00 | Error in integrated installer flag settings | Notify the system administrator. |
3000AF008C00 | JP1/Software Distribution Client (client) was installed on a computer on which one of the following relay system products was already installed:
|
Take one of the following actions:
|
JP1/Software Distribution Client (client) was installed on a computer on which Software Distribution Light was already installed. | Uninstall Software Distribution Light, or install JP1/Software Distribution Client (client) on a different computer. | |
Integrated installer operation error | Notify the system administrator. | |
Invalid OS version on installation destination (installation rejected). | Remote installation of JP1/Software Distribution Client may have been attempted on a system on which it cannot be installed. Check the OS version of the installation destination. | |
Invalid installation destination OS in remote control agent. | Remote installation of JP1/Software Distribution Client may have been attempted on a system on which it cannot be installed. Check the OS version of the installation destination. | |
JP1/Software Distribution Client (client) Remote Control Agent was installed on a PC on which JP1/Remote Control Agent or JP1/Software Distribution Manager Remote Control Agent was already installed. | Notify the system administrator. | |
3000AF009000 | The installation component is invalid (it was installed remotely on a PC on which Client installation by Web was already installed). | If the JP1 Version 7i component Client Installation by Web is installed on the PC, install the installation component manually. |
3000AF009200 | JP1/Software Distribution Client (client) busy. | Re-try remote installation of JP1/Software Distribution Client (client). |
3000AF009300 | Hard disk-space shortage occurred during installation of JP1/Software Distribution Client from Web browser (installation from ActiveX-compatible page). | Delete any unneeded files; re-try the installation. |
3000AF009400 | Installation pre-processing error. | Notify the system administrator. |
Driver setting by remote control agent failed. | Notify the system administrator. | |
Remote control agent failed to read the dialog box. | Notify the system administrator. | |
Remote control agent service control error. | Notify the system administrator. | |
3000AF009500 | Attempt was made to install JP1/Software Distribution Client (client) from Web browser. However, components other than a client or remote control agent are already installed. | Uninstall the non-client, non-remote control agent components. |
JP1/Software Distribution Client (client) was remotely installed on a PC on which JP1/Software Distribution Manager (relay manager) was already installed. | Uninstall JP1/Software Distribution Manager, or install JP1/Software Distribution Client (client) on a different PC. | |
JP1/Software Distribution Client (relay system) was remotely installed on a PC on which JP1/Software Distribution Manager was already installed. | Uninstall JP1/Software Distribution Manager, or install JP1/Software Distribution Client (relay system) on a different PC. | |
3000AF009600 | The transfer of management files from the relay system failed. | Re-execute remote installation. |
3000AF009800 | JP1/Software Distribution Client was remotely installed on a PC on which Startup Kit Support Tool was already installed. | If Startup Kit Support Tool is already installed on the PC, the installation should be performed manually. |
JP1/Software Distribution Client (relay system) was remotely installed on a PC on Differing Components Extractor was already installed. | If Differing Components Extractor is installed on the PC, install JP1/Software Distribution Client (relay system) manually. |
Table 6-3 Maintenance codes from remote installation of other Hitachi program products
Code | Meaning | Action |
---|---|---|
300077030000 | A Hitachi program product not compatible with the destination OS was distributed; the installation failed. | Check the destination OS and the applicable OS for the Hitachi program product. Remotely install a Hitachi program product compatible with the destination OS. |
3000AF008000, 3000AF008100 | The installation terminated abnormally. | Notify the system administrator. |
3000AF008200 | An external program error occurred after installation.
|
Check to see that the path for the program to be executed after the packaging process is correctly specified. If the path is correct, it is possible that the program that was executed terminated abnormally. |
3000AF008300 | The installation terminated abnormally. | Notify the system administrator. |
3000AF008400 | Memory shortage during installation. | Close other programs to free memory, and retry. |
3000AF008500 | Hard disk access error occurred. | Confirm that the hard disk is operating normally. If the hard disk is OK, it is possible that the installation destination folder is busy, in which case close the application using the folder or reboot your PC. |
3000AF008600 | Not enough free space on the hard disk. | Make sure that the hard disk has enough free space, and then retry. |
3000AF008700 | The installation terminated abnormally. | Notify the system administrator. |
3000AF008800 | The startup parameter is invalid
|
If the error situation is as explained in the example at the left, try installation again. In other cases, notify the system administrator. |
3000AF008A00 | The new PP cannot be reinstalled. | Since the old version is already installed on the distribution destination, try remote update installation again. |
3000AF008B00 | The installation terminated abnormally. | Notify the system administrator. |
3000AF008C00 | The installation was rejected
|
If the error situation is as explained in the example at the left, install the prerequisite program and then try installation again. In other cases, notify the system administrator. |
3000AF008D00, 3000AF008E00, 3000AF008F00 | The installation job terminated abnormally. | Notify the system administrator. |
3000AF009000 to 3000AF009900, 3000AF009A00 to 3000AF009F00 | The installation job terminated abnormally due to a Hitachi PP-specific reason. | Check the release notes or the README file for the program product whose installation failed. Alternatively, notify the system administrator for the affected program product. |
The table below shows the maintenance codes that are returned from the remote installation of other companies' software, their causes, and actions to be taken.
Table 6-4 Maintenance codes from remote installation of other companies' software
Maintenance code | Cause | Action |
---|---|---|
300091070000 | An error occurred during installation on the destination system. The following causes can be suspected:
|
In the Software Distribution Packaging dialog box, open the Recorder File page, confirm that a recorder file is specified in the recorder file directory specification field, and execute the job. Note that file extensions vary depending upon the destination environment and the method of installation employed. Make sure that the destination system supports AIT files. Also, make sure that the package is not damaged. |
300094060000 | An error occurred during the copying of the installation definition file. | Check the amount of available disk space in the destination system. If the problem persists when the job is rerun, notify the system administrator. |
300097020000 | Destination system: a PC An error occurred during installation on the destination system. The following causes can be suspected:
The installation password file is damaged. |
Destination system: a PC Check the path for the installer specified in the installation definition file. Check the path for the installer specified in the package information in the AIT file. If the problem persists even after the preceding checks are made, notify the system administrator. Destination system: UNIX Register the installation password file, and then rerun the job. |
30009F070000 | An error occurred during installation on the destination system. The following causes can be suspected:
|
|
30009F0B0000 | During installation on the distribution system, the processing of the recorder or AIT file timed out. The following causes can be suspected:
|
|
300099020000 | Distribution system: a PC An error occurred during execution of the installation script on the distribution system. The following causes can be suspected:
An error during the include processing. |
Distribution system: a PC Make sure that the system is operating in the GUI installation mode and that the contents of the recorder or AIT file do not have an error. If the problem persists even after the preceding checks are made, notify the system administrator. Distribution system: UNIX Investigate the cause of the problem by checking the log file for the distribution system. |
The table below shows maintenance codes that are returned, their causes, and actions to be taken, when Search for Microsoft Office products and Search for anti-virus products in a Get software information from client job are executed.
Table 6-5 Maintenance codes from the execution of a get software information from client job
Maintenance code | Cause | Action |
---|---|---|
3000EF200000 | An error occurred during the acquisition of software information on the distribution system. The following causes can be suspected:
|
Delete any unneeded files on the distribution system and increase the available hard disk space. In addition, stop any applications that are not needed. |
3000EF210000 | A script execution error occurred for the acquisition of software information on the distribution system. The following causes can be suspected:
|
If the same error occurs when other scripts are executed, re-install the client. If only this script produces an error, notify the system administrator. |
3000EF220000 | A disk space shortage occurred during the acquisition of software information on the distribution system. | Delete any unneeded files on the distribution system to increase the available hard disk space, and rerun the job. |
3000EF230000 | A memory shortage occurred during the acquisition of software information on the distribution system. | Stop any unneeded applications on the distribution system, and rerun the job. |
3000EF240000 | The processing of a script for the acquisition of software information timed out on the distribution system. | The script that was executed contains an error. Notify the system administrator. |
3000EF250000 | The execution of a script for the acquisition of software information failed on the distribution system. The Windows scripting host may not have been installed or may have been installed incorrectly. |
Re-install the Windows scripting host on the distribution destination system. If this re-installation does not resolve the problem, re-install the client. |
3000EF300000 | Detection of patch information by Windows Update Agent or MBSA failed in the distribution-destination system. The following causes can be suspected:
|
Confirm whether the required programs are installed. Re-run the job by enabling the following settings in the Client setup:
|
The table below shows maintenance codes that are returned, their causes, and actions to be taken, from a Transfer user inventory schema to client job.
Table 6-6 Maintenance codes from a transfer user inventory schema to client job
Maintenance code | Cause | Action |
---|---|---|
300073002290, 300093012290, 3000e5012290, 3000e7012290 |
The relay system or the client that is the target of the job does not support the execution of Transfer user inventory schema to client jobs. | Transfer user inventory schema to client jobs can be used in the versions indicated below. Make sure that the relay system or the client you are using is one of the following versions:
|
The table below shows maintenance codes that are returned, their causes, and actions to be taken, from a Set the software monitoring job.
Table 6-7 Maintenance codes from a Set the software monitoring job
Maintenance code | Cause | Action |
---|---|---|
300093010000 | The relay system or the client that is the target of the job does not support the execution of Set the software monitoring jobs. | Set the software monitoring jobs can be used in the versions indicated below. Make sure that the relay system or the client you are using is one of the following versions:
|
All Rights Reserved. Copyright (C) 2009, 2013, Hitachi, Ltd.
Copyright, patent, trademark, and other intellectual property rights related to the "TMEng.dll" file are owned exclusively by Trend Micro Incorporated.