discover

Discovers multiple Fusion Applications domains by reading the Fusion Applications domain discovery file and saving the host-wise discovered targets to the Agents provided in the Host Agent Mapping file. If the Host Agent mapping file is not provided, the local Agent (that is, the Agent on the same host as the target) is used to save/monitor the discoverd targets as well. If a local Agent is not found, the default discovery Agent is used to save/monitor the discoverd targets as well.

Note:

Although this verb supports discovering multiple Fusion instances at one time by adding all the details in one file, it is advisable to discover each Fusion instance separately using individual EM CLI discover_fa commands run multiple times.

Format

emcli discover_fa
      -input_file=fa_domain_discovery_file:file_path
      [-input_file=host_agent_mapping_file:file_path]
      [-input_file=pf_domain_cred_mapping_file:file_path]
      [-debug]

[ ]  indicates that the parameter is optional

Options

input_file=fa_domain_discovery_file

Fully-qualified path to a CSV-formatted file containing one line of details per domain to be added. The valid WebLogic version value is 10. The structure of the CSV file is as follows:

<WebLogic Server version>,
<Administration Server host machine name>,
<Administration Server listen port>,
<Administration Server username>,
<Administration Server password>,
<External Options - optional>,
<JMX Protocol - required only if SSL enabled>,
<JMX Service URL - required only if SSL enabled>,
<Unique Domain Identifier>,
<Agent URL/>,
<Discover Down Servers - optional - Default if not specified is false starting <PS1. Before PS1 the default for this is true>,
<Use Same Credentials for All Domains in the Fusion Instance - optional - Default if <not specified is true>

For example:

10,mco01.mycompany.com,7001,weblogic,password,,,,my_farm_
    01,https://mco01.mycompany.com:3872/emd/main/,,
10,mco01.mycompany.com,7001,weblogic,password,,,,my_farm_
    01,https://mco01.mycompany.com:3872/emd/main/,true,
10,mco01.mycompany.com,7001,weblogic,password,,,,my_farm_
    01,https://mco01.mycompany.com:3872/emd/main/,true,true
10,mco01.mycompany.com,7001,weblogic,password,,,,my_farm_
    01,https://mco01.mycompany.com:3872/emd/main/,false,true

For information about the input_file parameter, see -input_file Syntax Guidelines.

input_file=host_agent_mapping_file

Fully-qualified path to a CSV-formatted file containing multiple lines of host system names where Managed Servers are to be monitored, and the Agent to be used to monitor each host's Managed Servers.

For example:
```
mycompany.com,https://mco01.mycompany.com:3872/emd/main
```
For information about the input_file parameter, see -input_file Syntax Guidelines.
input_file=pf_domain_cred_mapping_file

Fully-qualified path to a CSV-formatted file containing multiple lines of WebLogic admin credentials for each domain of a fusion instance, where the credentials are different from those added in the fa_domain_discovery file.

The same credentials are used for all the domains in a Fusion Application instance unless the credentials are overwritten in the pf_domain_cred_mapping file.

For example:
```
<UniqueKey - "<Fusion Instance 
     Identifier><CommonDomainDisplayName>">,<Administration Server 
     username>,<Administration Server password>,
<UniqueKey - "<Fusion Instance 
     Identifier>-<CommonDomainDisplayName>">,<Administration Server 
     username>,<Administration Server password>,<Administration Server Host 
     Name>

Example:
fi9-FS,weblogic12,password,
fi9-PRJ,faadmin,fusionfa1,
fi9-PRC,faadmin,fusionfa1,myhost.us.example.com
fi9-PRC,,,myhost.us.example.com
```
For information about the input_file parameter, see -input_file Syntax Guidelines.
debug

Runs the verb in verbose mode for debugging purposes.

Examples

Example 1

This example reads the my_domains_info.csv file to determine the Fusion Instances to be added to Cloud Control, reads the my_agent_mapping.csv file to determine which Agents should monitor which host's Managed Servers, and reads the my_domain_cred_mapping.csv file to determine which credentials are to be used to discover an individual product family.

emcli discover_fa 
      -input_file=fa_domain_discovery_file:c:\emcli\my_domains_info.csv 
      -input_file=host_agent_mapping_file:c:\emcli\my_agent_mapping.csv 
      -input_file=pf_domain_cred_mapping_file:c:\emcli\my_domain_cred_mapping.csv

Example 2

emcli discover_fa -input_file=fa_domain_discovery_file:/tmp/emcli/
domain_discovery_file.txt -input_file=host_agent_mapping_filee:/tmp/emcli/
host_agent_mapping_file.txt -input_file=pf_domain_cred_mapping_file:/tmp/emcli/
pf_domain_cred_mapping_file.txt -debug