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 initiated 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: |