WiscWeb - Upgrading Redirection Database

From time-to-time, Redirection plugin updates require that users upgrade their database in order for them to complete. These steps will need to be followed by an administrator on your project, if you are using the Redirection plugin.  

Backup Your Redirects

The Redirection plugin has a nice option for downloading a backup of your redirects. We encourage you to utilize this option as we cannot promise that the upgrade will not affect what you've already built out.

  1. Navigate to Tools > Redirection
  2. At the top of the page, you should see a message titled Redirection database needs upgrading
  3. Within the message, there is a link for "downloading a backup"
  4. Click on the link

    Screenshot of Redirection plugin update message

  5. A new tab may open and your browser will begin downloading a .json file of your redirects. Save this file locally, in case you need it later.

**If you find that the update changes your redirects in any way, you can import the .json file to reset your redirects.

Upgrade Database

The next step is to update the database.

  1. While still viewing your Redirection landing page (Tools > Redirection), click on the blue Upgrade Database button in the note at the top of the page

    Redirection plugin update message with an arrow to the upgrade button

  2. Your site will run through the updates
  3. Eventually, your screen will show a Progress: 100% message
  4. Click on the blue Finished! button

Screenshot of successful update message from Redirection plugin in WiscWeb

Import a .json Backup File (optional)

If you noticed that your redirects are not working as expected after this upgrade, you can try importing the .json file that you downloaded initially:

  1. Navigate to Tools > Redirection
  2. Select the Import/Export link at the top of the page

    List of links with the "Import/Export" option highlighted

  3. In the Import area, choose Add File

    Import option within the Redirection plugin

  4. Search for your locally stored .json file and upload it

See Also:

Keywords:upgrade, redirection, redirects, plugin, update, database, version, update   Doc ID:108993
Owner:Jenna K.Group:WiscWeb CMS
Created:2021-02-11 10:36 CDTUpdated:2023-05-12 15:52 CDT
Sites:DoIT Help Desk, WiscWeb CMS
Feedback:  1   1