6.1 HP IBRIX X9000 Network Storage System CLI Reference (TA768-96057, June 2012)

ibrix_hostgroup
Creates and manages hostgroups.
Description
A hostgroup is a named set of X9000 clients. Hostgroups provide a convenient way to centrally
manage clients. Group-wide procedures include:
• Mounting file systems.
• Preferring or unpreferring a network interface for a hostgroup. (You can locally override the
preference on individual X9000 clients with ibrix_lwhost.)
• Tuning host parameters.
• Setting allocation policies.
When ibrix_mount, ibrix_host_tune, or ibrix_fs_tune is executed on a hostgroup,
the command is stored on the Fusion Manager for each X9000 client until the next time a X9000
client contacts it. This happens when the X9000 client reboots, when X9000 software services
start on the X9000 client, or when it is forced to query the Fusion Manager. When contacted, the
Fusion Manager replies to the X9000 clients with information about commands that have been
executed on hostgroups to which they belong. The X9000 clients then use this information to mount
file systems or implement host tunings or allocation policy settings.
To force a query on a X9000 client, execute ibrix_lwmount -a if you executed ibrix_mount
or ibrix_fs_tune on the hostgroup, or run ibrix_lwhost --a if you executed
ibrix_host_tune.
All X9000 clients belong to the default clients hostgroup, which can be used to globally mount
file systems, tune hosts, or set allocation policy. To perform different actions on different sets of
X9000 clients, create additional hostgroups and assign X9000 clients to them. This involves creating
a hostgroup tree whose root element is the clients hostgroup. Each hostgroup in a tree can
have exactly one parent, and a parent can have multiple children. To create the first level of nodes
beneath the root, execute ibrix_hostgroup -c -g GROUPNAME. To create subsequent levels
of nodes, execute ibrix_hostgroup -c -g GROUPNAME -p PARENT.
After creating a hostgroup, assign X9000 clients to it. You can do this manually or have the Fusion
Manager automatically assign the clients when they are registered. To set up automatic hostgroup
assignments, define a domain rule for hostgroups. A domain rule restricts hostgroup membership
to X9000 clients on a particular cluster subnet. The Fusion Manager uses the IP address that you
specify for X9000 clients when you register them to perform a subnet match and sort the X9000
clients into hostgroups based on domain rules. Setting domain rules on hostgroups thus provides
a convenient way to centrally manage mounting, tuning, and allocation policies on different subnets
of X9000 clients.
In a hostgroups tree, operations performed on lower-level nodes take precedence over operations
performed on higher-level nodes. This means that you can effectively establish global X9000 client
mounts, host tunings, and allocation policies and then override them for specific hostgroups.
Synopsis
Create a hostgroup tree:
ibrix_hostgroup -c -g GROUPNAME [-D DOMAIN] [-p PARENT]
To create one level of hostgroups beneath the root clients hostgroup, execute the command
once for every hostgroup that you want to add, but omit the -p PARENT option.
To create additional levels of hostgroups, execute the command for each hostgroup to be added
and include the -p PARENT option.
To set a domain rule on a hostgroup, include the -D DOMAIN option.
ibrix_hostgroup 81