---
schema_version: "1"
id: 817c1903c7cfad2f197b025ded79fd8f9236412dc2b27c4a042896e389dcff34
title: Upgrading and Migrating SAP S/4HANA SOAP Connector to 2.x
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/sap-s4hana-soap-connector/latest/sap-s4hana-soap-connector-upgrade-migrate.md
canonical_url: https://docs.mulesoft.com/sap-s4hana-soap-connector/latest/sap-s4hana-soap-connector-upgrade-migrate
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 779e4a407b70382f29da1bdbce59c4a60d004c8a15011d418caa3931ee9890a3
description: MuleSoft Documentation Site
release: "2.6"
latest: true
---
---
product: SAP S/4HANA SOAP Connector
version: 2.6
is-latest-version: true
---

# Upgrading and Migrating SAP S/4HANA SOAP Connector to 2.x

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Upgrade Anypoint Connector for SAP S/4HANA SOAP to take advantage of the increased security offered
by using OAuth 2.0 authentication to connect to SAP S/4HANA SOAP.

## Supported Upgrade Paths

This is a direct upgrade from version 1.0.0 version to 2.x.x.

<table><colgroup><col> <col></colgroup><thead><tr><th>From Version</th><th>To Version</th></tr></thead><tbody><tr><td><div><div><p>1.0.0</p></div></div></td><td><div><div><p>2.x.x</p></div></div></td></tr></tbody></table>

## Changes in This Release

- OAuth 2.0 is supported.  
  The **OAuth 2.0 Application Connection Provider** option has been added to **Connection** types.
  For information about the configuration parameters for this connection type, see
  [SAP S/4HANA SOAP Connector Reference](https://docs.mulesoft.com/sap-s4hana-soap-connector/latest/sap-s4hana-soap-connector-reference).

- Mule runtime engine (Mule) 4.2.1 or later is required.

- The base package name has been changed to `com.mulesoft.connector.sap.s4hana.soap` so that all
  exported classes now have different fully qualified names.

## Requirements and Limitations

Be aware of the following requirements and limitations before you upgrade to the latest version.

### Requirements

You must be using Mule 4.2.1 or later.

### Limitations

This upgrade breaks backward compatibility.

## Upgrade Prerequisites

Before you upgrade, create a backup of your files, data, and configurations in case you need to
restore to them.

## Upgrade Steps

Follow these steps to perform the upgrade:

1.  In Anypoint Studio, create a Mule project.

2.  In **Mule Palette**, click **Search in Exchange**.

3.  In **Add Dependencies to Project**, enter `SAP S/4HANA SOAP` in the search field.

4.  In **Available modules**, select **SAP S/4HANA SOAP Connector** and click **Add**.

5.  Click **Finish**.

6.  Verify that the `mule-sap-s4hana-soap-cloud-connector` dependency version is the one you are
    upgrading to in the `pom.xml` file in the Mule project.

Studio upgrades the connector automatically.

## Post Upgrade Steps

After you install the latest version of the connector, verify the upgrade:

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

2.  Verify that there are no problems in the project `pom.xml` file.

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

## Troubleshooting

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

## Revert the Upgrade

If you must revert to your previous version of SAP S/4HANA SOAP Connector, change the
`mule-sap-s4hana-soap-cloud-connector` dependency version 2.x.x in the project’s `pom.xml` to the
previous version.

## See Also

[Salesforce Help](https://help.salesforce.com)