6.0 HP StorageWorks X9000 File Serving Software CLI Reference (TA768-96040, October 2011)

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 management console 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 management console. When
contacted, the management console 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
management console 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 management console 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 73