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 will be 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

  1. To define a COSI named cosi1 from a CD-ROM cd0, and to store it at /export/cosil, enter:
    mkcosi —s cd0 -l /export/cosi1 cosi1

Location

/usr/sbin/mkcosi

Files

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