Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

You can use the forceSync command to force the resynchronization to DMC DB using the files that are currently active in the workspace. The command will help to resynchronize the changelog with the DMC backend and to correct the issues with status of issues that may arise when an old or non-standard version of the changelog has been used to determine the status.

Using forceSync in your CLI

Before running the forceSync command in the CLI, perform the following:

Create a new project or use the existing project with the dbDef and dmcDbDef connected. See dbDef, dmcDbDef, and Force Sync.

Enable runtime credentials.

...

Prerequisites for using Force Sync

  • The forceSync command must be in the context of a project that is already registered with the Deployment Monitoring Console. Configuring a Project to Use the DMCDB

  • If the project is configured to use Runtime Credentials, ensure that the appropriate environment variables are set with credentials for the DMCDB

    • DMC environment variables

Code Block
DDB_DMCDB_USER=<DMCDB username>
DDB_DMCDB_PASS

DDB_AUDIT_USER
DDB_AUDIT_PASS
  • DBDEF environment variables

Code Block
DDB_USER_<dbDefNameHere>
DDB_PASS_<dbDefNameHere>

For example:

DB_USER_REF1
DB_PASS_REF1
 
DB_USER_DEV
DB_PASS_DEV
 
DB_USER_QA
DB_PASS_QA

DB_USER_PROD
DB_PASS_PROD
Info

Since your project should be registered with DMC, refer to Register your Project with DMC for more information.

2. To run the forceSync command, open your CLI and enter the following:

Code Block
hammer =<DMCDB password>

Executing the forceSync command in the CLI

To run the forceSync command, open your CLI and enter the following:

Code Block
# Change to the project directory
cd /path/datical/myProject

# Execute the Command
hammer forceSync

or use the --project CLI parameter to indicate the project for which you want to run the command without changing directory

Code Block
languagebash
hammer --project=<path to your project> forceSync

Using Force Sync in

...

the GUI

To use the Force Sync capability in the Datical DB GUI, perform the following:

  1. Ensure you have the dbDef and dmcDbDef connected to your project. See dbDef, dmcDbDef, and Force Sync.

  2. Set environment variables for dbDef and dmcDbDef. Supported variables are:

  • DMC environment variables

Code Block
DDB_DMCDB_USER
DDB_DMCDB_PASS

DDB_AUDIT_USER
DDB_AUDIT_PASS
  • DBDEF environment variables

Code Block
DDB_USER_<dbDefNameHere>
DDB_PASS_<dbDefNameHere>

For example:

DB_USER_REF1
DB_PASS_REF1
 
DB_USER_DEV
DB_PASS_DEV
 
DB_USER_QA
DB_PASS_QA

DB_USER_PROD
DB_PASS_PROD

...

  1. Choose the needed project and go to Settings located above the Console tab.

...

4 2. Select DMC Database, and then select Force Sync.

...