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


Upgrade LabKey Server manually. You can use the upgrade batch script described here.

Linux or OSX

You can use the 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.


Was this content helpful?

Log in or register an account to provide feedback

expand all collapse all