From 6e4c309c1affcb534faaddc44c2661f1c5e24159 Mon Sep 17 00:00:00 2001 From: bp-sawyers Date: Sat, 10 Oct 2009 13:48:58 +0000 Subject: [PATCH] Fixed 2875898: updated mkhwconn man page git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@4338 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd --- xCAT-client/pods/man1/mkhwconn.1.pod | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/xCAT-client/pods/man1/mkhwconn.1.pod b/xCAT-client/pods/man1/mkhwconn.1.pod index ec4942ef8..392fe14c8 100644 --- a/xCAT-client/pods/man1/mkhwconn.1.pod +++ b/xCAT-client/pods/man1/mkhwconn.1.pod @@ -1,6 +1,6 @@ =head1 NAME -B - Use this command to setup connections for FSP and BPA nodes to HMC nodes. +B - Sets up connections for FSP and BPA nodes to HMC nodes. =head1 SYNOPSIS @@ -14,15 +14,18 @@ B [B<-V>| B<--verbose>] noderange B<-H> hmc [B<-P> passwd] =head1 DESCRIPTION -This command is used to setup connections for FSP and BPA nodes to HMC nodes. If the connection already exists, it will not bread this connection. +This command is used to set up connections for FSP and BPA nodes to HMC nodes. (If the connection already exists, it will not break it.) +This command is useful when you have multiple HMCs, each of which will manage a subset of the FSPs/BPAs. Use B to tell +each HMC which FSPs/BPAs it should manage. When using this, you should turn off the self-discovery on each HMC. You also need +to put all the HMCs and all the BPAs on a single flat service network. -When -t is specified, this command reads the connection information from xCAT ppc table, and read the user/password from ppcdirect table. Then this command will assign FSP nodes and BPA nodes to HMC nodes. +When -t is specified, this command reads the connection information from the xCAT ppc table (e.g. the parent attribute), and read the user/password from the ppcdirect table. Then this command will assign FSP nodes and BPA nodes to HMC nodes. -When -H is specified, this command read the connection information from command line. The default user/password for FSP and BPA nodes are admin/admin. +When -H is specified, this command gets the connection information from command line arguments. If -P is not specified, the default password for FSP and BPA nodes is used. In any case, before running this command, the FSP and BPA nodes need be defined with correct nodetype.nodetype value (fsp or bpa) and nodehm.mgt value (hmc). -Note: If a CEC (FSP node represents) belongs to a frame, which has a BPA installed, this CEC should not be assigned to an HMC individually. Instead, the whole frame (BPA node represents) should be assigned to the HMC. +Note: If a CEC (FSP) belongs to a frame, which has a BPA installed, this CEC should not be assigned to an HMC individually. Instead, the whole frame (BPA) should be assigned to the HMC. =head1 OPTIONS @@ -34,7 +37,8 @@ Display usage message. =item B<-t> -Read connection information from xCAT DB. +Read connection information from xCAT DB (ppc and ppcdirect tables). Use this option if you need to connect multiple FSPs/BPAs +to multiple HMCs in a single command. =item B<-H> @@ -50,7 +54,6 @@ Verbose output. =back - =head1 RETURN VALUE 0 The command completed successfully. @@ -75,7 +78,6 @@ To setup the connection for BPA nodes in node group frame_grp1 to HMC node hmc1, =back - =head1 FILES $XCATROOT/bin/mkhwconn @@ -87,7 +89,6 @@ default value is "/opt/xcat".) This command is part of the xCAT software product. - =head1 SEE ALSO L, L