YouTrack Standalone 2017.3 Help

Upgrade with a JAR Distribution

If you run YouTrack as a standalone Java process with the JAR distribution, the upgrade procedure is quite straightforward.

Prerequisites

Before you upgrade, perform the following prerequisite tasks:

  • Create a backup of your current database. YouTrack does not provide forward database compatibility. Your database is migrated to the format that is compatible with the latest version during the upgrade procedure. This means that you cannot revert to a previous version and continue to use the database that was processed during the upgrade.

  • Copy the backup of your current database to a secure location just in case you encounter problems with the upgrade and need to roll back to the previous version.

  • Verify that your YouTrack license supports the upgrade. To view the license limitations, click the Global Settings link in the Administration menu. If your free update period has expired, you need to extend your subscription.

  • Verify that your current YouTrack installation is version 7.0 or later. The current version of your installation is shown at the bottom of any page in the application. If your current installation is earlier than 7.0, you must upgrade to version 7.x first, then upgrade to YouTrack 2017.2.

To upgrade YouTrack with the JAR distribution:

  1. Download the JAR distribution from the JetBrains website.

  2. Stop the YouTrack server.

  3. Run the new JAR file from the command line, or deploy the new JAR and start the server (if, for example, you run a script).

    Run the JAR file with the same user account you use for the previous version.

If you experience a problem during the upgrade, please create an issue. Describe the problem and attach your logs to the issue. Restore the previous YouTrack version with the pre-upgrade database backup.

Last modified: 7 March 2019

See Also

Installation and Upgrade: