Preparation Steps
Before you upgrade, you should
backup your database and notify your users that the system will be down for a period of time.
Note: If you used the Windows Graphical Installer to install the system you are upgrading, review this topic for help migrating your installation:
If you are upgrading to a new version of Apache Tomcat, see
Supported Tomcat Versions for important information about using different versions of Tomcat with LabKey Server.
Upgrade Options
Windows
Upgrade LabKey Server manually. You can use the upgrade batch script described
here.
Linux or OSX
You can use the manual-upgrade.sh script to streamline the upgrade process. See
Manual Upgrade Script for Linux and OSX for more information.
Supported Versions for Upgrade
Please see LabKey's
Upgrade Support Policy.
Pipeline Jobs
It is a known issue that pipeline jobs that are in progress prior to an upgrade may not resume successfully after an upgrade. The same is true for jobs that may have hit an error condition if they are retried after an upgrade. In general, hotfix releases should not have incompatibilities when resuming jobs, but major version transitions will sometimes exhibit this problem. When possible, it is recommended to let jobs complete prior to performing an upgrade.
To check the status of jobs, use the
Pipeline link from the Admin Console.