arif/xcat-core
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

fixed bug 3178551, add some description and one example for direct fsp management

Browse Source 
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@9111 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
This commit is contained in:
jjhua 2011-03-21 05:42:06 +00:00
parent f6bfd21981
commit 9d02c45bcb
1 changed files with 21 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
xCAT-client/pods/man1/getmacs.1.pod
View File

@ -12,7 +12,7 @@ I<getmacs [-h| --help | -v| --version]>
I<getmacs noderange [-F filter]>
I<getmacs noderange [-V| --verbose] [-f] [-d] [--arp] | [-D [-S server] [-G gateway] [-C client] [--hfi]]>
I<getmacs noderange [-V| --verbose] [-f] [-d] [--arp] | [-D [-S server] [-G gateway] [-C client] [--hfi] [-o]]>
=head2 blade specific:
@ -24,6 +24,9 @@ The getmacs command collects MAC address from a single or range of nodes.
Note that on AIX systems, the returned MAC address is not colon-seperated (for example 8ee2245cf004), while on Linux systems the MAC address is colon-seperated (for example 8e:e2:24:5c:f0:04).
If no ping test performed, getmacs writes the first adapter MAC to the xCAT database. If ping test performed, getmacs will write the first successfully pinged MAC to xCAT database.
For PPC (without HMC, using Direct FSP Management) specific:
If users run "getmacs noderange" directly for P7 IH LPARs, it will return the HIF MAC addresses which are owned by the LPARs.
Note: If network adapters are physically assigned to LPARs, getmacs cannot read the MAC addresses unless perform ping test, since there is no HMC command to read them and getmacs has to login to open formware. And if the LPARs has never been activated before, getmacs need to be performed with the option "-D" to get theirs MAC addresses.
=head1 OPTIONS
@ -46,6 +49,8 @@ B<-h> Display usage message.
B<--hfi> Read HFI MAC address. This option mush be used with [-D] option to perform ping test.
B<-o> Read MAC address when the lpar is in openfirmware state. This option mush be used with [-D] option to perform ping test. Before use -o, the lpar must be in openfirmware state.
B<-S> The IP address of the machine to ping. The default is to read from xCAT databse if no -S specified.
B<-v> Command Version.
@ -126,10 +131,25 @@ hea 7607DFB07F02 N/A N/A N/A N/A N/A 1 ETHERNET0 N/A
I<getmacs lpar4 -d -D -S 9.3.6.49 -G 9.3.6.1 -C 9.3.6.234>
Output is similar to:
lpar4:
#Type Location Code MAC Address Full Path Name Ping Result
ent U9133.55A.10B7D1G-V12-C4-T1 8e:e2:24:5c:f0:04 /vdevice/l-lan@30000004 successful virtual
6. To retrieve the MAC address for P7 IH LPARl using Direct FSP Management without ping test and display the result only, enter:
I<getmacs c250f07c04ap01 -d>
Output is similar to:
c250f07c04ap01:
#Type Phys_Port_Loc MAC_Address Adapter Port_Group Phys_Port Logical_Port VLan VSwitch Curr_Conn_Speed
HFI N/A 02:00:02:00:00:04:|02:00:02:00:00:05:|02:00:02:00:00:06 N/A N/A N/A N/A N/A N/A N/A
=head1 FILES
/opt/xcat/bin/getmacs