If you already have an installation of Colectica Portal and would like to upgrade to a newer version, follow these instructions.
For detailed instructions on first-time installation, see Deployment Guide.
View the current Configure System Prerequisites to see if any new framework versions are required.
Download and extract the latest
Stop the Colectica Portal IIS site.
Back up your
appsettings.jsonand files in the
Copy the new
ColecticaPortaldirectory contents into your existing
ColecticaPortaldeployment directory, overwriting all of the existing files.
Do not delete your existing directory; your existing configuration files will stay in place.
Restart the Colectica Portal IIS site.
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.
- Colectica Portal runs best on the .NET Framework SDK 4.7.2 or higher. The
NDP472-DevPack-ENU.execan 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.
- Inside the
PortalDir, delete the
- Colectica Portal requires the .NET Framework SDK 4.6.1 or higher. The
NDP461-DevPack-KB3105179-ENU.execan 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
- Ensure that the Microsoft .NET Framework SDK 4.6.1 or higher is installed.
NDP461-DevPack-KB3105179-ENU.execan be downloaded from https://www.microsoft.com/en-us/download/details.aspx?id=49978.
- Ensure that the latest .NET Core Windows Server Hosting Bundle is installed.
DotNetCore.1.0.4_1.1.1-WindowsHosting.execan be downloaded from https://go.microsoft.com/fwlink/?linkid=844461.
- 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.
- 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
- After installing the bundle, execute
iisresetat the command line or restart the server to pick up changes to the system PATH.
- Instead of overwriting your existing deployment files, deploy the Colectica Portal package to a new location.
- From your old location, copy the
PortalDir\approot\packages\Colectica.Portal\1.0.0\root\appsettings.jsonto the root of your new deployment directory.
- Edit the
Physical Pathof your IIS web site to point to the deployment location. This should no longer end in
wwwrootlike the earlier versions did.
- Restart the IIS site and confirm that you can connect to your site using a web browser.
- Once you confirm everything is working, you may remove your old deployment files.