=head1 NAME

B<bmcdiscover> - Discover bmc using scan method, now scan_method can be nmap.

=head1 SYNOPSIS

B<bmcdiscover> [B<-h>|B<--help>] [B<-v>|B<--version>]

B<bmcdiscover> [B<-s> I<scan_method>] B<--range> I<ip_ranges> [B<-z>] [B<-w>]

B<bmcdiscover> B<-i>|B<--bmcip> I<bmc_ip> [B<-u>|B<--bmcuser> I<bmcusername>] B<-p>|B<--bmcpwd> I<bmcpassword> B<-c>|B<--check>

B<bmcdiscover> B<-i>|B<--bmcip> I<bmc_ip> [B<-u>|B<--bmcuser> I<bmcusername>] B<-p>|B<--bmcpwd> I<bmcpassword> B<--ipsource>

=head1 DESCRIPTION

The B<bmcdiscover> 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, default scan method is nmap.

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

=over 10

=item B<--range>       

Specify one or more IP ranges. Ip ranges should be a string, can pass hostnames, IP addresses, networks, etc. Each can be an ip address (10.1.2.3) or an ip range (10.1.2.0/24). If the range is huge, for example, 192.168.1.1/8, the bmcdiscover may take a very long time to scan. So the range should be exactly specified. For nmap scan method, it accepts multiple formats. For example, 192.168.1.1/24, 40-41.1-2.3-4.1-100, scanme.nmap.org, microsoft.com/24.

=item B<-s>            

Scan method, now it is nmap.

=item B<-z>            

List the stanza formate data.

=item B<-w>            

Write to the database.

=item B<-i|--bmcip>    

BMC ip.

=item B<-u|--bmcuser>  

BMC user name.

=item B<-p|--bmcpwd>   

BMC user password.

=item B<-c|--check>    

Check.

=item B<--ipsource>    

BMC IP source.

=item B<-h|--help>

Display usage message.

=item B<-v|--version>

Command version.

=back

=head1 RETURN VALUE

0  The command completed successfully.

1  An error has occurred.

=head1 EXAMPLES

1. To get all bmc from ip range

bmcdiscover -s nmap --range "10.4.23.100-254 50.3.15.1-2"

Output is similar to:

10.4.23.254
50.3.15.1

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. 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

Output is similar to:

Correct ADMINISTRATOR

bmcdiscover -i 10.4.23.254 -u USERID -p PASSW0RD1 -c

Output is similar to:

Error: Wrong bmc password

bmcdiscover -i 10.4.23.254 -u USERID1 -p PASSW0RD1 -c

Output is similar to:

Error: Wrong bmc user

bmcdiscover -i 10.4.23.2541234 -u USERID -p PASSW0RD -c

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<lsslp(1)|lsslp.1>