YouTrack InCloud 2017.3 Help

Database Export

Just like in the standalone version, YouTrack InCloud uses its own in-process database.

On a hosted instance, you cannot configure the database location or restore your instance from a backup file. These operations are managed by the JetBrains YouTrack team.

However, you can create a backup of your database and export it (download the backup file) to your local machine in case you want to use the same data in a standalone YouTrack instance or for troubleshooting purposes. Each backup file contains a snapshot of your database including all of the attachments that are stored in your instance at the time the file was created.

Export the Database

To access the database controls, select Database Export from the Administration menu.

YouTrack InCloud only stores a single backup file on the server. The YouTrack InCloud support team maintains a separate collection of backup copies of each instance. For more information, see YouTrack InCloud Database Backups.

The first time you access this page, all you see is the option to create the export file. Click the Create export file button to create a backup copy of your current database on the server.

exportDatabaseNoFile

Once you have created the export file, the page displays the date when the backup file was created and the size of the archive package.

exportDatabaseYTI

The following controls are available:

ControlDescription
DownloadDownloads a copy of the archive package to your local directory.
Update export fileUpdates the contents of the backup file on the server. Use this option when you want to create a backup copy of your current database.

There are few things to consider when you generate an export file:

  • YouTrack automatically switches the database to read-only mode after when you generate the export file. This preserves the synchronization between the YouTrack and the built-in Hub service. Users can still access and update issues in YouTrack, but most of the settings on administrative pages are read only. For best results, update the export file outside of working hours.
  • You can't cancel the update of the export file once it has started.

Use Cases for Database Export

In general, you don't need to worry about backing up your YouTrack InCloud instance. The YouTrack InCloud support team stores a robust collection of backup files that can be used to restore your instance.

However, you may find that you need to export a copy of your database in the following situations:

Use CaseGuidelines
Your security plan requires that you store local copies of your data.In this case, you should take extra steps to ensure the security of your data.

YouTrack stores passwords in the database as hash values. Passwords are hashed using the SHA-1 cryptographic hash function.

The YouTrack database, however, is not encrypted. If you export and store backup copies of your database, we recommend that you apply filesystem-level or full disc encryption to the machine that you use to store the data.

You want to migrate your database from YouTrack InCloud to an on-premise installation.The database that is used for YouTrack InCloud is compatible with a YouTrack Standalone installation. You can run YouTrack Standalone using a copy of the database from your YouTrack InCloud instance.

In this case, follow the instructions provided for an InCloud to Standalone migration.

To perform this operation successfully, the version of the backup file should be the same or earlier than the version of YouTrack to which you restore the InCloud database.

Last modified: 8 November 2017