AX7 – Database Synchronization w/o Visual Studio

Some time ago I wrote about the ways to perform a database synchronization from Visual Studio in the new Microsoft Dynamics AX. Clearly this relates to development environments. Here’s one way to do a synchronization without VS – you’ll need it when you have a deployed environment.

Ready-to-execute PowerShell script

Usually when you need to synchronize you have worked with a deployable package before to bring in a customization. Running the workbook and applying the package obviously does a full database synchronization in a straight forward scenario you wouldn’t need to do it again. But in some cases you certainly face the need to do it (in my case I had to restore a standard AX database backup and do the synchronization only to bring back the extension tables from the deployed add-on solution). But the script that is used by the runbook has to be there, right? It is – in the runbook there is a step that executes AutoDeployReportAndSyncDB.ps1 and if you have a look into that one you’ll find that the database sync is performed by a script named AutoDBSync.ps1. It’s located in the \AOSService\Scripts folder of the deployable package. Make sure to run PowerShell as administrator 🙂

Database Synchronization without Visual Studio


Of course you can use the executable that is used by the script directly. The one that is used for db sync is Microsoft.Dynamics.AX.Deployment.Setup.exe. It is located in I:\AosService\WebRoot\bin\ (Azure deployed VM) or C:\Packages\bin\ (locally deployed virtual machine). As of now I can only tell you about the parameters and values the automatic script uses so the syntax might not be complete and there is no information about different uses than full database synchronization.

I:\AosService\WebRoot\bin\Microsoft.Dynamics.AX.Deployment.Setup.exe -bindir "I:\AosService\PackagesLocalDirectory" -metadatadir "I:\AosService\PackagesLocalDirectory" -sqluser "axdbadmin" -sqlserver "Demo-00000000" -sqldatabase "AxDB" -setupmode "sync" -syncmode "fullall" -isazuresql "true"

This is the full example for an Azure deployed virtual machine. You need to change at least the SQL Server address to the actual value but check the database name and the user, too. The paths are valid as of now, but I don’t know if they’ll change in future, so have an eye on them as well.
With locally deployed VMs the script generates a command looking like

C:\CustomerServiceUnit\Dobind\Packages\Cloud\AosWebApplication\AosWebApplication.csx\roles\AosWeb\approot\bin\Microsoft.Dynamics.AX.Deployment.Setup.exe -bindir "C:\Packages" metadatadir "C:\Packages" -sqluser "AOSUser" -sqlserver "." -sqldatabase "AxDBRAIN" -setupmode "sync" -syncmode "fullall" -isazuresql "false"

So as you can see there is a Microsoft.Dynamics.AX.Deployment.Setup.exe executable in that folder, too.

PS: If you’re wondering about the isazuresql parameter – I do so, too. The reason is that as far as I can see even Azure deployed VMs are using a locally installed SQL Server instance. I can only guess this gets important in future then.

6 thoughts on “AX7 – Database Synchronization w/o Visual Studio

  1. At the start of synchronization I get the following error:

    A connection was successfully established with the server, but then an error occurred during the login process. (provider: SSL Provider, error: 0 – The certificate chain was issued by an authority that is not trusted.)

    Any clue? This occured on a Azure-hosted AX7 VM, deployed by LCS.

      • It’s a single box without any modification to the default (template) architecture. Software: Server 2012R2, AX7 RTW, SQL 2016 CTP4.
        I’m trying to upgrade AX RTW to Update1 using my composed deployable package. While executing the runbook it failed at the synchronization step.
        I discovered the executable you’ve mentioned is being used for synchronization so I tried running the sync by running this command:

        Microsoft.Dynamics.AX.Deployment.Setup.exe -bindir “J:\AosService\PackagesLocalDirectory” -metadatadir “J:\AosService\PackagesLocalDirectory” -sqluser “my-sql-sa-account” -sqlpwd thisismypassword -sqlserver localhost -sqldatabase “AxDB” -setupmode servicesync -syncmode fullall -isazuresql “false”

        • It works for us as Paul mentioned on yammer (I guess it was you or a colleague of yours asking the same thing there). From my experience, only when you try to separate things you might run into those certificate issues. Often they can be solved by generating and applying self-signed certificates.

Leave a Comment