Running the Configuration Data Versioning tool

Use either the graphical user interface or command-line interface to run the Configuration Data Versioning (CDV) tool.

Attention: The Windows console displays WorkBench startup information. Do not close the console while the WorkBench is running. Closing the console closes the tool, and your work is lost.

Procedure

  • Run the CDV tool using the graphical user interface
    1. Start the Sterling™ Order Management System Software Development and Deployment WorkBench. On Microsoft Windows, run the ydk.cmd script for Windows (ydk.sh for UNIX/Linux) from the <INSTALL_DIR>\bin directory.
    2. From the Sterling™ Order Management System Software Development and Deployment WorkBench menu, choose Tools > Deployment > Configuration Data Version Deployment. The Configuration Data Version Tool Logon dialog box opens.
    3. Click the Source button and enter the values appropriate for the source database. Then, click the Target button and enter the values appropriate for the target database.

      Close the dialog box after you complete this step. The values you specified are saved automatically and persist from one session to the next.

      If you change the name of either source or target database, the transformation settings are lost. To get back your old transformation settings, revert to the old source and target database name.

      In the Source database and Target database windows, specify the applicable values as described in Table 1. Fields descriptions for logon dialog box.

    4. In the Logon dialog box, enter the passwords associated with the user names and Click OK.
    5. In the Compare screen, select a From Version Label and a To Version Label and click OK.

      The system compares the two database versions. Once the comparison is complete, the system displays the Comparison Results screen. The results are grouped by table name onscreen.

    6. To see the details for any record included in the results, right-click and select Details. The Conflict Details screen displays. For more information, see Table 2. Fields descriptions for Conflict details screen.
      • Modifications: The Record Details screen displays with a list of changed and unchanged attributes. For changed attributes, the old value and the new value will be displayed. (The old value is the existing value on the target database; new value is the value of the obtained change from the source database.)
      • Insertions: The Record Details screen displays with a list of attributes and their values to be inserted.
      • Deletions: The Record Details screen displays with a list of attributes of the entity.

      You can scroll through the records by using the Previous and Next buttons. When you are done reviewing the details for a record, click Close.

  • Run the CDV tool using the command-line interface
    1. Run cdtshell in MODE LABELDEPLOY. 
      ./cdtshell.sh -MODE LABELDEPLOY -FromLabel <Version_1> -ToLabel <Version_2> -ExportDir <EXPORT_DIR_PATH>