Skip to end of metadata
Go to start of metadata
We urge you to back up your database before the upgrade to a new version, since YouTrack does not provide backward database compatibility, and thus you will not be able to revert to a previous version with the database that was processed during the upgrade! You will be able to roll back to the previous YouTrack version only with the pre-upgrade database backup!

Upgrading to YouTrack 5.1

Upgrading from YouTrack 4.x to YouTrack 5.1

In general, you can upgrade directly from YouTrack 4.x to the latest 5.x build using the standard procedure.

Please don't forget to back up the database before starting the upgrade.

However, in some cases you might get ConstraintsValidationException. To fix this exception you must upgrade in two steps: YouTrack 4.x -> YouTrack 5.0 -> YouTrack 5.1:

To upgrade YouTrack 4.x to YouTrack 5.1:

  1. Download YouTrack 5.0 build from the YouTrack Release Downloads Archive
  2. Back up your 4.x database
  3. Stop YouTrack server
  4. Run the YouTrack 5.0 build and wait until all refactorings are finished
  5. Back up the updated YouTrack 5.0 database
  6. Stop YouTrack server
  7. Deploy the new YouTrack 5.1 build
  8. Start the server

Upgrading to YouTrack 5.0

Important Note: PLEASE READ BEFORE PROCEEDING

Please note that YouTrack 5.0 requires the Permanent Generation Size increased. The Permanent Generation Size of JVM is defined by 'PermSize' and 'MaxPermSize' Java parameters.

YouTrack requires the -XX:MaxPermSize parameter set to at least 150Mb, up to which JVM will allocate, if necessary.

  • If you run YouTrack as JAR file, you should specify this parameter in the command line, for example:
  • If you run YouTrack as WAR file, you should provide 'MaxPermSize' parameters in the settings of your servlet container.
    For example, if you run youtrack-xx.war in your own Tomcat installation, you can specify the -XX:MaxPermSize in the catalina.bat file providing the property in the 'JAVA_OPTS' section; like this:
  • If you run YouTrack as EXE file, you do not have to change these parameters, as they are pre-defined by us in Tomcat settings.

Upgrade Notes for Workflow Editor 5.0

  1. Version Compatibility: Only Workflow Editor 5.0 is compatible with YouTrack 5.0! Please get the latest release build.
  2. New l10n construction in workflow rules: please note that due to the implemented localization of the default workflows most of the messages are now contained within l10n constructions:

    They signify that the message whithin is translated. But, due to the implementation, you cannot change texts within l10n tags. You can either change them in original localization files (see Translating YouTrack UI page) or you can delete the l10n tags and then edit the texts within.

Upgrading to YouTrack 5.0 from YouTrack 4.x

To upgrade YouTrack server:

  1. Back up current YouTrack 4.x database!
  2. Stop YouTrack server
  3. Deploy the new YouTrack 5.0 build
  4. Start the server.

Upgrading to YouTrack 5.0 from YouTrack 3.x

YouTrack does not support direct upgrade from 3.x to 5.0 version. For correct upgrade you should upgrade to 4.x first.

To upgrade YouTrack server:

  1. Back up current YouTrack 3.x database!
  2. Stop YouTrack server
  3. Download the latest available YouTrack 4.x build. While YouTrack is still in the EAP stage, you can download the latest version from our site. After the release, you can take the latest build in the YouTrack Release Archive
  4. Deploy the latest YouTrack 4.x build.
  5. Start YouTrack server.
  6. Back up current YouTrack 4.x database!
  7. Stop YouTrack server
  8. Deploy the new YouTrack 5.0 build
  9. Start the server.

Upgrading to YouTrack 4.0

Upgrading to YouTrack 4.x from YouTrack 4.0

To upgrade YouTrack server:

  1. Back up current YouTrack database
  2. Stop YouTrack server
  3. Deploy the new YouTrack 4.x build
  4. Start the server

Upgrading to YouTrack 4.0 from YouTrack 3.x

To upgrade YouTrack server:

  1. Back up current YouTrack database
  2. Stop YouTrack server
  3. Deploy the new YouTrack 4.0 build
  4. Start the server

Upgrading to YouTrack 4.x from YouTrack 2.x

YouTrack 4.0 does not support direct upgrade from YouTrack 2.x, because of database format changes made in YouTrack 3.x!
To upgrade from YouTrack 2.x, you need to convert your database and upgrade to YouTrack 3.x, and only then you can upgrade to YouTrack 4.0.

To upgrade YouTrack 2.x to YouTrack 4.0:

  1. Download latest YouTrack 3.x build from the YouTrack Release Downloads Archive
  2. Back up your 2.x database
  3. Stop YouTrack server
  4. Convert the 2.x database
  5. Run the YouTrack 3.x build with the converted database
  6. Back up the YouTrack 3.x database
  7. Stop YouTrack server
  8. Deploy the new YouTrack 4.0 build
  9. Start the server
Labels:
upgrade upgrade Delete
configuration configuration Delete
jvm jvm Delete
memory memory Delete
permgen permgen Delete
permsize permsize Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Jan 22, 2014

    On MaxPermSize for tomcat:
    According to comment in catalina.sh, CATALINA_OPTS should be used for perm gen size of tomcat process turning, bot the JAVA_OPTS.