NAME

rspconfig - Configures nodes' service processors


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/CEC specific:

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

rspconfig noderange autopower={enable|disable}

rspconfig noderange iocap={enable|disable}

rspconfig noderange dev={enable|disable}

rspconfig noderange celogin1={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

BPA/Frame Specific:

rspconfig noderange {network|dev|celogin1}

rspconfig noderange network={nic,*}

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

rspconfig noderange network={nic,0.0.0.0}

rspconfig noderange dev={enable|disable}

rspconfig noderange celogin1={enable|disable}

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. If only a keyword is specified, without the =, it displays the current value.

For options autopower|iocap|dev|celogin1|decfg|memdecfg|procdecfg|time|date|spdump|sysdump|network, user need to use chdef -t site enableASMI=yes to enable ASMI first. For options dev|celogin1, user also need to access http://w3.pok.ibm.com/organization/prodeng/pw/ to get the dynamic password for 'celogin' and put it in passwd table. After completed the command, user should use chdef -t site enableASMI=no to disable ASMI.


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 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.

  • Change the passwords of the userids HMC, HMC 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, HMC 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, HMC 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).

    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.

    dev={enable|disable}

    Enable or disable the CEC|Frame 'dev' account or display account status if no value specified.

    celogin1={enable|disable}

    Enable or disable the CEC|Frame 'celogin1' account or display account status if no value specified.

    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.

    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 datebase. 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.

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


    SEE ALSO

    noderange(3), rpower(1), rcons(1), rinv(1), rvitals(1), rscan(1), rflash(1)