clcmd Command

Purpose

Takes an AIX® command and distributes it to a set of nodes that are members of a cluster.

Syntax

clcmd [ -n clustername] [ -m nodename [,...]] [ File ]

Description

The AIX operating system can operate in a single node or multinode configuration. A multinode configuration of the AIX operating system is a cluster configuration.

Using the AIX system management commands (such as the mkuser command, mkvg command, and lslv command), a system administrator can perform operations on the characteristics and functional definitions such as devices, file systems, and user management attributes. These system management commands can be run in a local sphere or in a cluster sphere.

In a cluster configuration, running an AIX command produces a distribution of the AIX command to all nodes participating in the cluster. Thus, an AIX system administrator can manage a group of nodes as a single object.

The enablement of AIX commands for cluster awareness has the following characteristics:

  • Determines the target nodes for the AIX command
  • Distributes the AIX command to the target nodes

Flags

Item Description
-n clustername Specifies the name of a cluster to send a command to. All nodes in the cluster receive the command.
-m nodename Specifies the node names to send a command to. The nodes must be members of a cluster. This allows the distribution of the command to a subset of nodes in a cluster.

Examples

  1. To send the ps command to the oscar-test-dev1 and oscar-test-dev2 nodes in the clusterabc cluster, enter the following command:
    clcmd -n clusterabc -m oscar-test-dev1,oscar-test-dev2 -- /usr/bin/ps

Files

Item Description
/path/to/localcmd <localcmd_options> A qualified file specification used to specify the command to run. The <localcmd_options> list contains the options relevant to the command being run.