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

11.3.3 Packaging a user resource

The following shows the Packaging window when you select User programs or data for Package type.

Organization of this subsection

(1) Basic operation for packaging a user resource

(2) Setting detailed information for packaging a user resource

(1) Basic operation for packaging a user resource

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

Managing server

Specify the managing server where you want to package the resource. The default is the managing server set in the ManagingHost parameter in the settings file for client services. To specify a managing server other than the default, check the check box of Enter and enter the host file name in the entry box.

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 connecting to the managing server if the resource should be packaged via more than one relay system. This option is not required when packaging from the relay system directly connecting to the managing server or a UNIX machine connecting to such a top relay system.

Package ID ~ <uppercase alphabetic characters, numerics, hyphens, or 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 or 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. There are the following two methods of specifying a package. The default is Relative path (only one package).

Relative path (only one package) ~ <alphanumerics> ((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.

Absolute path (one or more packages) ~ <alphanumerics> ((up to 128 characters))

Specify an absolute path. You can specify more than one package. When you select Absolute path, the User resource path entry box and the Paths list appear. Specify the absolute path to the package in the User resource path entry box and click the Add button. To delete an absolute path from the Paths list, select the absolute path to be deleted and then click the Delete button.

(2) Setting detailed information for packaging a user resource

When you select User programs or data in the Package type option and then click the Details button, the Packaging Details (User Resources) 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 ~ <alphanumerics> ((up 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 up to 18 character strings (arguments).

Successive spaces are regarded as one delimiter.

Do not use a character having a special meaning in a shell program such as >, <, |, &, and $.

An argument cannot accept a single quotation mark '.

A double quotation mark " cannot be used. However, to include a space in a value, enclose the entire value by the double quotation marks.

A shell variable is handled as a character string and therefore its original meaning becomes ineffective.

Do not include a process that waits for a response.

External program after installation ~ <alphanumerics> ((up 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 up to 18 character strings (arguments).

Successive spaces are regarded as one delimiter.

Do not use a character having a special meaning in a shell program such as >, <, |, &, and $.

An argument, cannot accept a single quotation mark '.

A double quotation mark " cannot be used. However, to include a space in a value, enclose the entire value by the double quotation marks.

A shell variable is handled as a character string and therefore its original meaning becomes ineffective.

Do not include a process that waits for a response.

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 ~ <alphanumerics> ((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 resource. This is effective when the destination system is a client personal computer. The resource is installed in the client personal computer if it has reached the installation date and time when a distribution job is issued.

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>> (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 ~ <alphanumerics> ((up to 128 characters))

Specify the file name of the installation script file using the absolute path. If this option is omitted, the resource is packaged as a shared package but no installation script file is packaged.

File for UAP backup list ~ <alphanumerics> ((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 ~ <alphanumerics> ((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 ~ <alphanumerics> ((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 ~ <alphanumerics> ((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 you install a user resource. The default is Don't.

[Contents][Back][Next]

[Trademarks]