---
title: Upgrading existing Dropbox connectors
description: Before stopping the PingFederate server to upgrade the Dropbox Connector, on the Attribute Mapping tab for existing channel configurations, record the current configuration.
component: dropbox
page_id: dropbox:setup:pf_dropbox_connector_upgrading_existing_dropbox_connectors
canonical_url: https://docs.pingidentity.com/integrations/dropbox/setup/pf_dropbox_connector_upgrading_existing_dropbox_connectors.html
revdate: June 11, 2024
section_ids:
  steps: Steps
---

# Upgrading existing Dropbox connectors

## Steps

1. Before stopping the PingFederate server to upgrade the Dropbox Connector, on the **Attribute Mapping** tab for existing channel configurations, record the current configuration.

   |   |                                                                                                                                                                          |
   | - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
   |   | The upgrade process removes existing mappings and defaults on the **Attribute Mapping** tab. You must configure these again before activating the channel configuration. |

2. Disable the existing service provider (SP) connection where the Dropbox Connector is configured.

3. Delete the existing Dropbox Connector SP connection and save.

4. Stop the PingFederate server if it is running.

5. Extract the Dropbox Connector distribution `.zip` archive into a holding directory.

6. Remove any versions of `pf-dropbox-quickconnection-.x.jar` from the `<pf_install>/pingfederate/server/default/deploy` directory.

7. Remove the following files from the same directory if they are present:

   * `pf-dropbox-oauth-helper.war`

   * `gson-2.2.4.jar`

8. From the `/dist` directory of the new version of the connector, copy the `pf-dropbox-quickconnection-2.0.jar` to the `<pf_install>/pingfederate/server/default/deploy` directory.

   |   |                                                                   |
   | - | ----------------------------------------------------------------- |
   |   | Make sure to remove existing versions of Dropbox Connector files. |

9. Start the PingFederate server.

10. Create a new SP connection using Dropbox as the connection template.

11. Follow the instructions in the [Creating a connection](pf_dropbox_connector_creating_a_connection.html) section to configure Metadata and OAuth.

12. Access the Attribute Mapping for existing channel configurations and click **Refresh Fields**.

13. Ensure all new required fields, if any, are mapped appropriately or have a default value.

14. When you have finished the attribute configuration, click **Done**, **Done**, and **Save**.

15. Click the toggle to activate the SP Connection to resume outbound provisioning.