mkcosi Command

Purpose

Makes a Common Operating System Image (COSI) for use with thin servers.

Syntax

mkcosi -s Source [-l Location] [-S Server] [-v] COSI

Description

The mkcosi command creates a Common Operating System Image (COSI). A COSI is a repository that contains all the necessary software to bring a thin server up to a functional state. The mkcosi command takes a source (-s Source) containing installable images and attempts to install those software images into a specific location (-l Location). If the -S Server is specified, the COSI image is stored on that particular server. The result is an OS image that can be used by thin servers as its boot image and operating system.

This command is dependent upon the bos.sysmgt.nim.master fileset being present on the system. When this command is executed for the first time, the machine executing the command is configured as a NIM master. The mkcosi command uses the nim_master_setup command to configure the machine as a NIM master. The -S parameter must point to a machine that is managed by the caller of the mkcosi command.

Flags

Item	Description
-l	Specifies the full path name to a location for storing the COSI.
-S Server	Specifies the name of the machine where the COSI image resides.
-s Source	Specifies the source of installable images to be used in creating the COSI. The source can be an lpp_source, a device with installable media, a directory to installable images, or a remote location to installable images.
-v	Enables verbose debug output when the mkcosi 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 mkcosi command.

Examples

To define a COSI named cosi1 from a CD-ROM cd0, and to store it at the location /export/cosi1, enter the following command:
```
mkcosi -s cd0 -l /export/cosi1 cosi1
```

Location

/usr/sbin/mkcosi

Files

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