AX Client - Synchronize database Synchronizes the database of an AX environment

AX Client - Synchronize database
AX Client - Synchronize database
Topic Work with AX client (AX 2009/2012)
Description Synchronizes the database of an AX environment
Category Build
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 documentation https://technet.microsoft.com/en-us/library/aa548671.aspx
Parameter: Run mode
Description How 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".
Type Picklist
Required True
Default value Direct
Parameter: Client config file path (.axc)
Description The file path of the client configuration file.
Type File path
Required True
Default value
Dependency Only visible if Run mode is not "Batch"
Example value $/Microsoft Dynamics AX (Test)/Client.axc
Parameter: Synchronize database
Description Should the database synchronized?
Type Boolean
Required False
Default value True
Dependency Only visible if Run mode is not "Classic"
Parameter: Synchronize tasks
Description Should the tasks synchronized?
Type Boolean
Required False
Default value True
Dependency Only visible if Run mode is not "Classic"
Parameter: Synchronize roles
Description Should the roles synchronized?
Type Boolean
Required False
Default value True
Dependency Only visible if Run mode is not "Classic"
Parameter: Synchronize runtime model
Description Should the runtime model synchronized?
Type Boolean
Required False
Default value True
Dependency Only visible if Run mode is not "Classic"
Parameter: Log file path (*.log)
Description The file path to save the log file to.
Type File path
Required True
Default value
Dependency Only visible if Run mode is "Direct"
Example value $/Microsoft Dynamics AX (Test)/MyAutorunLogFile.log
Parameter: Database only
Description Should only the database synchronized?
Type Boolean
Required False
Default value False
Dependency Only visible if Run mode is "Classic"
Parameter: Delete AX log files
Description Deletes the ax log files before the synchronisation of the AX database starts.
Type Boolean
Required False
Default value True
Dependency Only visible if Run mode is not "Batch"
Parameter: Max wait time (min)
Description The number of minutes to wait before failing the step.
Type Integer
Required False
Default value 120
Dependency Only visible if Run mode is not "Batch"
Parameter: AutoRun file path (*.xml)
Description The autorun file to append the build step to.
Type File path
Required True
Default value
Dependency Only visible if Run mode is "Batch"
Example value $/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.


Go back