HP Instant Capacity Version 10.x User Guide (5900-1581, March 2011)

icapmanage(1M)
NAME
icapmanage -- Global Instant Capacity (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 -T <hostlist> [-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>
DESCRIPTION
A Global Instant Capacity (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 any HP-UX system that runs Instant Capacity
software but has not itself had 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 should
become unusable for any reason.
Because the members of a group are partitionable complexes and GiCAP must be able to contact
all of the partitions, 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
using 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.
125