inuwpar Command

Purpose

Performs software installation tasks in detached workload partitions.

Syntax

/usr/sbin/inuwpar [ -d directory | -D ] [ -G ] { -A | -f wparnamesfile | -w wparname,... } cmdname [ option ... ]

Description

The inuwpar command performs a software installation or maintenance task on all detached workload partitions (WPARs) or named detached WPARs. A detached workload partition is a system workload partition with a writable /usr file system or a writable /opt file system that is not shared with the global environment.

The inuwpar command operates on workload partitions that can be specified in the following ways:
  • A comma-separated list of workload partitions that are specified by the -w flag.
  • A list of workload partitions (one per line) in the file that is specified by the -f flag.
  • All detached system workload partitions if you specify the -A flag.
If you specify the -G flag, inuwpar runs the installation command first in the global environment.
Restriction: You cannot run the inuwpar command on application workload partitions. You cannot successfully run the inuwpar command on shared system workload partitions that have read-only /usr and /opt file systems unless a relocation path is specified to the command.

If you do not specify the -d or -D flag and the options of the cmdname command contains a -d directory option, the inuwpar command attempts to mount that directory into the workload partition environment as the installation device for the command.

See the Parameters section for all installation commands that can be used with the inuwpar command:

Flags

Item Description
-A Applies the installation command to all detached system workload partitions.
-d directory Specifies the directory in the WPAR where the installation directory is accessible. By default, the directory is mounted from the installation command into a temporary directory within the WPAR file system. If the options of the installation command contain a -d directory option, the directory is used as the installation directory for the command.
-D Specifies that the directory that is used in the installation command is accessible within the WPAR file systems.
-f wparnamesfile Specifies a file containing a list of detached workload partitions to which the installation command is applied.
-G Runs the installation command within the global environment and the detached system workload partitions.
-w wparname,... Specifies one or more detached workload partitions to which the installation command is applied.

Parameters

Item Description
cmdname Specifies the installation command to run. You can specify the following installation commands:
  • geninstall
  • install_all_updates
  • installp
  • instfix
  • update_all
option Specifies the option to be used with the installation command.

Exit Status

Item Description
0 The command was able to run on all applicable workload partitions. The exit value does not mean that the return code of the command that has been run on all workload partitions was necessarily 0.
>0 An error occurred.

Examples

  1. To install the bos.games file set and all of its requisite software from the /mydev directory in the global environment and all detached workload partitions, enter the following command:
    inuwpar -G -A installp -qaXd /mydev bos.games
  2. To install the bos.games file set and all of its requisite software from the /mydev directory in the global environment and the workload partitions that are listed in /tmp/wparlist file , enter the following command:
    inuwpar -G -f /tmp/wparlist installp -qaXd /mydev bos.games
  3. To install all of the file sets that are associated with fix IX38794 from the /mydev directory in workload partitions wpar1 and wpar5, enter the following command:
    inuwpar -w wpar1,wpar5 instfix -k IX38794 -d /mydev
  4. To update installed software to the latest level from /mydev directory in all detached workload partitions, enter the following command:
    inuwpar -A install_all_updates -d /mydev