The icapmanage command can be used to install a grouping rules file, apply a GiCAP sharing rights codeword, create and remove GiCAP groups, test if a server can be added to a GiCAP group, update a GiCAP group by adding or removing members, show grouping rules and supported hardware, seize core usage rights from member partitions of a GiCAP group to be used by another member of the group, restore seized core usage rights to the original member partition, update an existing GiCAP member by adding or removing hosts, set up and activate a standby Group Manager, transfer the GiCAP database to the standby Group Manager, and remove a standby Group Manager.

WBEM version A.02.05 or higher must be installed on the Group Manager, the standby Group Manager (if any), and on all OS instances of all member systems in order to use Global Instant Capacity. Similarly, the CIM Server configuration property sslClientVerificationMode must be set to a value of “optional” on all Group Managers and member OS instances. (The CIM Server may need to be restarted if the property was not previously set to this value.) For details, see cimconfig(1M). Note that communication between the managers and members of groups is established using SSL certificates that are supplied by the GiCAP software.

For a complete overview of Global Instant Capacity, see icap(5), and for more detailed information see the HP Instant Capacity user's guide for Version 10.x located at /usr/share/doc/ icapUserGuide.pdf.

Options

icapmanage recognizes these options and arguments:

-aAdd a GiCAP group, add a member to a group, or designate a system as a standby Group Manager.

 

To create a new group, use the -aoption, along with the

 

-goption to name the new group.

 

To add a member to a GiCAP group, use the -aoption,

 

along with the -moption to specify a member name and

 

list of hostnames, and the -goption to specify the group

 

name. The list of hostnames must contain a representative

 

host for each nPartition or virtual partition of the complex,

 

and each host must be up and the Group Manager must

 

be able to contact it. (To avoid potential problems, the

 

Group Manger should also be able to contact any standby

 

manager that is defined.) To add multiple members to a

 

GiCAP group, you must run icapmanage -a-m-g

 

multiple times; you cannot specify multiple members in a

 

single command.

 

To add a standby Group Manager, use the -aoption, along

 

with the -Soption to identify the host system that is to

 

serve as the standby Group Manager.

-b

Provide brief status information only. Show summary

 

group information without information specific to the

 

Group Manager and the members.

-g<group_name>

Specify a GiCAP group name for a GiCAP operation.

-h

Used with the -uoption to identify hosts to be added to

 

or removed from an existing GiCAP group member's list.

 

A hostlist identifies hosts to be added. A hostlist preceded

 

by an exclamation point (!) identifies hosts to be removed.

 

There must be no intervening blanks within a hostlist, and

 

if both add and remove lists are specified, the entire string

 

must be contiguous.

160