---
title: Upgrade an existing connector
description: Before stopping the PingFederate server to upgrade the Box Connector, access the Attribute Mapping screen for existing channel configurations and note the current configuration.
component: box
page_id: box:setup:pf_box_connector_upgrade_an_existing_connector
canonical_url: https://docs.pingidentity.com/integrations/box/setup/pf_box_connector_upgrade_an_existing_connector.html
revdate: June 27, 2024
section_ids:
  steps: Steps
---

# Upgrade an existing connector

## Steps

1. Before stopping the PingFederate server to upgrade the Box Connector, access the **Attribute Mapping** screen for existing channel configurations and note the current configuration.

   |   |                                                                                                                                                                             |
   | - | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   |   | The upgrade process removes existing mappings and defaults on the **Attribute Mapping** screen. These must be configured again before activating the channel configuration. |

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

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

4. Stop the PingFederate server if it is running.

5. Unzip the new Box Connector distribution `.zip` archive into a holding directory.

6. Remove any older versions of `pf-box-quickconnection-[version].jar` from: `<pf_install>/pingfederate/server/default/deploy`

7. From the `dist` directory of the new version of the connector, copy the `pf-box-quickconnection-[version].jar` file into the `<pf_install>/pingfederate/server/default/deploy` directory.

8. Start the PingFederate server.

9. Create a new SP connection, using **Box Connector** as the connection template.

10. Follow the instructions in [Configure provisioning](pf_box_connector_configure_provisioning.html) and [Updating Box OAuth tokens](../troubleshooting/pf_box_connector_updating_box_oauth_tokens.html) to configure the connection.

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

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

13. When you have completed the attribute configuration, click **Done**, **Done**, and **Save**.

14. Activate the SP connection to resume outbound provisioning.