Parameters for Installing Data Collector

This section describes the parameters that are required for installing a data collector.

If you want to install a data collector then you need to edit the response file (agent.rsp) and provide values for the parameters that are required to install a cloud agent (See, Parameters for Installing a Cloud Agent). In addition, you must also specify the values for the data collector parameters from the following list:

For response files samples, see Sample Response Files.

Data Collector Parameters

The following are data collector specific parameters that are required to install a data collector.

Parameter	Parameter Type	Description	Notes
`DATA_COLLECTOR_USERNAME`	Mandatory	User that’s created for the data collector in the Oracle Management Repository and is used to collect Oracle Enterprise Manager Cloud Control data. The user name must be a minimum of 5 characters and a maximum of 26 characters in length and must start with a string (a-z or A-Z).	Example: `testdcjlr`
`DATA_COLLECTOR_USER_PASSWORD`	Mandatory	Password to be set for `DATA_COLLECTOR_USERNAME` (must be 5-8 alphanumeric characters and must start with a letter). The password rules of the data collector are the same as that of the Oracle Management Repository database password rules, because the data collector creates a schema in the Oracle Management Repository database. However, data collector passwords can’t have a special character or numeric as the first character.	Example: `jDC5878`
`OMR_USERNAME`	Mandatory	Privileged database user name to sign in to the Oracle Management Repository; must have the `SYS` role. The user should have access to create `DATA_COLLECTOR_USERNAME` user in the OMR to collect data from it.	Example: `sys`
`OMR_USER_PASSWORD`	Mandatory	Password used to sign in to the Oracle Management Repository in your data center.	Example: `password_4u`
`OMR_HOST_USERNAME`	Mandatory	User name (of the install user of Oracle Management Repository) for the host where Oracle Management Repository is running in your data center.	Example: `johndoe`
`OMR_STAGE_DIR`	Mandatory	Directory where the data collector stores the harvested data in an archived form. `OMR_STAGE_DIR` should be present in `OMR_HOSTNAME` and the user deploying the data collector must have read or write permissions to `OMR_STAGE_DIR`. This directory must have at least 2048 MB free space available. The directory name can be up to 4000 characters.	Example: `/stage/test`
`OMR_HOST_USER_PASSWORD`	Mandatory	Password for the host where the Oracle Management Repository is running in your data center.	Example: `AUPA0fgQ1` Leave this parameter blank if `OMR_HOST_USER_SSH_KEY` is provided.
`OMR_HOST_USER_SSH_KEY`	Mandatory	Path to the private SSH key to be used to connect to your Oracle Management Repository.	Example: `$HOME/.ssh/id_rsa` Leave this parameter blank if `OMR_HOST_USER_PASSWORD` is provided.
`OMR_CONNECT_STRING`	Mandatory	Connection string to be used to connect to Oracle Management Repository. The `OMR_CONNECT_STRING`, or a combination of `OMR_HOSTNAME, OMR_PORT`, and either `OMR_SID` or `OMR_SERVICE_NAME` is required to connect to the Oracle Management Repository.	Example: `mytestconnectstring` Leave this parameter blank if a combination of `OMR_HOSTNAME, OMR_PORT`, and either `OMR_SID` or `OMR_SERVICE_NAME` is provided.
`OMR_HOSTNAME`	Mandatory	Fully qualified name of the host where the Oracle Management Repository is running.	Example: `example1.test.example.com` Leave this parameter blank if `OMR_CONNECT_STRING` is provided.
`OMR_PORT`	Mandatory	Listen port of the Oracle Management Repository in your data center.	Example: `1845` Leave this parameter blank if `OMR_CONNECT_STRING` is provided.
`OMR_SID`	Mandatory	`SID` of the Oracle Management Repository (mutually exclusive with `OMR_SERVICE_NAME`).	Example: `orcl` Leave this parameter blank if `OMR_CONNECT_STRING` or `OMR_SERVICE_NAME` is provided.
`OMR_SERVICE_NAME`	Mandatory	Service name of the Oracle Management Repository (mutually exclusive with `OMR_SID`).	Example: `orcl.example.com` Leave this parameter blank if `OMR_CONNECT_STRING` or `OMR_SID` is provided.

Optional Data Collector Parameters

The following are optional parameters required to install a data collector.

Parameter	Description	Notes
`OMR_USER_ROLE`	User role to connect to the Oracle Management Repository, such as `sysdba`.	Example: `sysdba`
`OMR_HOST_SSH_PORT`	Optional SSH port (default=`22`) on which the Oracle Management Repository host is configured to listen on.	Example: `22`
`NAMESPACE`	Namespace (default `host:port`) used to identify the data collector.	Example: `dcagent.test.example.com:1845`
`IGNORE_DATA_COLLECTOR_VALIDATIONS`	Flag to disable all data collector validations.	Valid values: `true` or `false`