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

modelutil -replace -metadatastorepath=[path of the metadata store]
-file=[full path of the file to import]

1 2	modelutil -replace -metadatastorepath=[path of the metadata store] -file=[full path of the file to import]

Example:

modelutil -replace -metadatastorepath="C:\AOSService\PackagesLocalDirectory"
-file="C:\Temp\DocentricAX\Docentric AX.axmodel"

modelutil -replace -metadatastorepath="C:\AOSService\PackagesLocalDirectory"
-file="C:\Temp\DocentricAX\Docentric AX Extension.axmodel"

modelutil -replace -metadatastorepath="C:\AOSService\PackagesLocalDirectory"

-file="C:\Temp\DocentricAX\Docentric AX.axmodel"

modelutil -replace -metadatastorepath="C:\AOSService\PackagesLocalDirectory"

-file="C:\Temp\DocentricAX\Docentric AX Extension.axmodel"

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:

Upgrade Docentric AX models on UDE environment

To upgrade Docentric AX models on a UDE (Unified Developer Expierience) environment, use the same procedure as for one-box environments, which is described above.

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.

CONTENTS

How to Upgrade Docentric AX Models

IN THIS ARTICLE

Upgrade Strategy

Upgrade Docentric AX when using TFS (Azure DevOps)

Upgrade Docentric AX models with scripts

Upgrade Docentric AX models manually

Upgrade Docentric AX models on UDE environment

Troubleshooting

See also

IN THIS ARTICLE