diff --git a/xCAT-client/pods/man1/bmcdiscover.1.pod b/xCAT-client/pods/man1/bmcdiscover.1.pod index 3c7bc93d0..0293f6edf 100644 --- a/xCAT-client/pods/man1/bmcdiscover.1.pod +++ b/xCAT-client/pods/man1/bmcdiscover.1.pod @@ -6,19 +6,21 @@ B - Discover bmc using scan method, now scan_method can be nmap. B [B<-h>|B<--help>] [B<-v>|B<--version>] -B [B<-m>|B<--method>] I [B<-r>|B<--range>] I +B [B<-s>] I [B<--range>] I [B<-z>] [B<-w>] B [B<-i>|B<--bmcip>] I [B<-u>|B<--bmcuser>] I [B<-p>|B<--bmcpwd>] I [B<-c>|B<--check>] +B [B<-i>|B<--bmcip>] I [B<-u>|B<--bmcuser>] I [B<-p>|B<--bmcpwd>] I [B<--ipsource>] + =head1 DESCRIPTION The B command will discover bmc using scan method. This command will use nmap scan active nodes, ip range format should be the same format with that is used by nmap. -Note: scan method can only be nmap now. +Note: scan method can only be nmap now, default scan method is nmap. -This command can check if bmc username or password is correct or not +This command can check if bmc username or password is correct or not. It can get BMC IP Address source, DHCP Address or static Address. =head1 OPTIONS @@ -32,13 +34,21 @@ Display usage message. Command version. -=item B<-m|--method> I +=item B<-s> I Scan method, now it is nmap. -=item B<-r|--range> I +=item B<--range> I -Ip range should be a string, can pass hostnames, IP addresses, networks, etc. +Ip ranges should be a string, can pass hostnames, IP addresses, networks, etc. + +=item B<-z> + +List the stanza formate data. + +=item B<-w> + +Write to the database. =item B<-i|--bmcip> I @@ -56,6 +66,10 @@ BMC user password. Check. +=item B<--ipsource> + +BMC IP source. + =back =head1 RETURN VALUE @@ -68,7 +82,7 @@ Check. 1. To get all bmc from ip range -bmcdiscover -m nmap -r "10.4.23.100-254 50.3.15.1-2" +bmcdiscover -s nmap --range "10.4.23.100-254 50.3.15.1-2" Output is similar to: @@ -77,7 +91,47 @@ Output is similar to: Note: input for ip range can also be like scanme.nmap.org, microsoft.com/24, 192.168.0.1; 10.0.0-255.1-254. -2. To check if user name or password is correct or not for bmc +2. After discover bmc, list the stanza format data + +bmcdiscover -s nmap --range "10.4.22-23.100-254" -z + +Output is similar to: + +node10422254: + objtype=node + groups=all + bmc=10.4.22.254 + cons=ipmi + mgt=ipmi + +node10423254: + objtype=node + groups=all + bmc=10.4.23.254 + cons=ipmi + mgt=ipmi + +3. After discover bmc, write host node definition into the database, and the same time, give out stanza format data + +bmcdiscover -s nmap --range "10.4.22-23.100-254" -w + +Output is similar to: + +node10422254: + objtype=node + groups=all + bmc=10.4.22.254 + cons=ipmi + mgt=ipmi + +node10423254: + objtype=node + groups=all + bmc=10.4.23.254 + cons=ipmi + mgt=ipmi + +4. To check if user name or password is correct or not for bmc bmcdiscover -i 10.4.23.254 -u USERID -p PASSW0RD -c @@ -103,6 +157,14 @@ Output is similar to: Error: Not bmc +5. Get BMC IP Address source, DHCP Address or static Address + +bmcdiscover -i 10.4.23.254 -u USERID -p PASSW0RD --ipsource + +Output is similar to: + +Static Address + =head1 SEE ALSO L