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

rdsft

The rdsft command executes packaging, remotely installs packages, and initializes the temporary package storehouse.

Description

Instructs the system to register a program product from a tape- or disk-based device or a hard disk.

Requests packaging of user data and user programs from the hard disk.

Instructs a relay system or end workstation to distribute a package according to a distribution job from the managing server.

Requests initializing of the temporary package storehouse, thus deleting all packages from it.

Format

Packaging of a program product

rdsft -c
[-kpassword]
{-s|-Spackaging-target-program-product-designation}
[-gcabinet- ID]
[-hhost-file-name or host-name]
[-Q]
-C{special-file-name|hitachi-program-product-storage-directory}
[packaging-information-file-name]
[-Nservice-name]

Packaging of user data and user programs

rdsft -c
[-kpassword]
[{-duser-resource-path|-Duser-resource-path-file}]
[-gcabinet-ID]
[-rpackage-ID]
[-pprogram-name]
[-vversion]
[-Vprerequisite-version]
[-Ggeneration-number]
[-hhost-file-name or host-name]
[-mmanaging-host-name]
[-Q]
[packaging-information-file-name]
[-Nservice-name]

Remote installation

rdsft -a
[-hhost-file-name or host-name]
[-Nservice-name]

Initializing the temporary package storehouse
```
rdsft -init
```

Options

-a

In a relay system or end workstation, when there is a distribution job addressed to the local UNIX machine, this option instructs that the package be distributed according to that distribution job. The command processing terminates after completion of all jobs of distribution to your own UNIX machine.

In case an error occurs during the processing of multiple jobs of distribution to your own UNIX machine, JP1/Software Distribution Client operates as follows:

If an error occurs during installation in process, JP1/Software Distribution Client aborts the processing of the distribution job involved in the error and proceeds to another distribution job.

If an error occurs during communication with the managing server, JP1/Software Distribution Manager aborts the processing of all distribution jobs.

JP1/Software Distribution Client terminates processing if there is no job of distribution to your own UNIX machine.

-Cspecial-file-name or hitachi-program-product-storage-directory ~ ((1 to 128 characters))

When registering Hitachi program products, you must specify this option.

special-file-name

Specify the absolute pathname from /dev/ of a special file for a tape or disk device that stores the resources you want to package. For details on how to specify a special file name, see 2.2.3(1) Registering Hitachi program products.

If you want to perform packaging of a program product, using a special file that is not standard for the system, you must define the special file beforehand in a special file definition file. For details on how to define a special file, see 2.2.4(3) Setting the special file definition file.

hitachi-program-product-storage-directory

Specify the absolute path of the directory where the Hitachi program products are stored. Note that you cannot specify the root directory (/). The specified Hitachi program product storage directory must contain OS directories named like those listed below. These directories may be named in lowercase letters. Do not store anything other than these OS directories in the specified Hitachi program product storage directory.

HPUX, IPFHPUX, AIX, SOLARIS

-c

Specify this option to register resources with the managing server.

Make sure that the size of the resource does not exceed 2 gigabytes before and after registration. Registered resources can only be distributed to machines with the same operating system as the registration source.

-Duser-resource-path-file-name ~ ((1 to 128 characters))

Specify the name of a user resource path file. Specifying this option enables JP1/Software Distribution Client to execute packaging of multiple directories and files in a batch. For information on how to create a user resource path file, see 2.2.4(2) Creating the user resource path file. You must not specify the -D option together with the -d option. Do not specify a path using two consecutive periods (..) as the user resource path file parameter. If you omit this parameter, JP1/Software Distribution Client distributes directories or files under /NETMRDS/UPUPL/hd/ (other than HP-UX) or /var/opt/NETMDMW/UPUPL/hd/ (HP-UX). If packaging of an empty directory is executed, only the directory frame is restored on the distribution destination.

-duser-resource-path ~ ((1 to 128 characters))

Specify the absolute or relative path of a directory that stores the resources you want to package. You must not specify option -d together with option -D. Do not specify a path using two consecutive periods (..). If you omit the -d option, JP1/Software Distribution Client distributes directories or files under /NETMRDS/UPUPL/hd/ (other than HP-UX) or /var/opt/NETMDMW/UPUPL/hd/ (HP-UX). If packaging of an empty directory is executed, only the directory frame is restored on the distribution destination.

-Ggeneration-number ~ <uppercase alphabetic characters or numerics> ((4 digits))

Specify the generation number of the package you want to register.

The generation number specified in the -G option has priority over that specified in the packaging-information file. If you omit the -G option, the corresponding specification in the packaging-information file is effective.

-gcabinet-ID ~ <uppercase alphabetic characters or numerics> ((2 characters))

Specify a cabinet ID for packaging. Full up to 256 resources can be packaged in one cabinet. To creating a new cabinet and packaging into it, specify a cabinet ID in this option to the cabinet, then JP1/Software Distribution Client automatically creates the cabinet and can execute packaging.

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.

