NAME

rspconfig - remote power control of nodes

SYNOPSIS

rspconfig [-h|--help|-v|--version]

BMC/MPA specific:

rspconfig noderange {alert|snmpdest|community}

rspconfig noderange alert={on|enable|off|disable}

rspconfig noderange snmpdest=snmpmanager-IP

rspconfig noderange community={public|string}

BMC specific:

rspconfig noderange {ip|netmask|gateway|backupgateway|garp}

rspconfig noderange garp={time}

MPA specific:

rspconfig noderange {sshcfg|snmpcfg|pd1|pd2|network|swnet|ntp|textid|frame}

rspconfig noderange sshcfg={enable|disable}

rspconfig noderange snmpcfg={enable|disable}

rspconfig noderange pd1={nonred|redwoperf|redwperf}

rspconfig noderange pd2={nonred|redwoperf|redwperf}

rspconfig noderange network={[ip],[host],[gateway],[netmask]|*}

rspconfig noderange textid={*|textid}

rspconfig singlenode frame={frame_number}

rspconfig noderange frame={*}

rspconfig noderange swnet={[ip],[gateway],[netmask]}

rspconfig noderange ntp={[ntpenable],[ntpserver],[frequency],[v3]}

FSP specific:

rspconfig noderange {autopower|iocap|decfg|memdecfg|procdecfg|time|date|spdump|sysdump|network}

rspconfig noderange autopower={enable|disable}

rspconfig noderange iocap={enable|disable}

rspconfig noderange time={hh:mm:ss}

rspconfig noderange date={mm:dd:yyyy}

rspconfig noderange decfg={enable|disable:policyname,...}

rspconfig noderange procdecfg={configure|deconfigure:processingunit:id,...}

rspconfig noderange memdecfg={configure|deconfigure:processingunit:unit|bank:id,...>}

rspconfig noderange network={nic,*}

rspconfig noderange network={nic,[IP,][hostname,][gateway,][netmask]}

rspconfig noderange network={nic,0.0.0.0}

BPA Specific:

rspconfig noderange {network}

rspconfig noderange network={nic,*}

rspconfig noderange network={nic,[IP,][hostname,][gateway,][netmask]}

rspconfig noderange network={nic,0.0.0.0}

HMC Specific:

rspconfig noderange {sshcfg}

rspconfig noderange sshcfg={enable|disable}

DESCRIPTION

rspconfig configures various settings in the nodes' service processors. If only a keyword is specified, without the =, it displays the current value.

OPTIONS

alert={on|enable|off|disable}: Turn on or off SNMP alerts.
autopower={enable|disable}: Select the policy for auto power restart. If enabled, the system will boot automatically once power is restored after a power disturbance.
backupgateway: Get the BMC backup gateway ip address.
community={public|string}: Get or set the SNMP commmunity value. The default is public.
date={mm:dd:yyy}: Enter the current date.
decfg={enable|disable:policyname,...}: Enables or disables deconfiguration policies.
frame={framenumber|*}: Set or get frame number. If no framenumber and * specified, framenumber for the nodes will be displayed and updated in xCAAT database. If framenumber is specified, it only support single node and the framenumber will be set for that frame. If * is specified, it supports noderange and all the frame numbers for the noderange will be read from xCAT database and set to frames.
frequency: The NTP update frequency (in minutes).
garp=time: Get or set Gratuitous ARP generation interval. The unit is number of 1/2 second.
gateway: The gateway ip address.
iocap={enable|disable}: Select the policy for I/O Adapter Enlarged Capacity. This option controls the size of PCI memory space allocated to each PCI slot.
ip: The ip address.
memdecfg={configure|deconfigure:processingunit:unit|bank:id,...}: Select whether each memory bank should be enabled or disabled. State changes take effect on the next platform boot.
netmask: The subnet mask.
network={[ip],[host],[gateway],[netmask]|*}: For MPA only. Get or set the MPA network parameters. If '*' is specified, all parameters are read from the xCAT database.
network={nic,{[ip],[host],[gateway],[netmask]}|*}: For FSP/BPA only. Get or set the FSP/BPA network parameters. If '*' is specified, all parameters are read from the xCAT database. If the value of ip is '0.0.0.0', this nic will be configured as a DHCP client. Otherwise this nic will be configured with a static IP.; Note that IPs of FSP/BPAs will be updated with this option, user needs to put the new IPs to /etc/hosts manually or with xCAT command makehosts. For more details, see the man page of makehosts.
nonred: Allows loss of redundancy.
ntp={[ntpenable],[ntpserver],[frequency],[v3]}: Get or set the MPA Network Time Protocol (NTP) parameters.
ntpenable: Enable or disable NTP (enable|disable).
ntpserver: Get or set NTP server IP address or name.
pd1={nonred|redwoperf|redwperf}: Power Domain 1 - determines how an MPA responds to a loss of redundant power.
pd2={nonred|redwoperf|redwperf}: Power Domain 2 - determines how an MPA responds to a loss of redundant power.
procdecfg={configure|deconfigure:processingunit:id,...}: Selects whether each processor should be enabled or disabled. State changes take effect on the next platform boot.
redwoperf: Prevents components from turning on that will cause loss of power redundancy.
redwperf: Power throttles components to maintain power redundancy and prevents components from turning on that will cause loss of power redundancy.
snmpcfg={enable|disable}: Enable or disable SNMP on MPA.
snmpdest=snmpmanager-IP: Get or set where the SNMP alerts should be sent to.
spdump: Performs a service processor dump.
sshcfg={enable|disable}: Enable or disable SSH on MPA.
swnet={[ip],[gateway],[netmask]}: Set the Switch network parameters.
sysdump: Performs a system dump.
time={hh:mm:ss}: Enter the current time in UTC (Coordinated Universal Time) format.
textid={*|textid}: Set the blade or MPA textid. When using '*', the textid used is the node name specified on the command-line. Note that when specifying an actual textid, only a single node can be specified in the noderange.
v3: Enable or disable v3 authentication (enable|disable).
-h|--help: Prints out a brief usage message.
-v, --version: Display the version number.

