Upgrading Liquibase

Note: This guide covers how to upgrade from Liquibase Open Source to Liquibase Pro

Before upgrading Liquibase, read the latest Release Notes for any changes that may affect your existing setup.

Upgrading Liquibase follows the Installing Liquibase instructions, but in one of two ways:

  • Overwrite the existing Liquibase installation directory
  • Install to a new installation directory

New Installation Directory

Installing to a new directory allows to have multiple versions of Liquibase you can easily switch between. But may require additional configuration changes.

If you install to a new directory, make sure you:

  1. Copy any files from the lib directory from the old directory to the new.
  2. Update your PATH environment variable to use the new directory.

It is a best practice to maintain the consistent naming convention for the directory where you install Liquibase.

Your latest version could be installed in the C:\Apps\Liquibase directory on Windows or /opt/Liquibase directory on Linux, and directories for older versions could be named as follows:

  • C:\Apps\liquibase-4.0.0 on Windows or /opt/liquibase-4.0.0 on Linux
  • C:\Apps\liquibase-4.2.1 on Windows or /opt/liquibase-4.2.1 on Linux
  • C:\Apps\liquibase-4.3.1 on Windows or /opt/liquibase-4.3.1 on Linux

Overwrite Installation Directory

By overwriting the existing installation directory, your existing configuration can remain unchanged. But by replacing the old version, you can no longer run the old version without re-installing that.

Note: If upgrading from Liquibase 4.10 or earlier, you should check the contents of the installation's lib directory and remove any .jar files you did not explicitly add. Starting with version 4.11.0, the shipped drivers are managed in a different location.

Verifying Upgrade

After upgrading Liquibase, verify that the new version by running liquibase --version.

Need help?

Related Links