Contact Us 1-800-596-4880
  1. Homepage
  2. Microsoft Dynamics CRM Connector (4.0)

  3. Upgrading and Migrating Microsoft Dynamics CRM Connector

All Connectors

Upgrading and Migrating Microsoft Dynamics CRM Connector to 4.x

Upgrade Anypoint Connector for Microsoft Dynamics CRM (Microsoft Dynamics CRM Connector) from version 3.x to version 4.x.

Supported Upgrade Paths

From Version To Version

3.x

4.x

Changes

4.0

  • This connector is now compatible with Java 17 only.

  • The connector now uses Apache CXF 4.2.4, and web services classes move from the javax namespace to the jakarta namespace. Custom code that uses javax web services classes bundled with the connector must use jakarta.

  • The connector package no longer includes the legacy Microsoft Dynamics CRM 2015 WSDL code generation kit.

  • The connector now bundles the OpenSAML libraries, so it resolves from public repositories only.

  • These libraries are upgraded to address reported security vulnerabilities:

    • The jackson-core and jackson-databind libraries are upgraded to version 2.22.4.

    • The guava library is upgraded to version 33.8.0-jre.

    • The asm library is upgraded to version 9.11.1.

    • The bcprov-jdk18on, bcpkix-jdk18on, and bcutil-jdk18on libraries are upgraded to version 1.86.

    • The wss4j library is upgraded to version 2.4.4.

    • The xmlschema-core library is upgraded to version 2.3.3.

    • The httpclient5 library is upgraded to version 5.6.5.

    • The httpcore5 library is upgraded to version 5.4.4.

    • The woodstox-core library is upgraded to version 7.3.0.

    • The joda-time library is upgraded to version 2.15.1.

    • The neethi library is upgraded to version 3.2.4.

    • The commons-lang3 library is upgraded to version 3.21.0.

    • The commons-codec library is upgraded to version 1.23.0.

Requirements

Ensure your system meets the following compatibility requirements before you perform the upgrade:

Application/Service Version

Mule runtime

4.9.0 and later

Java

17

Dynamics CRM

2013, 2015, and 2016

Upgrade Prerequisites

Before you perform the upgrade, you must:

  1. Create a backup of your files, data, and configuration in case you need to restore to the previous version.

  2. Ensure that your environment meets the version 4.x requirements, including Java 17 and Mule runtime 4.9.0 or later.

  3. If your app uses javax web services classes bundled with the connector, update that code to use jakarta.

  4. If your app uses the Kerberos connection type, configure the CRM instance to support the aes128-cts-hmac-sha1-96 or aes128-cts-hmac-sha256-128 encryption types. Java 17 enforces these encryption types. You can set allow_weak_crypto to true in the krb5.conf file as a workaround. For more information, see Kerberos.

  5. Install Microsoft Dynamics CRM Connector 4.x to replace the connector operations that were previously included in Microsoft Dynamics CRM Connector 3.x.

Upgrade Steps

Follow these steps to perform the upgrade from Microsoft Dynamics CRM Connector 3.x to Microsoft Dynamics CRM Connector 4.x:

  1. In Anypoint Studio, create a Mule project.

  2. In the Mule Palette view, click (X) Search in Exchange.

  3. In Add Modules to Project, type crm in the search field.

  4. Click Microsoft Dynamics CRM Connector in Available modules.

  5. Click Add.

  6. Click Finish.

  7. Verify that the mule-microsoft-dynamics-crm-connector dependency version is 4.x.x in the pom.xml file, where x.x is the minor release and patch version number. For example, if you are upgrading to version 4.0, the dependency version in the pom.xml file should be 4.0.0.

Studio upgrades the connector automatically.

Verify the Upgrade

After you install the latest version of the connector, follow these steps to verify the upgrade:

  1. In Studio, verify that there are no errors in the Problems or Console views.

  2. Check the project pom.xml file and verify that there are no problems.

  3. Test the connection and verify that the operations work.

Troubleshooting

If there are problems with caching the parameters and caching the metadata, try restarting Studio.

Revert the Upgrade

If it is necessary to revert to the previous version of Microsoft Dynamics CRM Connector, change the mule-microsoft-dynamics-crm-connector dependency version in the project’s pom.xml file to the previous version.

You must update the project’s pom.xml file in Anypoint Studio.

See Also

Back to top