=head1 NAME B - Collects node MAC address. =head1 SYNOPSIS I I I [-F filter] I [-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 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 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 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 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 #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