How to Upgrade Docentric AX Models

To upgrade the product to a newer version, you will use the same Docentric AX models. The procedure is exactly the same as Installing the product via models, except you will perform REPLACE instead of IMPORT of Docentric AX models by using the ModelUtil.exe tool.

Note that 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 Core product models (Docentric AX, Docentric AX Extension and Docentric AX Emails) regularly, since many new product features and bug fixes are shipped with new releases. However, before upgrading Additional models (Docentric AX SSRS Replicas and Docentric AX CBD Replicas), learn about Docentric Replicas Upgrade Strategy first.

Replacing Docentric AX models using ModelUtil

Follow the steps below to complete the upgrade.

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 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