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

11.3.4 Packaging an OS Patch

The following figure shows the Packaging window that is displayed when you select OS patch for Package type. Some attributes of the packaging-information file may not be effective when you install an OS patch. For such attributes, see 2.6.3 Notes on configuring the packager in PART 1.

Organization of this subsection

(1) Basic operation for registering an OS patch

(2) Setting detailed information for registering an OS patch

(1) Basic operation for registering an OS patch

The following lists and describes the options to specify in the Packaging window. The Cabinet ID and User resource path options cannot be omitted.

Managing server

Specify the managing server where you register the OS patch. By default, the OS patch is registered in the managing server set for ManagingHost in the settings file of the client services. If you want to register the OS patch in another managing server, select Enter and specify a desired managing server name.

Password ~ <alphanumerics> ((1 to 8 characters))

Specify a password for registering the resource with the managing server. Specify a password that has been set to identify a packager on the managing server. No password is necessary when the resource is to be registered with the Windows version of JP1/Software Distribution Client Version 8 or later and the Windows version of JP1/Software Distribution SubManager Version 7i or earlier.

When packaging the resource in UNIX JP1/Software Distribution Manager or UNIX JP1/Software Distribution Client (relay system)
Specify the password set in the PasswordForUpload parameter in the settings file.

When packaging the resource in Windows JP1/Software Distribution Manager
Specify the password specified when you created a the relational database. When not using a relational database, omit this option.

Cabinet ID ~ <alphanumerics> ((2 characters))

Specify the cabinet ID of the destination. You can package up to 256 resources in one cabinet. To create a new cabinet and package resources in the newly created cabinet, specify a name you want to assign to the cabinet in this option. The cabinet with the specified name will be automatically created and resources can be packaged in the cabinet.

Register different cabinet IDs with different managing servers. If you register different packages with the same cabinet ID in different managing servers, you may not be able to distribute the packages.

Top relay system

Specify the host name of the relay system directly connected to the managing server if the OS patch is registered via two or more relay systems. If you register the OS patch from the relay system directly connected to the managing server or from a UNIX machine connected to this relay system, you do not need to specify the top relay system.

Package ID ~ <upper-case alphabetics, numbers, hyphens, and underscores> ((up to 44 characters))

Specify an ID for the package you want to register. The package ID must be unique in the network system

Version ~ <alphanumerics and slants> ((up to 6 characters))

Specify the version of the package you want to register. The default is 000000.

Generation ~ <alphanumerics> ((up to 4 characters))

Specify the generation number of the package you want to register. The default is 0000.

Specify by:

Select how to specify the package you want to register. You can select only Relative path.

Relative path (only one package) ~ <alphabetics> ((up to 128 characters))

Specify a relative path. You can specify only one package. When you select Relative path, the User resource path and Base directory entry boxes appear. Specify the relative path to the package in the User resource path entry box and the path to the reference point in the Base directory entry box.

(2) Setting detailed information for registering an OS patch

When you select OS patch in the Package type option and then click the Details button, the OS Patch DETAILS dialog box appears.

The following lists and describes the options you specify in this dialog box.

Compress

Select whether or not to compress the resource. If you specify to compress it, select the compression method. The default is Settings file.

Settings file

Follows the value set in the settings file for client services.

Compress

Compresses the resource regardless of the value set in the settings file for client services.

If an error occurs during the compression, the resource is packaged without being compressed.

Prerequisite version

Specify the prerequisite version for distributing the package. 000000 specifies to distribute the package unconditionally regardless of the prerequisite version. If you do not specify the no prerequisite version, a blank is assumed and the package will be distributed without checking the prerequisite version.

Installation timing

Select the timing of installing the resource. The default is While running.

At system start

Installs the resource when the system starts up.

While running

Installs the resource according to a distribution job from the managing server.

At system stop

Installs the resource when the system stops.

If the resource has a daemon process, install it when the system starts up or stops. You cannot install a resource when the system starts up if:

it is activated earlier than the user_daemon step in the /etc/rc script.

it has a shared library, or

it includes a program registered in /etc/inittab with respawn specified.

Generator type

Select the type of the generator you want to activate when installing the resource. The default is Standard.

Standard

Standard generator that the client services provide.

WS generator

Workstation generator

Installation mode

Select the installation mode for packaging the resource in the storehouse. This is effective only when the destination system is Windows JP1/Software Distribution Client. The default is Background.

Background

Mode for background installation

GUI

Mode for graphical user interface installation

External program before installation ~ ((1 to 60 characters))

Use an absolute path to specify the external program pre-installation processing that starts before the standard generator executes the installation. When you specify the external program post-installation processing as well, the value for the external program pre-installation processing and the value for the external program post-installation processing must be fewer than 60 characters in total. This option is valid when you specify Standard for Generator type. When you specify WS Generator for Generator type, the external program pre-installation processing is ignored even if it is specified.

If you specify the program of the external program pre-installation processing under the /NETMRDS/usrcom/ (/opt/NETMDMW/usrcom/ for HP-UX) directory, you can use a relative path to specify it.

Note the following when you specify the external program pre-installation processing:

You can specify a maximum of 18 character strings (arguments).

Successive spaces are treated as a single delimiter.

Do not use characters that have special meaning in shell programs such as >, <, |, &, and $.

