Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info
titleCM Tool First Release

This is first official release of the Aptify Configuration Migration (CM) Tool. If you have any questions or problems using the tool please contact Aptify Technical Support. Your feedback is appreciated!

This topic describes the process for unpacking data entities and metadata using the Aptify Configuration Migration (CM) Tool.

Note

The Aptify Configuration Migration (CM) Tool must be installed on the destination Aptify database server before unpacking configurations. See Installing the Aptify CM Tool for more details.

...

Info
titleBest Practices When Using the CM Tool Unpacker
  • Run the validation rules on the pack settings before starting the unpacking action. See Understanding the CM Tool Validation Rules.
  • If any validation rule fails, go through the description the solution provided for the failed rule and try to fix the issue before starting the unpacking action. Possible solutions are provided for most rules.
  • The CM Tool provides the ability to remove unwanted entities or metadata using check boxes(by deselecting the appropriate check box). If you remove any entities or metadata from the packing in this mannerpack, be sure to validate those entities or metadata run the validation rules to ensure that they will not cause the unpacking to fail.

 

 

  1. Locate and double-click the CM Tool shortcut on the desktop of your source server. The following selection dialog will appear:
    • You can also open the tool by running the AptifyConfigurationMigrationUtility executable from the Aptify directory in which you installed the tool.
  2. Select the Unpacking option and click OK.In the Server field

    Image Added 
  3. If the CM Tool is configured to automatically log into the source server (that is the username and password is already specified in the CM Tool configuration file), the CM Tool Unpacker form will display. If the CM Tool is not configured to automatically launch, the Aptify login dialog will appear and the below steps need to be followed. 
    1. in the Server field, enter the name of the source Aptify database.
    2. In
    the
    1. the User Name
    and
    1.  and Password
    fields
    1.  fields, enter your user credentials for the Aptify system and
    click
    1. click OK.
    Image RemovedIn
    1.  
  4. Once logged in, the CM Tool Unpacker form, enter interface displays. Review the Server and Database specified Configuration information to make sure it appropriate.

    Unpacker FormImage Added
     
  5. Enter the Pack Path and Base Database information. See About the the Folder Selection Section for in About the CM Tool Unpacker Interface for more information.
  6. If

    desired

    needed, you can modify the

    unpacking settings

    items you wish to unpack using the Tree View section

    . See About the Tree View section for details.

    . For example, when unpacking a pack any entity or metadata, some of the entities or related users and groups may already be present on the destination Aptify database, those items are identified with a green check mark. These items are marked to aid the user in preventing an undesired overwriting of existing data.

    Note
    titleConcerning Removing Entities

    If you deselect an entity in the Tree View, and then re-select this entity in the Tree View, any links to other entities or dependent entities that were originally present are not re-linked. However, any related metadata and its sub-type entities are re-linked.

     

  7. In the Validation Summary tab, click Validate to test the validation rules.
    • If any of the rules should fail, update the unpacking settings to resolve the failure and re-run the validation.
    • If you find that additional validation rules need to be added for testing the unpacking settings, refer to the Understanding see Understanding the CM Tool Validation Rules section for  for more information.
       
  8. Click UnPack to start the unpacking action.