Monitoring Commands (N1 Provisioning Server 3.1, Blades Edition, System Administration Guide)

N1 Provisioning Server 3.1, Blades Edition, System Administration Guide

Monitoring Commands

You can use monitoring commands on a command-line interface (CLI) to perform monitoring activities, such as viewing the status of devices, manually registering devices, or troubleshooting. N1 Provisioning Server monitoring software provides the following commands:

cereg
cecmd
mls

Using the `cereg` Monitoring Command

Use the /opt/terraspring/sbin/cereg command to manually register and unregister resource pool servers for monitoring. In normal operation, registration of resource pool servers for monitoring is done automatically at I-Fabric installation time, so you would use this command only in an error or troubleshooting situation. See Chapter 7, Troubleshooting for details and examples on how to use this command.

Command Usage	Description
`-addAllCPDevices`	Registers all devices on the control plane.
`-deleteCPDevice -ipaddr` `IP address`	Deregisters the control plane server from monitoring.
`-deletenode -ipaddr` `IP address` `-netmask` `netmask` `-nodetype` `node type`	Deregisters the resource pool server from monitoring.
`-addnode -ipaddr` `IP address` `-netmask` `netmask` `-nodetype` `node type`	Adds a resource pool server for monitoring.

Using the `cecmd` Monitoring Command

Use the /opt/terraspring/sbin/cecmd command to do one of the following:

Configure an interface
Shut down a resource pool server
Back up a resource pool server

This command is typically used in an error or troubleshooting situation. See Chapter 7, Troubleshooting for details and examples on how to use this command.

Command Usage	Description
`-addipinterface` `-ipAddress` `IPaddress` `-waitTime` `wait-time` `-mac` `MAC-address` `-vlanId` `VLAN-ID` `-ip` `IP-address` `-netMask` `netmask`	Adds an interface to the resource pool server specifying the following information: IP address of the resource pool server Timeout for DHCP MAC address of the interface VLAN ID of the interface
`-deleteipinterface` `-ipAddress` `IP- address` `-waitTime` `wait-time` `-mac` `MAC-address` `-vlanId` `VLAN-ID` `-ip` `IP-address` `-netMask` `netmask`	Deletes an interface from the resource pool server specifying the following: IP address of the resource pool server Timeout for DHCP MAC address of the interface VLAN ID of the interface
`-shutdown-ipAddress` `IP- address` `-nodetype` `node-type`	Shuts down a resource pool server specifying the IP address and the type of server.
`-backup` `-ipAdress` `IP-address` [`-start` \| `-stop`]	Starts or stops the backup of a resource pool server.
`-addgw` `-ipAddress` `IP- address` `-ipaddr` `IP-address`	Adds a gateway to the resource pool server specifying the IP address of the resource pool server and the IP address of the default gateway.
`-cleararp` `-ipAddress` `IP-address`	Clears the ARP table specifying the IP address of the resource pool server.
`-diskChange` `-ipAddress` `IP-address` `-operation` [`-add`\|`-delete`] `-information` [`-channel:target:LUN:size:name`]	Adds or deletes disk information specifying the IP address and disk information, such as the channel, target, and name.
`-clbconf` `-ipAddress` `resource-pool-server-IP- address` `-operation` [`-add`\|`-remove`] `-ipaddr` `load-balancer -IP-address` `-vip` `VIP-address` `-mask` `VIP-netmask` `-vlanid` `load-balancer-VLAN-ID`	Adds or delete a load balancer specifying the following: Resource pool server IP address Load balancer IP address Virtual IP address Netmask VLAN ID

Using the `mls` Monitoring Command

You can execute the /opt/terraspring/sbin/mls monitoring command to view the state of an I-Fabric component, the status of all N1 Provisioning Server agents, or the status of a particular N1 Provisioning Server agent. The mls command is useful for troubleshooting as well as day-to-day monitoring of the health of the system.

Table 4–2 Using the mls Command


Command Usage	Description
`mls -l`	Lists all nodes on the current control plane server.
`mls -all`	Modifies the query scope to the control plane server.
`mls -c`	Lists customer monitoring values for nodes registered on the current control plane server.
`mls -a`	Lists agent status for all registered nodes on the current control plane server.
`mls -x`	Lists the agent version information for the resources controlled by the control plane server.
`mls -f`	Modifies the query scope to a particular farm.
`mls -i`	Modifies the query scope to a particular resource pool server.
`mls -v`	Verbose output.
`mls -d`	Suppresses header information.
`mls -h`	Displays the command's usage information.