Unless you specify the -g option and a cabinet ID, the cabinet ID specified in the packaging-information file is effective. The specification in the -g option has priority over that in the packaging-information file. If you do not use the packaging-information file, always specify the -g option.

-hhost-file-name or host-name

host-file-name

If you want to perform packaging and remote installation according to the attribute setting specified in a host file, specify the name of the host file.

If you specify option -m, specify the host file of the relay system specified in the -m option. To specify this option on a UNIX machine connected to a relay system that is directly connected to the managing server, specify the host file of that relay system.

If you omit specification by the command for packaging operation, the specification in the packaging-information file is effective. The specification in the -h option has priority over that in the packaging-information file. If you do not specify a host file name in the -h option or the packaging-information file, the value specified in the settings file is effective in the relay system or end workstation. In a relay system connected to another relay system or client workstation, either the value in the settings file of the relay system specified in ManagingHost of the local UNIX machine settings file is effective, or the value specified in the settings file of the relay system specified by the -m option is effective. If you omit specification for packaging operation, the value in the settings file is effective.

host-name

If you want to perform packaging or remote installation from a system for which the operating environment is not set, specify the host name of the managing server (UNIX JP1/Software Distribution Manager, UNIX JP1/Software Distribution Client (relay system) or Windows JP1/Software Distribution Manager).

-init

Specifies the deletion of all the packages to initialize the temporary package storehouse.

When packages are distributed with the ID group specified, or when there are remaining jobs in the local relay system, initialization of the temporary package storehouse makes the job condition as follows:

When RESOURCE_DELETE is specified for IDCommandDeleteTiming in the settings file
The jobs in the temporary job storehouse corresponding to the deleted packages, and the jobs in the job management file of the managing server are deleted. Jobs scheduled for installation are also deleted from the distribution-destination system of the ID group specified in that job.

When MANUAL is specified for IDCommandDeleteTiming in the settings file
The jobs in the temporary job storehouse corresponding to the deleted packages and the jobs in the job management file of the managing server become invalid. Jobs scheduled for installation are also cancelled in the distribution-destination system of the ID group specified in that job.

-kpassword ~ <uppercase alphabetic characters or numerics> ((1 to 8 characters))

Specify a password for registering resources with the managing server. Specify a password that has been set to identify a packager on the managing server.

When registering with UNIX JP1/Software Distribution Manager or UNIX JP1/Software Distribution Client (relay system)
Specify a password for power supply uploading as specified for PasswordForUpload in the settings file.

When registering with Windows JP1/Software Distribution Manager
Use the password you specified when you created a relational database. Do not specify any password unless you use a relational database.

If you omit the -k option, JP1/Software Distribution Client displays a message prompting password input. If you want to input a password without having it displayed on the screen, enter a password in response to this message. If you specify option -Q, you must not omit the -k option.

-mmanaging-host-name

If you want to perform packaging via two or more relay systems, specify the host name of the relay system that is directly connected to the managing server.

You need not specify a managing host name if you are registering the package from one of the following machines:

Relay system that is directly connected to the managing server

UNIX machine connected to a relay system that is directly connected to the managing server

End workstation

-Nservice-name

In service-name, specify the service name for the managing server you want to connect.

-pprogram-name ~ ((1 to 50 characters))

Specify a general name to assign to the package you want to register. Specify this name if you want to assign the package a generally known name other than the package ID. Unless you specify the -p option and a program name, the corresponding specification in the packaging-information file is effective. The specification in the -p option has priority over that in the packaging-information file. If you do not specify the name of the packaging-information file and if you omit the -p option, JP1/Software Distribution Client assumes blank characters.

-Q

Specify this option if you want JP1/Software Distribution Client to immediately quit the ongoing processing without waiting for the response in case a password input error or some other error should occur during packaging operation. If you specify the -Q option, you must not omit the -k option.

Specify the -Q option so that the command processing will terminate immediately in the following case:

You do not give a password to the command.

The password is incorrect.

Packaging for another distribution-destination system is being executed for the target group for packaging.

Also, you may specify the -Q option so that JP1/Software Distribution Client will quit the command execution without displaying the KDDM1544-Q message. This message prompts you to decide whether to overwrite the specified package if the same package ID exists.

-rpackage-ID ~ <uppercase alphabetic characters, numerics, hyphens, or underscores> ((1 to 44 characters))

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

The package ID specified in the -r option has priority over that specified in the packaging-information file. If you omit the -r option, the corresponding specification in the packaging-information file is effective. If you apply a system that does not use the packaging-information file, always specify the -r option.

{-s|-Spackaging-target-program-product-designation} ~ ((1 to 128 alphanumeric characters))

Specify a program product that is a target of packaging.

-s

Indicates the packaging of a program product specified in the packaging-information file.

-S packaging-target-program-product-designation

