########### rspconfig.1 ########### .. highlight:: perl **** NAME **** \ **rspconfig**\ - Configures nodes' service processors ******** SYNOPSIS ******** \ **rspconfig**\ [\ **-h | -**\ **-help | -v | -**\ **-version | -V | -**\ **-verbose**\ ] 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 | vlan**\ } \ **rspconfig**\ \ *noderange*\ \ **garp**\ =\ *time*\ OpenBMC specific: ================= \ **rspconfig**\ \ *noderange*\ {\ **ipsrc | ip | netmask | gateway | vlan**\ } \ **rspconfig**\ \ *noderange*\ \ **admin_passwd**\ ={\ *currentpasswd,newpasswd*\ } \ **rspconfig**\ \ *noderange*\ \ **autoreboot**\ \ **rspconfig**\ \ *noderange*\ \ **autoreboot={0|1}**\ \ **rspconfig**\ \ *noderange*\ \ **bootmode**\ \ **rspconfig**\ \ *noderange*\ \ **bootmode={safe|regular|setup}**\ \ **rspconfig**\ \ *noderange*\ \ **dump**\ [\ **-l | -**\ **-list**\ ] [\ **-g | -**\ **-generate**\ ] [\ **-c | -**\ **-clear**\ {\ *id*\ | \ **all**\ }] [\ **-d | -**\ **-download**\ {\ *id*\ | \ **all**\ }] \ **rspconfig**\ \ *noderange*\ \ **gard -c|-**\ **-clear**\ \ **rspconfig**\ \ *noderange*\ \ **ip=dhcp**\ \ **rspconfig**\ \ *noderange*\ \ **hostname**\ \ **rspconfig**\ \ *noderange*\ \ **hostname**\ ={\* | \ *name*\ } \ **rspconfig**\ \ *noderange*\ \ **ntpservers**\ \ **rspconfig**\ \ *noderange*\ \ **ntpservers**\ ={\ *ntpservers*\ } \ **rspconfig**\ \ *noderange*\ \ **powerrestorepolicy**\ \ **rspconfig**\ \ *noderange*\ \ **powerrestorepolicy={always_on|restore|always_off}**\ \ **rspconfig**\ \ *noderange*\ \ **powersupplyredundancy**\ \ **rspconfig**\ \ *noderange*\ \ **powersupplyredundancy={disabled|enabled}**\ \ **rspconfig**\ \ *noderange*\ \ **sshcfg**\ \ **rspconfig**\ \ *noderange*\ \ **thermalmode**\ \ **rspconfig**\ \ *noderange*\ \ **thermalmode={default|custom|heavy_io|max_base_fan_floor}**\ \ **rspconfig**\ \ *noderange*\ \ **timesyncmethod**\ \ **rspconfig**\ \ *noderange*\ \ **timesyncmethod={manual|ntp}**\ MPA specific: ============= \ **rspconfig**\ \ *noderange*\ {\ **sshcfg | snmpcfg | pd1 | pd2 | network | swnet | ntp | textid | frame**\ } \ **rspconfig**\ \ *noderange*\ \ **USERID**\ ={\ **newpasswd**\ } \ **updateBMC**\ ={\ **y | n**\ } \ **rspconfig**\ \ *noderange*\ \ **sshcfg**\ ={\ **enable | disable**\ } \ **rspconfig**\ \ *noderange*\ \ **snmpcfg**\ ={\ **enable | disable**\ } \ **rspconfig**\ \ *noderange*\ \ **solcfg**\ ={\ **enable | disable**\ } \ **rspconfig**\ \ *noderange*\ \ **pd1**\ ={\ **nonred | redwoperf | redwperf**\ } \ **rspconfig**\ \ *noderange*\ \ **pd2**\ ={\ **nonred | redwoperf | redwperf**\ } \ **rspconfig**\ \ *noderange*\ \ **network**\ ={[\ *ip*\ ],[\ *host*\ ],[\ *gateway*\ ],[\ *netmask*\ ]|\*} \ **rspconfig**\ \ *noderange*\ \ **initnetwork**\ ={[\ *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/CEC 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**\ } \ **rspconfig**\ \ *noderange*\ \ **HMC_passwd**\ ={\ *currentpasswd,newpasswd*\ } \ **rspconfig**\ \ *noderange*\ \ **admin_passwd**\ ={\ *currentpasswd,newpasswd*\ } \ **rspconfig**\ \ *noderange*\ \ **general_passwd**\ ={\ *currentpasswd,newpasswd*\ } \ **rspconfig**\ \ *noderange*\ \*\ **_passwd**\ ={\ *currentpasswd,newpasswd*\ } \ **rspconfig**\ \ *noderange*\ {\ *hostname*\ } \ **rspconfig**\ \ *noderange*\ \ **hostname**\ ={\* | \ *name*\ } \ **rspconfig**\ \ *noderange*\ \ **-**\ **-resetnet**\ Flex system Specific: ===================== \ **rspconfig**\ \ *noderange*\ \ **sshcfg**\ ={\ **enable | disable**\ } \ **rspconfig**\ \ *noderange*\ \ **snmpcfg**\ ={\ **enable | disable**\ } \ **rspconfig**\ \ *noderange*\ \ **network**\ ={[\ **ip**\ ],[\ **host**\ ],[\ **gateway**\ ],[\ **netmask**\ ] | \*} \ **rspconfig**\ \ *noderange*\ \ **solcfg**\ ={\ **enable | disable**\ } \ **rspconfig**\ \ *noderange*\ \ **textid**\ ={\* | \ *textid*\ } \ **rspconfig**\ \ *noderange*\ \ **cec_off_policy**\ ={\ **poweroff | stayon**\ } BPA/Frame Specific: =================== \ **rspconfig**\ \ *noderange*\ {\ **network**\ } \ **rspconfig**\ \ *noderange*\ \ **network**\ ={\ **nic,**\ \*} \ **rspconfig**\ \ *noderange*\ \ **network**\ ={\ **nic,[IP,][hostname,][gateway,][netmask]**\ } \ **rspconfig**\ \ *noderange*\ \ **network**\ ={\ **nic,0.0.0.0**\ } \ **rspconfig**\ \ *noderange*\ \ **HMC_passwd**\ ={\ *currentpasswd,newpasswd*\ } \ **rspconfig**\ \ *noderange*\ \ **admin_passwd**\ ={\ *currentpasswd,newpasswd*\ } \ **rspconfig**\ \ *noderange*\ \ **general_passwd**\ ={\ **currentpasswd,newpasswd**\ } \ **rspconfig**\ \ *noderange*\ \*\ **_passwd**\ ={\ **currentpasswd,newpasswd**\ } \ **rspconfig**\ \ *noderange*\ {\ **hostname**\ } \ **rspconfig**\ \ *noderange*\ \ **hostname**\ ={\* | \ *name*\ } \ **rspconfig**\ \ *noderange*\ \ **-**\ **-resetnet**\ FSP/CEC (using Direct FSP Management) Specific: =============================================== \ **rspconfig**\ \ *noderange*\ \ **HMC_passwd**\ ={\ *currentpasswd,newpasswd*\ } \ **rspconfig**\ \ *noderange*\ \ **admin_passwd**\ ={\ *currentpasswd,newpasswd*\ } \ **rspconfig**\ \ *noderange*\ \ **general_passwd**\ ={\ *currentpasswd,newpasswd*\ } \ **rspconfig**\ \ *noderange*\ \*\ **_passwd**\ ={\ *currentpasswd,newpasswd*\ } \ **rspconfig**\ \ *noderange*\ {\ **sysname**\ } \ **rspconfig**\ \ *noderange*\ \ **sysname**\ ={\* | \ *name*\ } \ **rspconfig**\ \ *noderange*\ {\ **pending_power_on_side**\ } \ **rspconfig**\ \ *noderange*\ \ **pending_power_on_side**\ ={\ **temp | perm**\ } \ **rspconfig**\ \ *noderange*\ {\ **cec_off_policy**\ } \ **rspconfig**\ \ *noderange*\ \ **cec_off_policy**\ ={\ **poweroff | stayon**\ } \ **rspconfig**\ \ *noderange*\ {\ **BSR**\ } \ **rspconfig**\ \ *noderange*\ {\ **huge_page**\ } \ **rspconfig**\ \ *noderange*\ \ **huge_page**\ ={\ *NUM*\ } \ **rspconfig**\ \ *noderange*\ {\ **setup_failover**\ } \ **rspconfig**\ \ *noderange*\ \ **setup_failover**\ ={\ **enable | disable**\ } \ **rspconfig**\ \ *noderange*\ {\ **force_failover**\ } \ **rspconfig**\ \ *noderange*\ \ **-**\ **-resetnet**\ BPA/Frame (using Direct FSP Management) Specific: ================================================= \ **rspconfig**\ \ *noderange*\ \ **HMC_passwd**\ ={\ *currentpasswd,newpasswd*\ } \ **rspconfig**\ \ *noderange*\ \ **admin_passwd**\ ={\ *currentpasswd,newpasswd*\ } \ **rspconfig**\ \ *noderange*\ \ **general_passwd**\ ={\ *currentpasswd,newpasswd*\ } \ **rspconfig**\ \ *noderange*\ \*\ **_passwd**\ ={\ *currentpasswd,newpasswd*\ } \ **rspconfig**\ \ *noderange*\ {\ **frame**\ } \ **rspconfig**\ \ *noderange*\ \ **frame**\ ={\* | \ *frame_number*\ } \ **rspconfig**\ \ *noderange*\ {\ **sysname**\ } \ **rspconfig**\ \ *noderange*\ \ **sysname**\ ={\* | \ *name*\ } \ **rspconfig**\ \ *noderange*\ {\ **pending_power_on_side**\ } \ **rspconfig**\ \ *noderange*\ \ **pending_power_on_side**\ ={\ **temp | perm**\ } \ **rspconfig**\ \ *noderange*\ \ **-**\ **-resetnet**\ HMC Specific: ============= \ **rspconfig**\ \ *noderange*\ {\ **sshcfg**\ } \ **rspconfig**\ \ *noderange*\ \ **sshcfg**\ ={\ **enable | disable**\ } \ **rspconfig**\ \ *noderange*\ \ **-**\ **-resetnet**\ *********** DESCRIPTION *********** \ **rspconfig**\ configures various settings in the nodes' service processors. For options \ **autopower | iocap | decfg | memdecfg | procdecfg | time | date | spdump | sysdump | network**\ , user need to use \ *chdef -t site enableASMI=yes*\ to enable ASMI first. ******* 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 community 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 the xCAT database. If framenumber is specified, it only supports 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. Setting the frame number is a disruptive command which requires all CECs to be powered off prior to issuing the command. \ **cec_off_policy**\ ={\ **poweroff | stayon**\ } Set or get cec off policy after lpars are powered off. If no cec_off_policy value specified, the cec_off_policy for the nodes will be displayed. The cec_off_policy has two values: \ **poweroff**\ and \ **stayon**\ . \ **poweroff**\ means Power off when last partition powers off. \ **stayon**\ means Stay running after last partition powers off. If cec_off_policy value is specified, the cec off policy will be set for that cec. \ **HMC_passwd**\ ={\ *currentpasswd,newpasswd*\ } Change the password of the userid \ **HMC**\ for CEC/Frame. If the CEC/Frame is the factory default, the currentpasswd should NOT be specified; otherwise, the currentpasswd should be specified to the current password of the userid \ **HMC**\ for the CEC/Frame. \ **admin_passwd**\ ={\ *currentpasswd,newpasswd*\ } Change the password of the userid \ **admin**\ for CEC/Frame from currentpasswd to newpasswd. If the CEC/Frame is the factory default, the currentpasswd should NOT be specified; otherwise, the currentpasswd should be specified to the current password of the userid \ **admin**\ for the CEC/Frame. \ **general_passwd**\ ={\ *currentpasswd,newpasswd*\ } Change the password of the userid \ **general**\ for CEC/Frame from currentpasswd to newpasswd. If the CEC/Frame is the factory default, the currentpasswd should NOT be specified; otherwise, the currentpasswd should be specified to the current password of the userid \ **general**\ for the CEC/Frame. \*\ **_passwd**\ ={\ *currentpasswd,newpasswd*\ } Change the passwords of the userids \ **HMC**\ , \ **admin**\ and \ **general**\ for CEC/Frame from currentpasswd to newpasswd. If the CEC/Frame is the factory default, the currentpasswd should NOT be specified; otherwise, if the current passwords of the userids \ **HMC**\ , \ **admin**\ and \ **general**\ for CEC/Frame are the same one, the currentpasswd should be specified to the current password, and then the password will be changed to the newpasswd. If the CEC/Frame is NOT the factory default, and the current passwords of the userids \ **HMC**\ , \ **admin**\ and \ **general**\ for CEC/Frame are NOT the same one, this option could NOT be used, and we should change the password one by one. \ **frequency**\ The NTP update frequency (in minutes). \ **gard -c|-**\ **-clear**\ Clear gard file. [OpenBMC] \ **garp**\ =\ *time*\ Get or set Gratuitous ARP generation interval. The unit is number of 1/2 second. \ **gateway**\ The gateway ip address. \ **hostname**\ Display the CEC/BPA system names. \ **BSR**\ Get Barrier Synchronization Register (BSR) allocation for a CEC. \ **huge_page**\ Query huge page information or request NUM of huge pages for CEC. If no value specified, it means query huge page information for the specified CECs, if a CEC is specified, the specified huge_page value NUM will be used as the requested number of huge pages for the CEC, if CECs are specified, it means to request the same NUM huge pages for all the specified CECs. \ **setup_failover**\ ={\ **enable**\ | \ **disable**\ } Enable or disable the service processor failover function of a CEC or display status of this function. \ **force_failover**\ Force a service processor failover from the primary service processor to the secondary service processor. \ **hostname**\ ={\* | \ *name*\ } Set CEC/BPA system names to the names in xCAT DB or the input name. \ **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. \ **hostname**\ Get or set hostname on the service processor. \ **vlan**\ Get or set vlan ID. For get vlan ID, if vlan is not enabled, 'BMC VLAN disabled' will be displayed. For set vlan ID, the valid value are [1-4096]. \ **ipsrc**\ Get the IP source for OpenBMC. \ **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. \ **powerrestorepolicy**\ Display or control BMC Power Restore Policy attribute setting. [OpenBMC] \ **powersupplyredundancy**\ Display or control BMC Power Supply Redundancy attribute setting. [OpenBMC] \ **autoreboot**\ Display or control BMC Auto Reboot attribute setting. [OpenBMC] \ **bootmode**\ Display or control BMC Boot Mode attribute setting. [OpenBMC] \ **dump**\ Generate/Manage BMC system dumps. If no sub-option is provided, will generate, wait, and download the dump. [OpenBMC] \ **-c**\ will clear a single specified dump, or use 'all' to clear all dumps on the BMC. \ **-l**\ will list all the generated dumps on the BMC. \ **-g**\ will generate a new dump on the BMC. Dump generation can take a few minutes. \ **-d**\ will download a single dump or all generated dumps from the BMC to /var/log/xcat/dump on management or service node. \ **thermalmode**\ Display or set the thermal mode of the system to a setting, depending on your system, adapter, and cable type. After a factory reset of the system, the thermal mode setting is lost and must be reapplied. To choose the correct setting for your system, see https://www.ibm.com/support/knowledgecenter/POWER9/p9ei3/p9ei3_thermal_mode.htm [OpenBMC] \ **timesyncmethod**\ Set the method for time synchronization on the BMC. [OpenBMC] \ **network**\ ={[\ *ip*\ ],[\ *host*\ ],[\ *gateway*\ ],[\ *netmask*\ ]|\*} For MPA: get or set the MPA network parameters. If '\*' is specified, all parameters are read from the xCAT database. For FSP of Flex system P node: set the network parameters. If '\*' is specified, all parameters are read from the xCAT database. \ **initnetwork**\ ={[\ *ip*\ ],[\ *host*\ ],[\ *gateway*\ ],[\ *netmask*\ ]|\*} For MPA only. Connecting to the IP of MPA from the hosts.otherinterfaces to set the MPA network parameters. If '\*' is specified, all parameters are read from the xCAT database. \ **network**\ ={\ *nic*\ ,{[\ *ip*\ ],[\ *host*\ ],[\ *gateway*\ ],[\ *netmask*\ ]}|\*} Not only for FSP/BPA but also for IMM. Get or set the FSP/BPA/IMM 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. \ **ntpservers**\ Get or set NTP servers name. [OpenBMC] \ **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. \ **solcfg**\ ={\ **enable | disable**\ } Enable or disable the sol on MPA (or CMM) and blade servers belongs to it. \ **spdump**\ Performs a service processor dump. \ **sshcfg**\ ={\ **enable | disable**\ } Enable or disable SSH on MPA. \ **sshcfg**\ Copy SSH keys. \ **swnet**\ ={[\ *ip*\ ],[\ *gateway*\ ],[\ *netmask*\ ]} Set the Switch network parameters. \ **sysdump**\ Performs a system dump. \ **sysname**\ Query or set sysname for CEC or Frame. If no value specified, means to query sysname of the specified nodes. If '\*' specified, it means to set sysname for the specified nodes, and the sysname values would get from xCAT database. If a string is specified, it means to use the string as sysname value to set for the specified node. \ **pending_power_on_side**\ ={\ **temp|perm**\ } List or set pending power on side for CEC or Frame. If no pending_power_on_side value specified, the pending power on side for the CECs or frames will be displayed. If specified, the pending_power_on_side value will be set to CEC's FSPs or Frame's BPAs. The value 'temp' means T-side or temporary side. The value 'perm' means P-side or permanent side. \ **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. \ **USERID**\ ={\ *newpasswd*\ } \ **updateBMC**\ ={\ **y|n**\ } Change the password of the userid \ **USERID**\ for CMM in Flex system cluster. The option \ *updateBMC*\ can be used to specify whether updating the password of BMCs that connected to the specified CMM. The value is 'y' by default which means whenever updating the password of CMM, the password of BMCs will be also updated. Note that there will be several seconds needed before this command complete. If value "\*" is specified for USERID and the object node is \ *Flex System X node*\ , the password used to access the BMC of the System X node through IPMI will be updated as the same password of the userid \ **USERID**\ of the CMM in the same cluster. \ **-**\ **-resetnet**\ Reset the network interfaces of the specified nodes. \ **v3**\ Enable or disable v3 authentication (enable|disable). \ **-h | -**\ **-help**\ Prints out a brief usage message. \ **-v**\ | \ **-**\ **-version**\ Display the version number. ******** EXAMPLES ******** 1. To setup new ssh keys on the Management Module mm: .. code-block:: perl rspconfig mm snmpcfg=enable sshcfg=enable 2. To turn on SNMP alerts for node5: .. code-block:: perl rspconfig node5 alert=on Output is similar to: .. code-block:: perl node5: Alerts: enabled 3. To display the destination setting for SNMP alerts for node4: .. code-block:: perl rspconfig node4 snmpdest Output is similar to: .. code-block:: perl node4: BMC SNMP Destination 1: 9.114.47.227 4. To display the frame number for frame 9A00-10000001 .. code-block:: perl rspconfig> 9A00-10000001 frame Output is similar to: .. code-block:: perl 9A00-10000001: 1 5. To set the frame number for frame 9A00-10000001 .. code-block:: perl rspconfig 9A00-10000001 frame=2 Output is similar to: .. code-block:: perl 9A00-10000001: SUCCESS 6. To set the frame numbers for frame 9A00-10000001 and 9A00-10000002 .. code-block:: perl rspconfig 9A00-10000001,9A00-10000002 frame=* Output is similar to: .. code-block:: perl 9A00-10000001: SUCCESS 9A00-10000002: SUCCESS 7. To display the MPA network parameters for mm01: .. code-block:: perl rspconfig mm01 network Output is similar to: .. code-block:: perl mm01: MM IP: 192.168.1.47 mm01: MM Hostname: MM001125C31F28 mm01: Gateway: 192.168.1.254 mm01: Subnet Mask: 255.255.255.224 8. To change the MPA network parameters with the values in the xCAT database for mm01: .. code-block:: perl rspconfig mm01 network=* Output is similar to: .. code-block:: perl mm01: MM IP: 192.168.1.47 mm01: MM Hostname: mm01 mm01: Gateway: 192.168.1.254 mm01: Subnet Mask: 255.255.255.224 9. To change only the gateway parameter for the MPA network mm01: .. code-block:: perl rspconfig mm01 network=,,192.168.1.1, Output is similar to: .. code-block:: perl mm01: Gateway: 192.168.1.1 10. To display the FSP network parameters for fsp01: .. code-block:: perl rspconfig> fsp01 network Output is similar to: .. code-block:: perl 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 11. To change the FSP network parameters with the values in command line for eth0 on fsp01: .. code-block:: perl rspconfig fsp01 network=eth0,192.168.1.200,fsp01,,255.255.255.0 Output is similar to: .. code-block:: perl fsp01: Success to set IP address,hostname,netmask 12. To change the FSP network parameters with the values in the xCAT database for eth0 on fsp01: .. code-block:: perl rspconfig fsp01 network=eth0,* Output is similar to: .. code-block:: perl fsp01: Success to set IP address,hostname,gateway,netmask 13. To configure eth0 on fsp01 to get dynamic IP address from DHCP server: .. code-block:: perl rspconfig fsp01 network=eth0,0.0.0.0 Output is similar to: .. code-block:: perl fsp01: Success to set IP type to dynamic. 14. To get the current power redundancy mode for power domain 1 on mm01: .. code-block:: perl rspconfig mm01 pd1 Output is similar to: .. code-block:: perl mm01: Redundant without performance impact 15. To change the current power redundancy mode for power domain 1 on mm01 to non-redundant: .. code-block:: perl rspconfig mm01 pd1=nonred Output is similar to: .. code-block:: perl mm01: nonred 16. 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: .. code-block:: perl rspconfig mm01 ntp=enable,192.168.1.1,90,enable Output is similar to: .. code-block:: perl mm01: NTP: disabled mm01: NTP Server: 192.168.1.1 mm01: NTP: 90 (minutes) mm01: NTP: enabled 17. To disable NTP v3 authentication only on mm01: .. code-block:: perl rspconfig mm01 ntp=,,,disable Output is similar to: .. code-block:: perl mm01: NTP v3: disabled 18. To disable Predictive Failure and L2 Failure deconfiguration policies on mm01: .. code-block:: perl rspconfig mm01 decfg=disable:predictive,L3 Output is similar to: .. code-block:: perl mm01: Success 19. To deconfigure processors 4 and 5 of Processing Unit 0 on mm01: .. code-block:: perl rspconfig mm01 procedecfg=deconfigure:0:4,5 Output is similar to: .. code-block:: perl mm01: Success 20. To check if CEC sysname set correct on mm01: .. code-block:: perl rspconfig mm01 sysname mm01: mm01 rspconfig mm01 sysname=cec01 mm01: Success rspconfig mm01 sysname mm01: cec01 21. To check and change the pending_power_on_side value of cec01's fsps: .. code-block:: perl rspconfig cec01 pending_power_on_side cec01: Pending Power On Side Primary: temp cec01: Pending Power On Side Secondary: temp rspconfig cec01 pending_power_on_side=perm cec01: Success rspconfig cec01 pending_power_on_side cec01: Pending Power On Side Primary: perm cec01: Pending Power On Side Secondary: perm 22. To show the BSR allocation for cec01: .. code-block:: perl rspconfig cec01 BSR Output is similar to: .. code-block:: perl cec01: Barrier Synchronization Register (BSR) cec01: Number of BSR arrays: 256 cec01: Bytes per BSR array : 4096 cec01: Available BSR array : 0 cec01: Partition name: BSR arrays cec01: lpar01 : 32 cec01: lpar02 : 32 cec01: lpar03 : 32 cec01: lpar04 : 32 cec01: lpar05 : 32 cec01: lpar06 : 32 cec01: lpar07 : 32 cec01: lpar08 : 32 23. To query the huge page information for CEC1, enter: .. code-block:: perl rspconfig CEC1 huge_page Output is similar to: .. code-block:: perl CEC1: Huge Page Memory CEC1: Available huge page memory(in pages): 0 CEC1: Configurable huge page memory(in pages): 12 CEC1: Page Size (in GB): 16 CEC1: Maximum huge page memory(in pages): 24 CEC1: Requested huge page memory(in pages): 15 CEC1: Partition name: Huge pages CEC1: lpar1 : 3 CEC1: lpar5 : 3 CEC1: lpar9 : 3 CEC1: lpar13 : 3 CEC1: lpar17 : 0 CEC1: lpar21 : 0 CEC1: lpar25 : 0 CEC1: lpar29 : 0 24. To request 10 huge pages for CEC1, enter: .. code-block:: perl rspconfig CEC1 huge_page=10 Output is similar to: .. code-block:: perl CEC1: Success 25. To disable service processor failover for cec01, in order to complete this command, the user should power off cec01 first: .. code-block:: perl rspconfig cec01 setup_failover cec01: Failover status: Enabled rpower cec01 off rspconfig cec01 setup_failover=disable cec01: Success rspconfig cec01 setup_failover cec01: Failover status: Disabled 26. To force service processor failover for cec01: .. code-block:: perl lshwconn cec01 cec01: 192.168.1.1: LINE DOWN cec01: 192.168.2.1: sp=primary,ipadd=192.168.2.1,alt_ipadd=unavailable,state=LINE UP cec01: 192.168.1.2: sp=secondary,ipadd=192.168.1.2,alt_ipadd=unavailable,state=LINE UP cec01: 192.168.2.2: LINE DOWN rspconfig cec01 force_failover cec01: Success. lshwconn> cec01 cec01: 192.168.1.1: sp=secondary,ipadd=192.168.1.1,alt_ipadd=unavailable,state=LINE UP cec01: 192.168.2.1: LINE DOWN cec01: 192.168.1.2: LINE DOWN cec01: 192.168.2.2: sp=primary,ipadd=192.168.2.2,alt_ipadd=unavailable,state=LINE UP 27. To deconfigure memory bank 9 and 10 of Processing Unit 0 on mm01: .. code-block:: perl rspconfig mm01 memdecfg=deconfigure:bank:0:9,10 Output is similar to: .. code-block:: perl mm01: Success 28. To reset the network interface of the specified nodes: .. code-block:: perl rspconfig --resetnet Output is similar to: .. code-block:: perl Start to reset network.. Reset network failed nodes: Reset network succeed nodes: Server-8233-E8B-SN1000ECP-A,Server-9119-FHA-SN0275995-B,Server-9119-FHA-SN0275995-A, Reset network finished. 29. To update the existing admin password on fsp: .. code-block:: perl rspconfig fsp admin_passwd=admin,abc123 Output is similar to: .. code-block:: perl fsp: Success 30. To set the initial password for user HMC on fsp: .. code-block:: perl rspconfig fsp HMC_passwd=,abc123 Output is similar to: .. code-block:: perl fsp: Success 31. To list BMC dumps available for download: .. code-block:: perl rspconfig p9euh02 dump -l Output is similar to: .. code-block:: perl p9euh02: [1] Generated: 09/06/2017 14:31:49, Size: 4528 p9euh02: [2] Generated: 09/06/2017 14:31:55, Size: 4516 p9euh02: [3] Generated: 09/06/2017 14:32:01, Size: 4236 p9euh02: [4] Generated: 09/06/2017 14:32:07, Size: 4248 p9euh02: [5] Generated: 09/06/2017 14:32:11, Size: 4268 32. To generate and download BMC dump: .. code-block:: perl rspconfig p9euh02 dump Output is similar to: .. code-block:: perl Capturing BMC Diagnostic information, this will take some time... p9euh02: Dump requested. Target ID is 6, waiting for BMC to generate... p9euh02: Dump 6 generated. Downloading to /var/log/xcat/dump/20171211-0951_p9euh02_dump_6.tar.xz ******** SEE ALSO ******** noderange(3)|noderange.3, rpower(1)|rpower.1, rcons(1)|rcons.1, rinv(1)|rinv.1, rvitals(1)|rvitals.1, rscan(1)|rscan.1, rflash(1)|rflash.1