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:
The csm.core fileset is installed on thechcosi -i -s cd0 -f csm.core cosi1cosi1common image, and the fileset is placed in an APPLIED state.
Location
/usr/sbin/chcosi
Files
| Item | Description |
|---|---|
| /etc/niminfo | Contains variables used by NIM. |