chcosi Command

Purpose

Manages a Common Operating System Image (COSI).

Syntax

To install software:

chcosi -i -s Source [-fFileset | -b installp_bundle | -F Fixes | -B fix_bundle] [-c] [-R] [-v] COSI

To update software:

chcosi -u -s Source [-fFileset | -b installp_bundle | -F Fixes | -B fix_bundle] [-c] [-R] [-v] COSI

To reject software:

chcosi -j [-fFileset | -b installp_bundle | -F Fixes | -B fix_bundle] [-R] [-v] COSI

To remove software:

chcosi -r {-fFileset | -b installp_bundle | -F Fixes | -B fix_bundle} [-R] [-v] COSI

To remove software:

chcosi -u [-fFileset | -b installp_bundle | -F Fixes | -B fix_bundle] [-R] [-v] COSI

Description

The chcosi command manages a Common Operating System Image (COSI) created from the mkcosi command. Management tasks include installing, updating, rejecting, removing, and committing the software on the common image.

For installing and updating software on a common image, the required Source parameter specifies where the command gets installable images. The particular installable images are taken from the -f, -b, -F, -B flag and parameters. For the install, update, reject, and commit operations, if the -f, -b, -F, -B flags and parameters are not specified, the operation uses an assume-all value. So if the operation is an install or an update, all images from the source are used in the operation. If the operation is a reject or a commit, all software is committed or rejected from the common image. If the -c flag is specified with the install or update operation, the software is committed instead of applied. If a common image to be managed is being used by thin servers, a clone is created from the common image and the manage operation is performed on the clone image. The naming convention for the clone is the original common image name with the suffix _X{count}, where count is a number that is incremented every time a common image is cloned.

The chcosi command depends on the bos.sysmgt.nim.master fileset being present on the system. This command fails to execute if the mkcosi command is not run first to create a common image for managing.

Flags

Item	Description
-b installp_bundle	Specifies an installp_bundle NIM resource to be performed against the common image.
-B fix_bundle	Specifies a fix_bundle NIM resource to be performed against the common image.
-c	Specifies that the software to be installed or updated on the common image is put in the COMMIT state.
-f Fileset	Specifies a list of filesets to be performed against the common image.
-F Fixes	Specifies a list of fixes to be performed against the common image.
-i	Specifies the software to be installed.
-j	Specifies the software to be rejected.
-r	Specifies the software to be removed.
-R	Specifies the operation that is applied to requisite software.
-s Source	Specifies the source for common image management. The source can be an lpp_source, a device with installable media, a directory to installable images, or a remote location to installable images.
-u	Specifies the software to be updated or committed.
-v	Enables verbose debug output when the chcosi command runs.

Exit Status

Item	Description
0	The command completed successfully.
>0	An error occurred.

Security

Access Control: You must have root authority to run the chcosi command.

Examples

To install csm.core software from a CD-ROM onto a common image named cosi1, enter:
```
chcosi -i -s cd0 -f csm.core cosi1 
```
The csm.core fileset is installed on the cosi1 common image, and the fileset is placed in an APPLIED state.

Location

/usr/sbin/chcosi

Files

Item	Description
/etc/niminfo	Contains variables used by NIM.