Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP XC System Software: Installation Guide > Appendix G Using the cluster_config Command-Line Menu

Customize Service and Client Configurations

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

The cluster_config utility enables you to add customized services to one or more nodes. The function of these customized services and where you locate them is entirely up to you and is outside the scope of this document. Customizing services configuration is intended for expert HP XC users; this feature is typically not required or intended for the typical HP XC system.

From the command-line menu of the cluster_config utility, enter the letter p to continue the system configuration process.

[L]ist Nodes, [M]odify Nodes, [A]nalyze, [H]elp, [P]roceed, [Q]uit: p

The following prompt appears:

[S]ervices Config, [P]roceed, [Q]uit:

Do one of the following:

  • Enter the letter s to perform customized services configuration on the nodes in the system. This option is intended for experienced HP XC administrators who want to customize service servers and clients. Intervention like this is typically not required for HP XC systems. See “Services Configuration Commands” for information about each services configuration command.

  • Enter the letter p to continue with the system configuration process.

  • Enter the letter q to exit services configuration and return to the previous menu.

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

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

svcs> wipe
[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:

svcs> help
[b]ack

Returns to the previous menu.

Sample use:

svcs> back

 

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2003 Hewlett-Packard Development Company, L.P.