HP Instant Capacity Version 10.x User Guide (762794-001, March 2014)

icapmanage(1M)
NAME
icapmanage -- GiCAP management commands for GiCAP groups.
SYNOPSIS
icapmanage -i -U <rule_file>
icapmanage -C <codeword>
icapmanage -a -g <group_name>
icapmanage -r -g <group_name>
icapmanage -a -m <member_name>:<hostlist> -g <group_name>
icapmanage -r -m <member_name>
icapmanage -s -g <group_name> [-b] [-v]
icapmanage -Q [-n]
icapmanage -R [<hostlist>] [-U <rule_file>]
icapmanage -a -S <host>
icapmanage -r -S <host>
icapmanage -t
icapmanage -u -m <member_name> -h [<hostlist>][!<hostlist>]
icapmanage -x <host>
icapmanage -z <host>
icapmanage -I <IP address>
icapmanage -P -I <IP address>
DESCRIPTION
A GiCAP group consists of a Group Manager system and one or more partitionable complexes
which are the members. The primary purpose of a GiCAP group is to enable group members to
share Instant Capacity usage rights (for cores, cell boards, and memory) and temporary capacity.
A Group Manager has either active or standby status. An active Group Manager coordinates and
monitors resource sharing, has had hardware grouping rules applied, and has had GiCAP sharing
rights purchased for and applied to it. Optionally, an active Group Manager can designate as a
standby Group Manager on any HP-UX system that runs Instant Capacity software but does not
have GiCAP sharing rights applied. The standby Group Manager has the ability to take control
as an active Group Manager if the original active Group Manager becomes unusable for any
reason.
The members of a group are partitionable complexes and GiCAP must be able to contact all of
the partitions, therefore GiCAP members must be defined by specifying a <hostlist> to describe
the host OS instances of all the partitions.
The symbol <hostlist> is a string of one or more host names or IP addresses with the form
<host>[,<host>]...
A host can be a vPar or nPar OS instance, but it cannot be a virtual machine (guest). When you
use HPVM on a prospective GiCAP group member, you must specify the name of the HPVM host
OS instance, not the name of an HPVM guest OS instance.
The icapmanage command, which is used to create, manage, and remove groups, can be invoked
only on a Group Manager system. On a standby Group Manager, only the -Q and -s options
are allowed, all other options are restricted to use only on the active Group Manager. The
icapmanage command should not be invoked on a group member system.
152