How to Upgrade Docentric AX Models

To upgrade the product to a newer version, you will use the same Docentric AX models as for installation and which you can download from Docentric Download Center.

The Docentric AX models contain complete Docentric AX solution and there are no external dependencies or services to reinstall or upgrade.

Download Docentric AX models >>
Read the complete Docentric AX change log >>

Upgrade Strategy

We recommend updating of all Docentric AX models regularly, since new product features and bug fixes are shipped with new releases. However, before upgrading the Docentric AX SSRS Replicas model, please first check Docentric SSRS Replicas Upgrade Strategy.

Upgrade Docentric AX when using TFS (Azure DevOps)

If you keep the Docentric AX models under TFS (Azure DevOps) version control, we recommend the following upgrade procedure, instead of the upgrade with scripts or manual upgrade described below.

Upgrade Docentric AX with scripts

We don’t recommend upgrade with scripts if you are using TFS (Azure DevOps).
Check the recommended upgrade procedure when using TFS >>

To upgrade Docentric AX models you can use the scripts from the downloaded ZIP packages:

  • DocentricAXInstallCoreModels.cmd, DocentricAXInstallSSRSReplicasModel.cmd and DocentricAXInstallCBDReplicasModel.cmd to replace the models,
  • DocentricAXBuildAndSyncTool.cmd to build the models and synchronize the database.

Alternatively, you can follow the instructions below to complete the upgrade procedure step-by-step.

Upgrade Docentric AX manually

We don’t recommend manual upgrade if you are using TFS (Azure DevOps).
Check the recommended upgrade procedure when using TFS >>
We recommend to stop (1) IIS Server in IIS Manager and (2) Microsoft Dynamics 365 Unified Operations: Batch Management Service in Computer Management, before the upgrade takes place.

Run Command Prompt as Administrator and navigate to the Bin directory of your Packages folder, typically C:\Packages\Bin or C:\AosService\PackagesLocalDirectory\Bin.

Execute the ModelUtil.exe command for replacement of Docentric AX models:

Example:

After the Docentric AX models are replaced, build the models and synchronize the database.

If you have Visual Studio open while replacing the models, you need to refresh them before you start the build:

Troubleshooting

If you experience any issue during replacing the models, stop IIS server in IIS Manager, or at least the AOSService application and try to replace them again. Also, stop Microsoft Dynamics 365 Unified Operations: Batch Management Service in Computer Management.

 

After that, retry to replace the Docentric AX models, by using the ModelUtil.exe tool as described above.

See also

How to Commit Changes to TFS/DevOps After Upgrading Docentric AX Models >>
How to Install Docentric AX via Models >>
How to Set Up Docentric AX >>

IN THIS ARTICLE