Initializing a database

You can initialize a database for DCM use from the CLI only. DCM initialization requires exclusive access to the database. During DCM initialization, users are excluded from performing operations in the database. Establish a good time to exclude users from the database. The longer a database has been in use, the longer DCM initialization takes.

The following example describes how to initialize a database for DCM use.

  1. Start a CLI session in single user admin mode. Users can keep clients running, but cannot perform modifications to the database until the single user admin mode session is terminated.
  2. Perform a ccm dcm -init command, specifying the unique DCM database identifier.
  3. Perform a ccm stop command to terminate the session and release the database from single user admin mode.

Before you begin

Choose a DCM database identifier that is unique in the DCM cluster.

A DCM requirement is that the database has common database properties and common database parameters with other databases in the cluster. See Establish common database properties and Establish common database parameters for details.

Start a CLI session in single user admin mode and set your role to ccm_admin.

About this task

ccm dcm -init -dbid|-database_id database_id 
              [-delim|-delimiter dcm_delimiter]
              [-desc|-description description]
              [-location location]
              [-admin_info admin_info]
-admin_info admin_info
Specifies details of the administrators of the database. The information might contain names and contact details so that users across the cluster can contact the administrators of this database.
-dbid|-database_id database_id
Specifies the DCM database identifier to be used for a database. You must use this option if you are initializing a database not previously initialized for DCM use. If the database is DCM initialized, you can omit the option. If specified, the value must match the current database ID.
-delim|-delimiter dcm_delimiter
Specifies the DCM delimiter to be used. The delimiter must be a single character that is distinct from the version delimiter. When initializing a database for the first time, the default is "#". If the database is DCM initialized, the specified delimiter must match the current DCM delimiter.
-init
You must use the -dbid option to initialize a database that was not previously initialized for use with DCM. If the database was initialized for use with DCM, you can omit -dbid.
If you specify -dbid, the value must match that of the current database ID. Similarly, when you use the -init option to reinitialize a DCM database, the -delim option, if specified, must match that of the current database.
-location location
Specifies the geographic location of this database. Users across the DCM cluster can see where this database is hosted.

Feedback