Apostrophes (') are not treated as arguments.

You cannot specify double quotation marks ("). However, to specify a blank character in a setting value, enclose the setting value between double quotation marks.

Shell variables are invalid since they are treated as character strings.

Do not include processing that waits for responses.

External program after installation ~ ((1 to 64 characters))

Use an absolute path to specify the external program post-installation processing to be started after the package is installed. This option is valid when the package is distributed to workstations. This option is ignored when the package is distributed to personal computers. When you select WS Generator for Generator type, you can use a maximum of 40 characters to specify the external program post-installation processing.

If you specify the program of the external program post-installation processing under the /NETMRDS/usrcom/ (/opt/NETMDMW/usrcom/ for HP-UX) directory, you can use a relative path to specify it.

Note the following when you specify the external program post-installation processing:

You can specify a maximum of 18 character strings (arguments).

Successive spaces are treated as a single delimiter.

Do not use characters that have special meaning in shell programs such as >, <, |, &, and $.

Apostrophes (') are not treated as arguments.

You cannot specify double quotation marks ("). However, to specify a blank character in a setting value, enclose the setting value between double quotation marks.

Shell variables are invalid since they are treated as character strings.

Do not include processing that waits for responses.

Time-out ~ <unsigned integer> ((1 to 32767)) (in seconds)

Specify the period of time of monitoring the external program post-installation processing. When the processing is not completed within the specified time-out period, JP1/Software Distribution Client does not wait for the processing to be completed and executes the next processing. In this case, JP1/Software Distribution Client reports an installation error to the managing server.

This option is effective for all installation timing.

Installation target directory ~ <alphabetics> ((up to 64 characters))

Specify to which directory you want to install the resource. You can specify a hard disk resource when packaging with the relative path specified. If the specified directory does not exist in the destination system, it will be created when installing the resource. If you do the directory is not define or if you omit this option, the root directory / is assumed.

Mode ~ <unsigned integer> ((700 to 777)) <<755>>

Specify the file mode to be set for the target directory if the directory specified in the Installation target directory option does not exist. For the file mode, specify only the absolute value of the permission mode bit. When you specify this option, always specify Owner and Group.

Owner ~ <unsigned integer> ((0 to 59999))

Specify the user number of the owner of the target directory if the directory specified in the Installation target directory option does not exist. If you do not define the owner or if you omit this option, root (user number 0) is assumed.

Group ~ <unsigned integer> ((0 to 59999))

Specify the group if the directory specified in the Installation target directory option does not exist. When you specify this option, always specify Owner. If you do not define the group number or if you omit this option, sys (group number 3) is assumed.

Package storage period ~ <unsigned integer> ((current date to 2089/12/31)) <<0>>

Specify the expiration date for keeping the package in the storehouse of the relay system after it is distributed. The default is the number of days specified in the settings file for keeping a package. If a year before the packaging date is specified, it results in an error.

Installation date/time ~ <unsigned integer> ((current year to 2089))

Specify the date and time to install the package. The client installs the package that has reached its installation date and time when the installation is instructed.

Recovery option

Specify whether or not to use the recovery option. The default is Do not recover. A socket device is out of the range of this recovery option. When you include a socket device in the backup list or register a file having the same name as that of a socket device, do not select Recover. If you specify the recovery option for a packaging-information file for packaging a socket device, no backup will be acquired when distributing and the file for the socket device will not be distributed.

Backup storage period ~ <unsigned integer> ((0 to 999)) <<0>> (in days)

When you enable the recovery option, specify the period for time for keeping a backup after the recovery option failed or when the recovery option cannot be executed. A backup will be deleted when the number of days specified in this option is elapsed after the distribution date. While a backup is being stored, the recovery option can be retried. Specifying 0 in this option does not keep a backup. Specify 0 for a package for which the recovery option should not be retried. The default is 0.

Installation script file ~ <alphabetics> ((up to 128 characters))

Use an absolute path to specify the file name of the installation script file. If you omit this option, the OS patch is registered as a shared resource. However, the installation script file is not registered.

File for UAP backup list ~ <alphabetics> ((up to 128 characters))

Specify the file name of the backup list indicating the files and directory to be used to make a backup when the recovery option is enabled for distribution of the next version after the package is distributed. Use the absolute path to specify the file name of the backup list.

This option becomes effective when the recovery option is enabled for the distribution of the next version after the package is distributed. That is, this option is ineffective for the distribution of the current version of this package even if the recovery option is enabled.

If this option is omitted, only the overwritten files and directory will be backed up when the recovery option is enabled for the distribution of the next version.

Program name ~ <alphabetics> ((up to 50 characters))

Specify you want to assign a general name to the package. Specify this option when you want to assign a general name other than the package ID. If you omit this option, a blank character is assumed.

Package owner ~ <alphabetics> ((up to 14 characters))

Specify the name of the owner of the resource you want to package. If this option is omitted, a blank character is assumed.

Comment ~ <alphabetics> ((up to 64 characters))

Enter a user comment for the resource you want to package. This specification is effective when you select WS generator in the Generator type option. Do not include a line feed within the comment. If this option is omitted, a blank character is assumed.

OS reboot after installation

Specify whether to restart the operating system after the OS patch is installed. The default is Don't.

[Contents][Back][Next]

[Trademarks]