discover Command to initiate the Discover mode and to use its subcommands.

clear
create
commit
end
set ipaddrs=ipaddress_spec
set password=string
set root_password=string
set root_user=root_account
set type=name
set user=username
show
The Discover mode is one of a set of modes provided by the Oracle Enterprise Manager Ops
Center Command Line Interface. Use the Discover subcommands to create jobs that retrieve
information about assets. Adiscover job consists of specifcations for the search and the
credentials to gain access to the assets.
Type the discover command at the command line prompt to enter Discover mode. Type the
end command to stop the mode and to return to the command line prompt.
Use the create subcommand start defning the attributes and actions of a discovery job. The
specifcations for a discovery job depend on the type of discovery: an operating system(OS), a
server processor for some Oracle Sun assets (ILOM), or a service processor for other types of
assets (ALOM). Use the following create subcommands for each type of discovery:
OS ILOM ALOM
----------------------|---------------------|---------------------
set type | |
set ssh_user | |
set ssh_password | |
set ssh_root_user | same | same
set ssh_root_password | |
set ipaddrs | |
commit | |
----------------------|---------------------|----------------------
| set ipmi_user |
| set ipmi_password | same
---------------------|---------------------|-----------------------
| | set telnet_user
| | set telnet_password
----------------------|---------------------|-----------------------
create Specifes a newdiscover job. This command starts a
submode with its own set of subcommands for
specifying the attributes and actions of the job and to
manage the job.
Name
Synopsis
Description
Subcommands
discover(1)
discover Last Revised September 2010 1
clear Cancels the settings you have entered for the
discovery job before you submit it.
set type=type Specifes the way that the discovery job searches for
assets: OS, ILOM, ALOM. This is the frst command
when specifying a discovery job because the type of
discovery defnes the required settings.
set ipaddrs=ipaddress_spec Defnes the scope of the discovery job by providing a
single IP address, a list of addresses, or a range of
addresses.
set ssh_user=username Provides the username for an account to the ssh
utility.
set ssh_password=password Provides the password for an account to the ssh
utility.
set ssh_root_user=username (Optional) Provides the name of a user account with
root access to the ssh utility.
set ssh_root_password=password (Optional) Provides the password for a user account
with root access to the ssh utility.
set ipmi_user=username Provides the username for an Intelligent Platform
Management Interface (IPMI) account, required for
ILOMand ALOMdiscovery jobs.
set ipmi_password=password Provides the password for an Intelligent Platform
Management Interface (IPMI) account, required for
ILOMand ALOMdiscovery jobs.
set telnet_user=username Provides the username for an account to the telnet
utility, required by ALOMdiscovery jobs.
set telnet_password=password Provides the password for an account to the telnet
utility, required by ALOMdiscovery jobs.
show Displays the current settings for the discovery job.
commit Submits the discover job after you completed
specifying the job.
end Stops the submode and returns to the Discover mode.
None
The following operands are supported:
Options
Operands
discover(1)
Reference Pages 2
ipaddress_spec Asingle IP address, a comma-separated list of IP address enclosed with
parentheses, or a range of IP addresses specifed in either dash or CIDR
subnet notation:

ipaddress

(ipaddress1,ipaddress2,...ipaddressn)

low_ipaddress-high_ipaddress

low_ipaddress/high_ipaddress
password String that acts as the private credential for an account.
type Type of network object discovered by the job. Valid values are:

os

ILOM

ALOM
username Public identifer for an account.
0 Successful completion
!=0 An error occurred.
EXAMPLE 1 Create and start a job that locates operating systems within a range of IP addresses
# discover
[discover] > create
[discover] create# > set type=os
[discover] create# > set ssh_user=pat
[discover] create# > set ssh_password=secret99
[discover] create# > set ipaddrs=192.168.1.0/24
[discover] create# > commit
Discovery job submitted - Job ID = hs-x4100-1.65
EXAMPLE 2 Create and start a job that locates service processors for other types of gear within a range of
IP addresses
# discover
[discover] > create
[discover] create# > set type=alom
[discover] create# > set ssh_user=pat
[discover] create# > set ssh_password=secret99
[discover] create# > set ipmi_user=pet
[discover] create# > set ipmi_password=secret01
[discover] create# > set telnet_user=pit
[discover] create# > set telnet_password=secret10
[discover] create# > set ipaddrs=192.168.1.0 - 192.168.1.24
[discover] create# > commit
Discovery job submitted - Job ID = hs-x4100-1.66
Exit Status
Examples
discover(1)
discover Last Revised September 2010 3
JAVA_HOME
PAGER
xvmcli.5, fwimage.1. fwprofle.1, gear.1, groups.1, jobs.1, notifcations.1 osimage.1,
osprofle.1, stats.1, update.1
Environment
Variables
See Also
discover(1)
Reference Pages 4
5