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 to take this approach for the upgrade.

Upgrade Docentric AX with scripts

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 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 Add Docentric AX Models to TFS >>
How to Install Docentric AX via Models >>
How to Set Up Docentric AX >>

IN THIS ARTICLE