Upgrade Guide

If you already have an installation of Colectica Portal and would like to upgrade to a newer version, follow these instructions.

See also

For detailed instructions on first-time installation, see Deployment Guide.

  1. View the current Configure System Prerequisites to see if any new framework versions are required.

  2. Download and extract the latest ColecticaCorePortal-version.zip file.

  3. Stop the Colectica Portal IIS site.

  4. Back up your appsettings.json and files in the Config directory.

  5. Copy the new ColecticaPortal directory contents into your existing ColecticaPortal deployment directory, overwriting all of the existing files.

    Do not delete your existing directory; your existing configuration files will stay in place.

  6. Restart the Colectica Portal IIS site.

  7. Using your browser, test to ensure you have access to the portal.

Upgrading from Releases Earlier than 5.5.*

Starting with version 5.5, we recommend using a newer .net framework.

  1. Colectica Portal runs best on the .NET Framework SDK 4.7.2 or higher. The NDP472-DevPack-ENU.exe can be downloaded from https://go.microsoft.com/fwlink/?LinkId=874338

Upgrading from Releases Earlier than 5.4.*

Starting with version 5.4, the deployment directory layout changes slightly, and a new dependency is added.

  1. Inside the PortalDir, delete the refs/ directory.
  2. Colectica Portal requires the .NET Framework SDK 4.6.1 or higher. The NDP461-DevPack-KB3105179-ENU.exe can be downloaded from https://www.microsoft.com/en-us/download/details.aspx?id=49978

Upgrading from Releases Earlier than 5.3.6233

Starting with version 5.3.6233, the all Colectica Portal now builds using .NET 4.6.1. Perform these additional steps

  1. Ensure that the Microsoft .NET Framework SDK 4.6.1 or higher is installed. NDP461-DevPack-KB3105179-ENU.exe can be downloaded from https://www.microsoft.com/en-us/download/details.aspx?id=49978.
  2. Ensure that the latest .NET Core Windows Server Hosting Bundle is installed. DotNetCore.1.0.4_1.1.1-WindowsHosting.exe can be downloaded from https://go.microsoft.com/fwlink/?linkid=844461.
  3. If using Postgres, the Postgres connection string has changed slightly and should be updated in the appsettings.json. See the new format in Database, Search, and Cache Configuration

Upgrading from Releases Earlier than 5.2.5635

Starting with version 5.2.5635, the Colectica Portal deployment package uses a simplified folder structure and has some different prerequisites. Follow these steps when upgrading from an earlier version to 5.2.5635 or higher. After upgrading using these steps, subsequent upgrades can be performed using the basic steps above.

  1. Install the .NET Core Windows Server Hosting Bundle. DotNetCore.1.0.4_1.1.1-WindowsHosting.exe can be downloaded from https://go.microsoft.com/fwlink/?linkid=844461
  2. After installing the bundle, execute iisreset at the command line or restart the server to pick up changes to the system PATH.
  3. Instead of overwriting your existing deployment files, deploy the Colectica Portal package to a new location.
  4. From your old location, copy the PortalDir\approot\packages\Colectica.Portal\1.0.0\root\appsettings.json to the root of your new deployment directory.
  5. Edit the Physical Path of your IIS web site to point to the deployment location. This should no longer end in wwwroot like the earlier versions did.
  6. Restart the IIS site and confirm that you can connect to your site using a web browser.
  7. Once you confirm everything is working, you may remove your old deployment files.