Upgrading from TPC 5.2 to TPC 5.3

 
  • 1. Prerequisites
  • 2. Preparing for Upgrade
  • 3. Installation
  • 4. Licensing
  • 5. Configuration
  • 6. Release Notes     

Prerequisites

  • Sitefinity 11.2.6900 and above installed.
  • The Portal Connector 5.2 successfully installed on the Sitefinity site
  • A Portal Connector license applicable for the version you are upgrading to
  • Visual Studio 2017 or greater

Preparing for Upgrade

  1. We recommend that you take a backup of all the website files and a backup of the database (Refer to this article regarding how create a database backup).
  2. Identify the Sitefinity version of the target site. To do this, navigate to the Sitefinity backend, select Administration and then Version & Licensing.
    TPC 5.3 Licensing Page
  3. With this version, we’re able to download our Portal Connector release. Login to The Portal Connector website and navigate to the downloads page.
  4. On the left-hand side, select the version you want, in this case we’re upgrading to TPC 5.3.
    TPC Downloads Page
  5. Download the release appropriate to your Sitefinity version from Step 2.

If your version is not found in the list, The Portal Connector is either not supported for that release of Sitefinity or in the case of a recent Sitefinity release, we’re still testing the release with the latest Portal Connector version. For all questions about versioning please contact support@crmportalconnector.com

Installation

  1. Navigate to your Sitefinity site's installation directory in File Explorer.
  2. Extract the contents of the zip file you downloaded previously into the bin folder, overwrite all changes.
    Upgrade TPC bin folder
  3. The site has now been upgraded to TPC 5.3.

Licensing

This section will show you how to apply your new license to your upgraded Portal Connector installation. For more information on licensing please contact sales at info@crmportalconnector.com

You can read The Portal Connector End-User License Agreement here: https://www.crmportalconnector.com/license/eula.pdf

  1. Navigate to the license keys page on The Portal Connector web portal found here.
  2. Select View Keys next to the portal where you wish to install the license.
  3. On the next page, click View on the appropriate TPC version for your installation.
  4. Copy the contents of the License Key in the text box to your clipboard.
  5. Log in to the Sitefinity backend of your portal.
  6. Under the Administration menu, select Portal Connector Licensing.
    installation-11
  7. Paste the license key from your clipboard into to the license text area.
  8. Click Update License.
    installation-12
  9. If the correct license was copied, the Portal Connector will be licensed with a valid license

Configuration

To configure the Environment, please follow the setup steps in the link below:

Release Notes

Review the Release Notes for breaking changes and take the appropriate actions: