---
schema_version: "1"
id: 9a4e5a34f47a13230ee99747690ef59f86c67fa6da0004e0918f68759c1f1b63
title: Upgrading and Migrating WSS Module to Version 2.0
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/wss-module/2.0/wss-module-upgrade-migrate.md
canonical_url: https://docs.mulesoft.com/wss-module/2.0/wss-module-upgrade-migrate
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 170e56436f56ef1e75686119150e072aa2b4228cd4ee4418bc1684d31290256e
description: MuleSoft Documentation Site
release: "2.0"
latest: false
---
---
product: WSS Module
version: 2.0
---

# Upgrading and Migrating WSS Module to Version 2.0

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

Upgrade WSS Module to version 2.x.

## Supported Upgrade Paths

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

## Changes in This Release

WSS Module 2.0 includes these changes.

- WSS Module (and its dependencies) are now compilable and compatible only with Java 17.

- To align with modern development practices and ensure continued compatibility with secure and
  supported libraries, WSS Module is upgraded from Spring 5.x to Spring 6.x.

- In the **Encryption Config** type, the `EMBEDDED_KEY_NAME` option has been removed from the
  **Encryption Key Identifier** field.

## Upgrade Prerequisites

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

## Upgrade Steps

Follow these steps to perform the upgrade:

1.  In Anypoint Studio, right-click the project and select **Manage Dependencies** > **Manage
    Modules**.

2.  Select `Web Service Security Module` and click **Update version**.

3.  Click **Apply and Close**.

4.  Verify that the WSS Module dependency version is `2.0.0` in the `pom.xml` file in the Mule
    project.

Alternatively, you can manually update the WSS Module dependency version in the `pom.xml` file in
the Mule project, or simply add the updated module to the project.

### Verify the Upgrade

After you upgrade 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.  Verify that there are no problems in the project `pom.xml` file.

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

## Troubleshoot

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

### Revert the Upgrade

If it is necessary to revert to the previous version of WSS Module, change the WSS Module dependency
version `2.0.0` in the project’s `pom.xml` to the previous version.

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

## See Also

- [Introduction to Anypoint Connectors](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)

- [WSS Module Reference](https://docs.mulesoft.com/wss-module/2.0/wss-reference)

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