cpcosi Command

Purpose

Clones a Common Operating System Image (COSI).

Syntax

cpcosi -c COSI [-S Server] [-l Location] [-v] COSI

Description

The cpcosi command clones a Common Operating System Image (COSI). A COSI is a repository that contains all the software necessary to bring up a system to a functional state. The mkcosi command creates the COSI.

The cpcosi command takes a common image and attempts to make a duplicate copy of it. The copied version is stored at the location specified with the -l flag. If the -l flag is not specified, the location of the originating common image is used instead. If the -S flag is specified, the clone common image is stored on that particular server. The -S flag must point to a machine that is managed by the caller of the cpcosi command. The naming convention for the clone is the original common image name suffixed with an _X{count}, where count is a number that is incremented every time a common image is cloned.

A common image must exist on the system before it can be cloned. Use the mkcosi command to create a common image. The lscosi command lists any common images that exist in the environment. The lscosi command depends on the bos.sysmgt.nim.master fileset being present on the system.

Flags

Item	Description
-c	Specifies the COSI to clone.
-l Location	Specifies the full path name to a location for storing the COSI.
-S Server	Specifies the name of the machine on which the COSI image will reside.
-v	Enables verbose debug output when the cpcosi 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 cpcosi command.

Examples

To clone a COSI named cosi2 from a COSI named cosi1, enter:
```
cpcosi -c cosi1 cosi2
```
Because no location path was specified in the preceding example, if cosi1 was stored at /export/cosi1, the cloned COSI will be placed in /export/cosi2.

Location

/usr/sbin/cpcosi

Files

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