Backing Up Data

This page describes how to back up your JIRA data, and establish processes for maintaining continual backups. Backing up your JIRA data is the first step in upgrading your server to a new JIRA revision, or splitting your JIRA instance across multiple servers. See also Restoring JIRA data and Restoring a Project from Backup.

Jira の完全なバックアップの作成は、2 段階で行われます。

1. データベース コンテンツのバックアップ

ネイティブなデータベース バックアップ ツールか、Jira の XML バックアップ ユーティリティを使用できます。

ネイティブなデータベース バックアップ ツールの使用

あらゆる重大なデータベースに、データベースをバックアップおよび復元するためのツールが付属します (RDBMS の「MS」)。以下のように、XML バックアップ オプションの設定ではこれらのツールを強くお勧めします。

• 単一時点でバックアップを取ることによって、データベースの整合性を確保します。
• Jira の XML バックアップより処理が速く、消費リソースも少なくなります。
• 既存のバックアップ戦略と連携できます (例: データベースを使用するすべてのアプリケーションで 1 回のバックアップ実行を許可)。
• インクリメンタル (「フル」ではなく) バックアップを実現し、ディスク スペースを節約します。
• Jira がバックアップ形式として XML を使用することに関連する、文字エンコーディングやフォーマットの問題を防ぎます。

See the documentation for your database on how to set up periodic backups. This typically involves a cron job or Windows scheduled task invoking a command-line tool like mysqldump or pg_dump .

Jira の XML バックアップ ユーティリティの使用

一回のみのバックアップを実行するには (例: アップグレード前)、次の手順に従います。

You can also configure scheduled XML backups, as described in Automating JIRA Backups.

1. Log in as a user with the 'JIRA System Administrators' global permission.
2. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
3. Under the 'Import & Export' sub-menu in the left-hand navigation column, click the 'Backup Data to XML' link. This will display the 'Backup JIRA data' page:
   Screenshot: The Backup JIRA Data Page
   
   As shown in the screenshot above, the backup will be stored within the backups directory of JIRA Home.
4. In 'File name' field, type the name of the backup file. Ensure that JIRA has the necessary file system permissions to write to this location. (This should be the case if JIRA has permission to write to the JIRA Home directory.)
5. (Optional but recommended) Select the 'Backup as Zip' check box.
6. Click the 'Backup' button, and wait while your JIRA data is backed up.
7. When the backup is complete, a message will be displayed, confirming that JIRA has written the data to the file you specified.

2. data ディレクトリをバックアップする

The data directory is a sub-directory of your JIRA Home Directory. It contains application data for JIRA, e.g. if you have attachments enabled, all files attached to JIRA issues are stored in the data\attachments directory (not in the database).

To back up the data directory, you need to create a snapshot of the data directory (including all files and subdirectories), then back up the snapshot. Note that the directory structure under the data directory must be preserved in the snapshot.

Creating this snapshot is an operating system-specific task, e.g.:

• On MS Windows, a batch script copying the directory can be written and scheduled periodically (Programs > Accessories > System Tools > Scheduled Tasks). There are also various utilities available to simplify this (eg. http://www.picozip.com).
• On Linux/Solaris, it is best to write a small shell script, placed in /etc/cron.daily , backing up files to a directory like /var/backup/jira . It is best to copy an existing script in /etc/cron.daily to ensure local conventions (file locations, lockfiles, permissions) are adhered to.