Upgrading from TPC 5.1 to TPC 5.2 (NuGet)

 
  • 1. Prerequisites
  • 2. Preparing for Upgrade
  • 3. Installation
  • 4. Licensing
  • 5. Updating Dynamics CRM Solution
  • 6. Configuration
  • 7. Additional Steps

Prerequisites

  • Sitefinity 13.0.7300 and above installed.
  • The Portal Connector 5.1 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 6.0 Licensing Page
  3.  In Visual Studio, Navigate to Tools -> NuGet Package Manager -> Package Manager Settings. Click on the + icon in package sources and add the name and Source of NuGet packages.
  4. Name: The Portal Connector
  5. Source:   https://nuget.portalconnector.com/index.json  
    TPCsource
  6. Click OK and it will add the TPC NuGet Package feed to your Visual Studio. 

Installation

  1. In the Solution Explorer in Visual Studio on the right-hand side, right-click References and then click Manage NuGet Packages…
    NuGetInstall1
  2. In the NuGet Package Manager select the package source The Portal Connector set in step 4 of Preparing for Upgrade.
    NuGetInstall2
  3. If you want to upgrade the Sitefinity version of your project, upgrade the Sitefinity.All NuGet package now.
  4. Find the PortalConnector.All package that matches your current TPC and Sitefinity version and click the Install/Update button. If you are developing against a class library rather than a Sitefinity site, you can install the PortalConnector.Core package.
    NuGetInstall3

    The Portal Connector package versions follow a standard convention. We can look at the following example to understand that convention.

    Example: PortalConnector.All - 6.2.130.101

    6.2 – This indicates that the package is for The Portal Connector version 6.2.

    130 – This indicates that the package is for Sitefinity 13.0 (Any patch version).

    101 – This indicates that the package is Revision 101.

  5. In order to utilize the latest Razor templating features, The Portal Connector utilizes the package Microsoft.CodeDom.Providers.DotNetCompilerPlatform. This package should modify the web.config when it is installed with the product, although in some cases the web.config will not be modified. Verify that the following code has been added within the configuration element of the web.config, or add it manually.

    <system.codedom>
      <compilers>
            <compiler language="c#;cs;csharp" extension=".cs" type="Microsoft.CodeDom.Providers.DotNetCompilerPlatform.CSharpCodeProvider, Microsoft.CodeDom.Providers.DotNetCompilerPlatform, Version=2.0.1.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" warningLevel="4" compilerOptions="/langversion:default /nowarn:1659;1699;1701" />
            <compiler language="vb;vbs;visualbasic;vbscript" extension=".vb" type="Microsoft.CodeDom.Providers.DotNetCompilerPlatform.VBCodeProvider, Microsoft.CodeDom.Providers.DotNetCompilerPlatform, Version=2.0.1.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" warningLevel="4" compilerOptions="/langversion:default /nowarn:41008 /define:_MYTYPE=\&quot;Web\&quot; /optionInfer+" />
        </compilers>
    </system.codedom>
    
  6. If you intend to use the PowerBI Add-on with TPC version 5.2, you must add the following assembly to the web.config at the following location configuration > system.web > compilation > assemblies.

    <add assembly="System.Runtime, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
    
    
  7. Once the package has been installed to your Sitefinity project, Rebuild your solution in Visual Studio. The project should be ready to run!

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

Updating Dynamics CRM Solution

To update the TPC Dynamics solution, log into your Portal Dashboard and navigate to Administration > Portal Connector Configuration > General Settings, then click on Install CRM Solution.

TPC_install_CRM_solution

Configuration

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

Additional Steps

Review the breaking changes and take the appropriate actions: