This article describes the options used by the drManager utility to reference a device repository in the different types of storage. An operation that requires a storage reference must have one and only one reference to the storage.
This article describes the options used by the drManager utility to reference a device repository in the different types of storage. An operation that requires a storage reference must have one and only one reference to the storage.
| Parameter | Short | Description | Usage |
|---|---|---|---|
| --directory | -d | The path to the directory in which the device repository is stored. | Required |
There are two mutually exclusive ways to specify the JDBC data source in which the repository is stored: by explicit JDBC URL, or by a set of parameters from which the URL is constructed.
The authentication options are only needed if the database has been configured to require authentication before allowing access. Please note that some driver vendors may allow them to be specified only via the JDBC URL, in which case they can be specified in the --jdbc-url option.
The usage setting for the options applies only if one or more of the required options in each set is specified, otherwise it is treated as optional.
| Parameter | Short | Description | Usage |
|---|---|---|---|
| URL datasource | |||
| --jdbc-url | The vendor specific JDBC URL. | Required | |
| --jdbc-driver | The fully qualified name of the vendor specific Java class that will recognize and handle JDBC URLs of the form provided to the --jdbc-url option. | Required | |
| Parametrized datasource | |||
| --jdbc-vendor | Vendor of the database repository. The allowable values are:
|
Required | |
| --jdbc-host | The host to which the JDBC driver must connect in order to access the database. | Required | |
| --jdbc-port | The port to which the JDBC driver must connect in order to access the database. It is optional, if the driver vendor has a default port; otherwise it is required. | Optional | |
| --jdbc-source | The name of the partition of the referenced database in which the device repository is stored. The exact meaning of this is vendor specific, e.g. for Oracle it is either the SID or the SERVICE depending on the vendor. | Required | |
| Authentication options | |||
| --jdbc-user | The user ID to be used to access the database. | Required | |
| --jdbc-password | The password for the user accessing the database. | Required | |
| Project options | |||
| --jdbc-project | The name of the project (partition) within the data source that contains the device repository. This option is always required for JDBC-based repositories. | Required | |
| Driver class path | |||
| --jdbc-driver-path | A colon-separated list of paths to JAR archives, ZIP archives, or class directories from which the driver class can be loaded. This option is always required for JDBC-based repositories. | Required |
MCS does not provide JDBC drivers. Administrators must use those recommended by the database documentation.