Indicates that you must specify the designation of a program product you want to register. Specify the program product designation with 128 or less characters including blank and special characters.

You must specify either of the -s and -S options.

-Vprerequisite-version ~ <uppercase alphabetic characters, numerics, or slants>((1 to 6 characters))

Specify a prerequisite version for distributing the package you want to register. The prerequisite version specified in the -V option has priority over that specified in the packaging-information file. If you omit specifying the -V option, the corresponding specification in the packaging-information file is effective.

If you specify 000000 as the prerequisite version parameter, JP1/Software Distribution Client unconditionally distributes the package, regardless of the prerequisite version.

If this parameter specification does not exist in neither packaging-information file nor -V option, JP1/Software Distribution Client assumes blanks and distributes the package of resources without checking the prerequisite version.

-vversion ~ <uppercase alphabetic characters, numerics, or slants>((1 to 6 characters))

Specify the version of the package you want to register.

The version specified in the -v option has priority over the corresponding specification in the packaging-information file. If you omit the -v option, the specification in the packaging-information file is effective.

packaging-information-file-name

Specify the absolute or relative pathname of the packaging-information file. For packaging of user data and user programs, if you omit specifying the packaging-information file parameter, user resource path parameter, and user resource path file parameter, JP1/Software Distribution Client assumes the following path of the packaging-information file as appropriate:

/NETMRDS/UPUPL/AC000000 (other than HP-UX)

/var/opt/NETMDMW/UPUPL/AC000000 (HP-UX)

If you do not use the packaging-information file, when you enter the command for packaging, always specify the following option(s) as appropriate:

For packaging of program products
-gcabinet-ID

For packaging of user data and user programs
-gcabinet-ID
-rpackage-ID

End code

End code Meaning

0 or 1 Terminated normally.

2 Free disk space is insufficient. Delete unnecessary files. If the space is still insufficient even after deleting unnecessary files on relay systems, initialize the temporary package storehouse by means of either of the following commands:

rdsft -init

rdsclr

3 Interface is invalid. Review the settings file or packaging-information file.

4 System error occurred. Contact system administrator.

5 Communication error occurred. Contact system administrator.

6 Internal error occurred. Contact system administrator.

7 Activation impossible. Contact system administrator.

8 Packaging of the same package ID has already been done or packaging of the same package ID for the same group is now being done from another terminal. In the former case, review the packaging-information file or delete the package registered by previous packaging. In the latter case, re-execute the command after a while.

9 An invalid package has been registered. Delete the invalid package.

10 Number of registered packages exceeds the limit. Contact the system administrator of the managing server.

11 Packaging is now being done from another terminal. Re-execute the command after a while.

End code	Meaning
0 or 1	Terminated normally.
2	Free disk space is insufficient. Delete unnecessary files. If the space is still insufficient even after deleting unnecessary files on relay systems, initialize the temporary package storehouse by means of either of the following commands: rdsft -init rdsclr
3	Interface is invalid. Review the settings file or packaging-information file.
4	System error occurred. Contact system administrator.
5	Communication error occurred. Contact system administrator.
6	Internal error occurred. Contact system administrator.
7	Activation impossible. Contact system administrator.
8	Packaging of the same package ID has already been done or packaging of the same package ID for the same group is now being done from another terminal. In the former case, review the packaging-information file or delete the package registered by previous packaging. In the latter case, re-execute the command after a while.
9	An invalid package has been registered. Delete the invalid package.
10	Number of registered packages exceeds the limit. Contact the system administrator of the managing server.
11	Packaging is now being done from another terminal. Re-execute the command after a while.

Notes

If Transfer package to relay system job requests transference the package with the same package ID as one of the packages stored in the temporary package storehouse, the relay system usually does not store the transferred packages. If, however, the Transfer package to relay system job is forcible, JP1/Software Distribution Client stores the transferred packages.

If the distribution job requests distribution of the package with the same package ID as one of the packages installed in your own UNIX machine, JP1/Software Distribution Client usually does not install distributed packages. If, however, the distribution job is forcible, JP1/Software Distribution Client installs distributed packages.

If you have specified a host file when entering the command for remote installation, JP1/Software Distribution Client also uses the host file when sending the result of distribution. Keep the host file saved until JP1/Software Distribution Client has completed the sending of the result of distribution.

If you do not set PROHIBITPATH=NO in the operating-environment settings file, you cannot specify /, /ofis, /usr, or /etc as the user resource path for packaging user data or user programs. You may specify one directory or file under these directories (/etc/hosts, /etc/passwd, etc.), but you cannot specify a file or a special file directly under the root directory.

As the user resource path parameter, you cannot specify the absolute path of /NETMRDS/UPUPL/hd (other than HP-UX) or /var/opt/NETMDMW/UPUPL/hd (HP-UX).

When you specify a directory as the user resource path, make sure that the length of the file names under the directory does not exceed 128 bytes.

[Contents][Back][Next]

[Trademarks]