EXAMPLES

To turn on SNMP alerts for node5:

rspconfig node5 alert=on
```
 node5: Alerts: enabled
```
To display the destination setting for SNMP alerts for node4:

rspconfig node4 snmpdest
```
 node4: BMC SNMP Destination 1: 9.114.47.227
```
To display the frame number for frame 9A00-10000001

rspconfig 9A00-10000001 frame
```
 9A00-10000001: 1
```
To set the frame number for frame 9A00-10000001

rspconfig 9A00-10000001 frame=2
```
 9A00-10000001: SUCCESS
```
To set the frame numbers for frame 9A00-10000001 and 9A00-10000002

rspconfig 9A00-10000001,9A00-10000002 frame=*
```
 9A00-10000001: SUCCESS
 9A00-10000002: SUCCESS
```

To display the MPA network parameters for mm01:

rspconfig mm01 network

 mm01: MM IP: 192.168.1.47
 mm01: MM Hostname: MM001125C31F28
 mm01: Gateway: 192.168.1.254
 mm01: Subnet Mask: 255.255.255.224

To change the MPA network parameters with the values in the xCAT database for mm01:

rspconfig mm01 network=*

 mm01: MM IP: 192.168.1.47
 mm01: MM Hostname: mm01
 mm01: Gateway: 192.168.1.254
 mm01: Subnet Mask: 255.255.255.224

To change only the gateway parameter for the MPA network mm01:

rspconfig mm01 network=,,192.168.1.1,
```
 mm01: Gateway: 192.168.1.1
```

To display the FSP network parameters for fsp01:

rspconfig fsp01 network

 fsp01:
        eth0:
                IP Type: Dynamic
                IP Address: 192.168.1.215
                Hostname:
                Gateway:
                Netmask: 255.255.255.0

        eth1:
                IP Type: Dynamic
                IP Address: 192.168.200.51
                Hostname: fsp01
                Gateway:
                Netmask: 255.255.255.0

To change the FSP network parameters with the values in command line for eth0 on fsp01:

rspconfig fsp01 network=eth0,192.168.1.200,fsp01,,255.255.255.0
```
 fsp01: Success to set IP address,hostname,netmask
```
To change the FSP network parameters with the values in the xCAT database for eth0 on fsp01:

rspconfig fsp01 network=eth0,*
```
 fsp01: Success to set IP address,hostname,gateway,netmask
```
To configure eth0 on fsp01 to get dynamic IP address from DHCP server:

rspconfig fsp01 network=eth0,0.0.0.0
```
 fsp01: Success to set IP type to dynamic.
```
To get the current power redundancy mode for power domain 1 on mm01:

rspconfig mm01 pd1
```
 mm01: Redundant without performance impact
```
To change the current power redundancy mode for power domain 1 on mm01 to non-redundant:

rspconfig mm01 pd1=nonred
```
 mm01: nonred
```
To enable NTP with an NTP server address of 192.168.1.1, an update frequency of 90 minutes, and with v3 authentication enabled on mm01:

rspconfig mm01 ntp=enable,192.168.1.1,90,enable
```
 mm01: NTP: disabled
 mm01: NTP Server: 192.168.1.1
 mm01: NTP: 90 (minutes)
 mm01: NTP: enabled
```
To disable NTP v3 authentication only on mm01:

rspconfig mm01 ntp=,,,disable
```
 mm01: NTP v3: disabled
```
To disable Predictive Failure and L2 Failure deconfiguration policies on mm01:

rspconfig mm01 decfg=disable:predictive,L3
```
 mm01: Success
```
To deconfigure processors 4 and 5 of Processing Unit 0 on mm01:

rspconfig mm01 procedecfg=deconfigure:0:4,5
```
 mm01: Success
```
To deconfigure memory bank 9 and 10 of Processing Unit 0 on mm01:

rspconfig mm01 memdecfg=deconfigure:bank:0:9,10
```
 mm01: Success
```