xcat-core/xCAT-client-2.0/pods/man1/rspconfig.1.pod
2008-04-15 13:02:23 +00:00

241 lines
4.8 KiB
Plaintext

=head1 NAME
B<rspconfig> - remote power control of nodes
=head1 SYNOPSIS
B<rspconfig> I<noderange> {B<alert>|B<snmpdest>|B<community>}
B<rspconfig> I<noderange> B<alert>={B<on>|B<enable>|B<off>|B<disable>}
B<rspconfig> I<noderange> B<snmpdest>=I<snmpmanager-IP>
B<rspconfig> I<noderange> B<community>={B<public>|I<string>}
B<rspconfig> [B<-h>|B<--help>|B<-v>|B<--version>]
=head2 BMC specific:
B<rspconfig> I<noderange> {B<ip>|B<netmask>|B<gateway>|B<backupgateway>|B<garp>}
B<rspconfig> I<noderange> B<garp>={I<time>}
=head2 MPA specific:
B<rspconfig> I<noderange> {B<sshcfg>|B<snmpcfg>|B<build>|B<pd1>|B<pd2>|B<network>|B<swnet>|B<ntp>}
B<rspconfig> I<noderange> B<shcfg>={B<enable>|B<disable>}
B<rspconfig> I<noderange> B<snmpcfg>={B<enable>|B<disable>}
B<rspconfig> I<noderange> B<pd1>={B<nonred>|B<redwoperf>|B<redwperf>}
B<rspconfig> I<noderange> B<pd2>={B<nonred>|B<redwoperf>|B<redwperf>}
B<rspconfig> I<noderange> B<network>={[B<ip>],[B<host>],[B<gateway>],[B<netmask>]|xcat-table}
B<rspconfig> I<noderange> B<swnet>={[B<ip>],[B<gateway>],[B<netmask>]}
B<rspconfig> I<noderange> B<ntp>={[B<ntpenable>],[B<ntpserver>],[B<frequency>],[B<v3>]}
=head1 DESCRIPTION
B<rspconfig> configures various settings in the nodes' service processors. If only a keyword is
specified, without the B<=>, it displays the current value.
=head1 OPTIONS
=over 4
=item B<alert>={I<on>|I<enable>|I<off>|I<disable>}
Turn on or off SNMP alerts.
=item B<backupgateway>
Get the BMC backup gateway ip address.
=item B<build>
Get the MPA firmware build ID.
=item B<community>={B<public>|I<string>}
Get or set the SNMP commmunity value. The default is I<public>.
=item B<frequency>
The NTP update frequency (in minutes).
=item B<garp>=I<time>
Get or set Gratuitous ARP generation interval. The unit is number of 1/2 second.
=item B<gateway>
The gateway ip address.
=item B<host>
The hostname.
=item B<ip>
The ip address.
=item B<netmask>
The subnet mask.
=item B<network>={[I<ip>],[I<host>],[I<gateway>],[I<netmask>]|xcat-table}
Get or set the MPA network parameters.
=item B<nonred>
Allows loss of redundancy.
=item B<ntp>={[I<ntpenable>],[I<ntpserver>],[I<frequency>],[I<v3>]}
Get or set the MPA Network Time Protocol (NTP) parameters.
=item B<ntpenable>
Enable or disable NTP (enable|disable).
=item B<ntpserver>
Get or set NTP server IP address or name.
=item B<pd1>={B<nonred>|B<redwoperf>|B<redwperf>}
Power Domain 1 - determines how an MPA responds to a loss of redundant power.
=item B<pd2>={B<nonred>|B<redwoperf>|B<redwperf>}
Power Domain 2 - determines how an MPA responds to a loss of redundant power.
=item B<redwoperf>
Prevents components from turning on that will cause loss of power redundancy.
=item B<redwperf>
Power throttles components to maintain power redundancy and prevents components from turning on that will cause loss of power redundancy.
=item B<snmpcfg>={I<enable>|I<disable>}
Enable or disable SNMP on MPA.
=item B<snmpdest>=I<snmpmanager-IP>
Get or set where the SNMP alerts should be sent to.
=item B<sshcfg>={I<enable>|I<disable>}
Enable or disable SSH on MPA.
=item B<swnet>={[I<ip>],[I<gateway>],[I<netmask>]}
Set the Switch network parameters.
=item B<v3>
Enable or disable v3 authentication (enable|disable).
=item B<xcat-table>
Use xCAT database values.
=item B<-h>|B<--help>
Prints out a brief usage message.
=item B<-v>, B<--version>
Display the version number.
=back
=head1 EXAMPLES
=over 3
=item *
To turn on SNMP alerts for node5:
B<rspconfig> I<node5> B<alert>=B<on>
node5: Alerts: enabled
=item *
To display the destination setting for SNMP alerts for node4:
B<rspconfig> I<node4 snmpdest>
node4: BMC SNMP Destination 1: 9.114.47.227
=item *
To display the MPA network parameters for mm01:
B<rspconfig> I<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
=item *
To change only the gateway parameter for the MPA network mm01:
B<rspconfig> I<mm01 network=,,192.168.1.1,>
mm01: Gateway: 192.168.1.1
=item *
To get the current power redundancy mode for power domain 1 on mm01:
B<rspconfig> I<mm01 pd1>
mm01: Redundant without performance impact
=item *
To change the current power redundancy mode for power domain 1 on mm01 to non-redundant:
B<rspconfig> I<mm01 pd1=nonred>
mm01: nonred
=item *
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:
B<rspconfig> I<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
=item *
To disable NTP v3 authentication only on mm01:
B<rspconfig> I<mm01 ntp=,,,disable>
mm01: NTP v3: disabled
=back
=head1 SEE ALSO
noderange(3), rpower(1), rcons(1), rinv(1), rvitals(1), rscan(1)