From a3d37933ea1d2ef4b59afdba23e7e8accf317ee8 Mon Sep 17 00:00:00 2001
From: zhaoertao <zhaoertao@8638fb3e-16cb-4fca-ae20-7b5d299a9bcd>
Date: Mon, 17 Oct 2011 05:59:42 +0000
Subject: [PATCH] update BSR,failover part

git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/branches/2.6@10787 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
---
 xCAT-client/pods/man1/rspconfig.1.pod | 78 +++++++++++++++++++++++----
 1 file changed, 67 insertions(+), 11 deletions(-)

diff --git a/xCAT-client/pods/man1/rspconfig.1.pod b/xCAT-client/pods/man1/rspconfig.1.pod
index 90e8439db..6f5915538 100644
--- a/xCAT-client/pods/man1/rspconfig.1.pod
+++ b/xCAT-client/pods/man1/rspconfig.1.pod
@@ -140,6 +140,12 @@ B<rspconfig> I<noderange> B<cec_off_policy>={B<poweroff>|B<stayon>}
 
 B<rspconfig> I<noderange> {B<BSR>}
 
+B<rspconfig> I<noderange> {B<setup_failover>}
+
+B<rspconfig> I<noderange> B<setup_failover>={B<enable>|B<disable>}
+
+B<rspconfig> I<noderange> {B<force_failover>}
+
 B<rspconfig> I<noderange> B<--resetnet>
 
 =head2 BPA/Frame (using Direct FSP Management) Specific:
@@ -252,7 +258,15 @@ Display the CEC/BPA system names.
 
 =item B<BSR>
 
-Get (Barrier Synchronization Register) BSR allocation for a CEC. 
+Get Barrier Synchronization Register (BSR) allocation for a CEC. 
+
+=item B<setup_failover>={I<enable>|I<disable>}
+
+Enable or disable the service processor failover function of a CEC or display status of this function. 
+
+=item B<force_failover>
+
+Force a service processor failover from the primary service processor to the secondary service processor.
 
 =item B<hostname>={I<*|name>}
 
@@ -599,17 +613,59 @@ To show the BSR allocation for cec01:
 
 B<rspconfig> I<cec01 BSR>
 
+ cec01: Barrier Synchronization Register (BSR)
  cec01: Number of BSR arrays: 256
- cec01: Bytes per BSR array: 4096
- cec01: Available BSR array: 0
- cec01: lpar01: 32
- cec01: lpar02: 32
- cec01: lpar03: 32
- cec01: lpar04: 32
- cec01: lpar05: 32
- cec01: lpar06: 32
- cec01: lpar07: 32
- cec01: lpar08: 32
+ 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
+
+=item *
+
+To disable service processor failover for cec01, in order to complete this command, the user should power off cec01 first:
+
+B<rspconfig> I<cec01 setup_failover>
+
+ cec01: Failover status: Enabled
+
+B<rpower> I<cec01 off>
+
+B<rspconfig> I<cec01 setup_failover=disable>
+
+ cec01: Success
+
+B<rspconfig> I<cec01 setup_failover>
+
+ cec01: Failover status: Disabled
+
+=item *
+
+To force service processor failover for cec01:
+
+B<lshwconn> I<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
+ 
+B<rspconfig> I<cec01 force_failover>
+
+ cec01: Success.
+ 
+B<lshwconn> I<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
 
 =item *