Get in touch

AX Client - Synchronize database

Synchronizes the database of an AX environment

TopicWork with AX client (AX 2009/2012)
CategoryBuild
Special features
  • Run options:
    • Classic (uses startupCmd)
    • Direct (uses Autorun file)
    • Batch (add to existing Autorun file and execute later)
  • Set synchronize database (optional)
  • Set synchronize tasks (optional)
  • Set synchronize roles (optional)
  • Set synchronize runtime model (optional)
  • Set max wait time (optional)
Microsoft documentationhttps://technet.microsoft.com/en-us/library/aa548671.aspx

Parameters

ParameterTypeRequiredDefaultExample
Run modeHow should the step be executed? Possible values are "Direct", "Classic" or "Batch". The option "Direct" will create and use an autorun file to execute the build step. The option "Classic" will use "StartupCmd" and the option "Batch" adds the build step to an existing autorun file. To execute the existing autorun file use the Build step "AX Client - Execute autorun xml file". To create an empty autorun file use the Build step "AX Client - Create empty autorun xml file".PicklistTrueDirect—
Client config file path (.axc)The file path of the client configuration file.Depends on: Only visible if Run mode is not "Batch"File pathTrue—$/Microsoft Dynamics AX (Test)/Client.axc
Synchronize databaseShould the database synchronized?Depends on: Only visible if Run mode is not "Classic"BooleanFalseTrue—
Synchronize tasksShould the tasks synchronized?Depends on: Only visible if Run mode is not "Classic"BooleanFalseTrue—
Synchronize rolesShould the roles synchronized?Depends on: Only visible if Run mode is not "Classic"BooleanFalseTrue—
Synchronize runtime modelShould the runtime model synchronized?Depends on: Only visible if Run mode is not "Classic"BooleanFalseTrue—
Log file path (*.log)The file path to save the log file to.Depends on: Only visible if Run mode is "Direct"File pathTrue—$/Microsoft Dynamics AX (Test)/MyAutorunLogFile.log
Database onlyShould only the database synchronized?Depends on: Only visible if Run mode is "Classic"BooleanFalseFalse—
Delete AX log filesDeletes the ax log files before the synchronisation of the AX database starts.Depends on: Only visible if Run mode is not "Batch"BooleanFalseTrue—
Max wait time (min)The number of minutes to wait before failing the step.Depends on: Only visible if Run mode is not "Batch"IntegerFalse120—
AutoRun file path (*.xml)The autorun file to append the build step to.Depends on: Only visible if Run mode is "Batch"File pathTrue—$/Microsoft Dynamics AX (Test)/MyAutorunFile.xml

Frequently Asked Questions

Error message "Failed to create a session; confirm that the user has the proper privileges…."

If you receive an error "Failed to create a session; confirm that the user has the proper privileges…." on database synchronisation, the blog post from Tom Branca under 5-tips-to-resolve-the-ax-error-failed-to-create-a-session-confirm-that-the-user-has-the-proper-privileges" shoud help you.