Services Configuration Commands |
 |
The way to affect the services configuration of the nodes
in the HP XC system is by setting node attributes in
the configuration and management database. Node attribute names are an identifier
consisting of letters, followed by letters, digits, periods, and underscores,
up to a maximum of 64 characters. The services configuration option of the cluster_config utility
provides an interface that enables you to manipulate node attributes in the
database.
Individual nodes can be disabled as servers or disabled
as clients of specific services. You must create a node attribute before
you can add it to a node.
The following services configuration commands are available:
[S]ervices Config, [P]roceed, [Q]uit: s
Commands are:
[l]ist - List by attribute
[n]odes - List by node
[c]reate attr - Create new attribute
[d]estroy attr - Destroy existing attribute
[a]dd attr node(s) - Add attribute to node(s)
[r]emove attr node(s) - Remove attribute from node(s)
[w]ipe - Remove/destroy all attributes
[s]ervices - List service assignments
[h]elp - Show help
[b]ack - End services config, return to cluster_config
Examples:
create na_disable_server.cmf
add na_disable_server.cmf n1 n4
remove na_disable_client.supermond n3
destroy na_disable_client.supermond
svcs> |
Command Syntax
The following list contains examples of command syntax:
Create a node attribute (na) to disable
a node or nodes as a server of the named service:
svcs> create na_disable_server.service_name |
Create a node attribute to disable a node or nodes as a client
of the named service:
svcs> create na_disable_client.service_name |
Example: Disable a Server from Serving
a Service
To disable node n3 as a server of the cmf service,
add the node attribute na_disable_server.cmf to node n3.
This is how you could remove one of several nodes from the list of cmf servers
if you wanted that specific node not to serve that service, even though it
was configured to do so by default.
Example: Disable a Client
Similarly, to disable node n1 as a client
of the supermond service, enter the node attribute na_disable_client.supermond to
the affected node. In this instance, it is not the server but a client of
the service that is affected.
Creating and Adding Node Attributes
Using the previous two examples, enter the following commands
to create and add node attributes:
svcs> create na_disable_server.cmf
Attribute "na_disable_server.cmf" created
svcs> create na_disable_client.supermond
Attribute "na_disable_client.supermond" created
svcs> add na_disable_server.cmf n3
Attribute "na_disable_server.cmf" added to n3
svcs> add na_disable_client.supermond n1
Attribute "na_disable_client.supermond" added to n1
svcs> |
Service Configuration Command Descriptions
Table G-4 provides
more information about the services configuration commands. All commands are
invoked from the svcs> prompt.
Table G-4 Service Configuration Command Descriptions
| Command | Description and Sample Use |
|---|
| [l]ist | Displays user-created node attribute and attribute
assignments sorted by attribute name. Sample use: svcs> list
Attributes:
na_disable_client.supermond
na_disable_server.cmf
Assignments:
na_disable_client.supermond:
n1
na_disable_server.cmf:
n3 |
|
| [n]odes | Displays user-created node attribute and attribute
assignments sorted by node name. Sample use: svcs> list
Attributes:
na_disable_client.supermond
na_disable_server.cmf
Assignments:
n1:
na_disable_client.supermond
n3:
na_disable_server.cmf |
|
| [c]reate attribute_name | Creates a new node attribute with a specific
name. You must create an attribute before it can be added to one or more
nodes. You will receive an error if you try to create an attribute that already
exists. Sample use: svcs> create na_disable_server.cmf |
|
| [d]estroy attribute_name | Destroys an existing attribute with a specific
name; it is the opposite of the create function. All occurrences
of this attribute on a node or nodes are removed as well. You will receive
an error if you try to destroy an attribute that does not exist. Sample
use: svcs> destroy na_disable_server.cmf |
|
| [a]dd attribute_name node|node_list | Adds a node attribute to a specific
node or node list. The attribute must have been created previously. Node
lists can take two forms: explicit (such as n1, n2, n3, n5) or condensed (such as n[1–3,5]) In
the node list examples, the node prefix is the letter n.
Replace n with the node-naming prefix you chose for your
nodes. Sample use: svcs> add na_disable_client.supermond n1 |
|
| [r]emove attribute_name node|node_list | Removes a node attribute from a specific
node or nodes; remove is the opposite of the add function.
To remove an attribute, the attribute must already exist, and the specified
node or nodes must be assigned with the attribute. Sample use: svcs> remove na_disable_client.supermond n3 |
|
| [w]ipe | Destroys all attributes in the configuration and
management database. Use this command with extreme caution (if at all) because
it removes essential node attributes and attribute additions to nodes that
are needed for proper system operation. Take note of any attributes provided
by the HP XC System Software before issuing a wipe command so that you
can restore them afterwards. Sample use: |
| [s]ervices | Displays node to service mappings. Sample
use: svcs> services
Service assignments:
n14: compute_engine gather_data hpasm
hptc_cluster_fs_client iptables lkcd
lvs munge network nis nrpe pdsh
n15: compute_engine gather_data hpasm
hptc_cluster_fs_client iptables lkcd
munge network nrpe pdsh
n16: cmf compute_engine dbserver dhcp
gather_data gmmon hpasm hptc-lm hptc_cluster_fs
hptc_cluster_fs_client httpd imageserver
iptables lkcd lsf mpiic munge nagios
nagios_monitor nat network nfs_server nrpe
nsca ntp pdsh pwrmgmtserver slurm supermond
swmlogger syslogng_forward |
|
| [h]elp | Displays a help message. Sample use: |
| [b]ack | Returns to the previous menu. Sample
use: |