f59855a763
git-svn-id: https://svn.code.sf.net/p/xcat/code/xcat-core/trunk@3829 8638fb3e-16cb-4fca-ae20-7b5d299a9bcd
138 lines
3.7 KiB
Plaintext
138 lines
3.7 KiB
Plaintext
=head1 NAME
|
|
|
|
B<getmacs> - Collects node MAC address.
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
I<getmacs [-h| --help]>
|
|
|
|
I<getmacs [-v| --version]>
|
|
|
|
I<getmacs noderange> [-F filter]
|
|
|
|
I<getmacs [-V| --verbose] noderange> [-f][-d] [--arp] | [-D [-S server] [-G gateway] [-C client]]
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
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.
|
|
|
|
=head1 OPTIONS
|
|
|
|
B<--arp> Read MAC address with ARP protocal.
|
|
|
|
B<-C> Specify the IP address of the partition for ping test. The default is to read from xCAT database if no -C specified.
|
|
|
|
B<-d> Display MAC only. The default is to write the first valid adapter MAC to the xCAT database.
|
|
|
|
B<-D> Perform ping test. Please be notified that in this way, the lpars will be reset.
|
|
|
|
B<-f> Force immediate shutdown of the partition.
|
|
|
|
B<-F> Specify filters to select the correct adapter. Acceptable filters are Type,MAC_Address,Phys_Port_Loc,Adapter,Port_Group,Phys_Port,Logical_Port,VLan,VSwitch,Curr_Conn_Speed.
|
|
|
|
B<-G> Gateway IP address of the partition. The default is to read from xCAT database if no -G specified.
|
|
|
|
B<-h> Display usage message.
|
|
|
|
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.
|
|
|
|
B<-V> Verbose output.
|
|
|
|
|
|
=head1 RETURN VALUE
|
|
|
|
0 The command completed successfully.
|
|
|
|
1 An error has occurred.
|
|
|
|
|
|
=head1 EXAMPLES
|
|
|
|
1. To retrieve the MAC address for the HMC-managed partition lpar4 and write the first valid adapter MAC to the xCAT database, enter:
|
|
|
|
I<getmacs lpar4>
|
|
|
|
Output is similar to:
|
|
|
|
# Type MAC_Address Phys_Port_Loc Adapter Port_Group Phys_Port Logical_Port VLan VSwitch Curr_Conn_Speed
|
|
|
|
lpar4:
|
|
|
|
#Type MAC_Address Phys_Port_Loc Adapter Port_Group Phys_Port Logical_Port VLan VSwitch Curr_Conn_Speed
|
|
|
|
hea 7607DFB07F02 N/A N/A N/A N/A N/A 1 ETHERNET0 N/A
|
|
|
|
ent U78A1.001.99203B5-P1-T6 00145eb55788 /lhea@23c00614/ethernet@23e00514 unsuccessful physical
|
|
|
|
|
|
2. To retrieve the MAC address with ARP protocal:
|
|
|
|
I<getmacs lpar4 --arp>
|
|
|
|
Output is similar to:
|
|
|
|
lpar4:
|
|
|
|
#IP MAC_Address
|
|
|
|
192.168.0.10 00145eb55788
|
|
|
|
|
|
3. To retrieve the MAC address for the HMC-managed partition lpar4 and display the result only, enter:
|
|
|
|
I<getmacs lpar4 -d>
|
|
|
|
Output is similar to:
|
|
|
|
lpar4:
|
|
|
|
#Type MAC_Address Phys_Port_Loc Adapter Port_Group Phys_Port Logical_Port VLan VSwitch Curr_Conn_Speed
|
|
|
|
hea 7607DFB07F02 N/A N/A N/A N/A N/A 1 ETHERNET0 N/A
|
|
|
|
ent U78A1.001.99203B5-P1-T6 00145eb55788 /lhea@23c00614/ethernet@23e00514 unsuccessful physical
|
|
|
|
|
|
|
|
4. To retrieve the MAC address for the HMC-managed partition lpar4 with filter Type=hea,VSwitch=ETHERNET0.
|
|
|
|
I<getmacs lpar4 -F Type=hea,VSwitch=ETHERNET0>
|
|
|
|
Output is similar to:
|
|
|
|
lpar4:
|
|
|
|
#Type MAC_Address Phys_Port_Loc Adapter Port_Group Phys_Port Logical_Port VLan VSwitch Curr_Conn_Speed
|
|
|
|
hea 7607DFB07F02 N/A N/A N/A N/A N/A 1 ETHERNET0 N/A
|
|
|
|
|
|
|
|
5. To retrieve the MAC address while performing a ping test for the HMC-managed partition lpar4 and display the result only, enter:
|
|
|
|
I<getmacs lpar4 -d -D -S 9.3.6.49 -G 9.3.6.1 -C 9.3.6.234>
|
|
|
|
#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
|
|
|
|
=head1 FILES
|
|
|
|
/opt/xcat/bin/getmacs
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
L<makedhcp(8)|makedhcp.8>
|
|
|
|
|
|
|
|
|
|
|
|
|