他のサーバーへの JIRA の移行

2.1 ユーザーに JIRA のデータ更新を中断させる

During the upgrade process, you'll export JIRA's database from your existing JIRA installation (via an XML backup) and then restore this backup into a new JIRA installation. To ensure that the data in the XML backup is consistent with the latest data in the system, you must temporarily restrict access to JIRA so users can't update the data. Refer to the Preventing users from accessing JIRA during backups page for more information.

 注意してください！整合性のない XML バックアップを使って復元することはできません！

2.2 データベースのバックアップ

Perform an XML backup of your existing JIRA installation's external database. For large JIRA installations, this process may require several hours to complete.

2.3 JIRA Home ディレクトリのバックアップ

1. Jira をシャットダウンします。
2. Locate the JIRA Home directory. You can find information about the location of the directory by navigating to the <jira-application-dir>/WEB-INF/classes/jira-application.properties file in your JIRA Installation Directory. Alternatively, you can open the JIRA Configuration Tool to see the directory that is set as your JIRA Home.
3. 設定ファイルに記録されているディレクトリに移動して、別のディレクトリにそのバックアップを作成します。
4.  Delete the file <jira-home>/dbconfig.xml as soon as the backup is complete.

2.4 添付ファイルおよびインデックスの保存ディレクトリが JIRA Home ディレクトリの外にある場合、この二つのディレクトリのバックアップを作成する

If the attachments and index directories are located outside of your JIRA Home Directory, you must back them up separately. These pages describe how to find out where these directories are located in your implementation:

• Your attachments directory — Refer to Configuring File Attachments page in the documentation for your version of JIRA.
• Your index directory — Refer to Search Indexing page in the documentation for your version of JIRA.

Also refer to Backing Up Data for more information about backing up attachments in JIRA.

2.5 JIRA インストール ディレクトリのバックアップ

「JIRA インストールディレクトリ」 は、JIRA がインストールされた時に、JIRA アプリケーション ファイルとライブラリが展開されたディレクトリです。

To set up a "recommended" (not WAR) distribution:

1. Open the JIRA Configuration Tool.
2. JIRA ホーム タブをクリックします。
3. JIRA ホーム ディレクトリ フィールドを更新します：
   
   • If your JIRA 6.2 installation is on a new server, update the JIRA Home Directory field to the path of your copied JIRA Home directory.
   • If your JIRA 6.2 installation is on the same server, update the JIRA Home Directory field to the path of your existing JIRA Home directory.
     For more information about this directory, see JIRA Home Directory.

WAR ディストリビューションの設定方法

1. Edit the jira-application.properties file located within the <jira-application-dir>/WEB-INF/classes subdirectory of your new JIRA 6.2 Installation Directory JIRA Installation Directory.
2. Update the jira.home property in this file to the path of the new JIRA Home Directory:
   
   • If your JIRA 6.2 installation is on a new server, update the jira.home property to the path of your copied JIRA Home directory.
   • If your JIRA 6.2 installation is on the same server, update the jira.home property to the path of your existing JIRA Home directory.
     For more information about this directory, see JIRA Home Directory.
3. Remove the '#' at the beginning of the jira.home line (so that JIRA no longer regards this line as a comment).
4. Save your updated jira-application.properties file.

You can also set your JIRA Home Directory's location by defining an operating system environment variable JIRA_HOME. This value of this variable takes precedence over the value of the jira.home property in the jira-application.properties file in your JIRA Installation Directory. See Setting your JIRA Home Directory for details.

お使いのデータベースに対応した以下の「JIRA の ... (データベース名) への接続」の説明に従い、そしてステップ 4 からは以下の黄色の内容に注意してください。

• JIRA の PostgreSQL への接続
• JIRA の MySQL への接続
• JIRA の Oracle への接続
• JIRA の SQL Server 2005 への接続
• JIRA の SQL Server 2008 への接続

組み込み HSQL データベースを使用中の場合は、新しいデータベースを作成する必要はありません。

For each file you have modified in your existing JIRA installation, you need to manually edit each equivalent file in your new JIRA installation and re-apply your modifications. If a file is not present in your new JIRA installation (for example, osuser.xml in recent JIRA versions), then simply copy that file over to your new JIRA installation.

The table below lists the most commonly modified files and their locations within your JIRA Installation Directory:

The version-specific upgrade notes contain details on properties which may have changed in these commonly modified files.

上記のファイル以外にも、アップグレードのプロセスにて以下の設定を考慮・実行する必要があります。

• Using JIRA with Atlassian's Crowd? — If you are using Crowd with JIRA, configure your new JIRA to talk to Crowd as described in Integrating Crowd with JIRA.
  • Remember to configure Crowd to grant JIRA's new hostname/IP access: Specifying an Application's Address or Hostname
• Allocating additional memory to JIRA — If you had previously allocated additional memory to JIRA, do the same for your new JIRA instance. For more information refer to Increasing JIRA memory.
• Plugins — For any plugins that you had installed in your old JIRA, download the plugin version for your new version of JIRA from the http://plugins.atlassian.com site.
• 文字エンコード ： 新しい場所と同じ場所の文字エンコード（ロケールなど）が同じであることを確認します。 エンコードの互換性がない 2 つのシステム間で添付ファイルを移動した場合、新しいバージョンの JIRA が正常に動作しない場合があります。
• カスタマイズ ： カスタマイズを行った場合（コード、テンプレート、構成ファイルなど）は、これらの変更の互換バージョンを新しい JIRA へコピーします。（所属組織内の開発者が使用しているバージョンをカスタマイズした場合、開発者は新しいバージョンに対しても同等の変更を構築・テストし、アップグレード後の JIRA インストールへコピーするためのファイルを制作する必要があります。）
• (Optional) Running JIRA on a different port — If your new JIRA is installed on the same machine as your old JIRA, you may wish to make sure it runs on a different port (in case you ever need to restart your old JIRA). See Changing JIRA's TCP Ports for details.

1. 古い JIRA がシャットダウンされていることを確認する ： JIRA サーバーが動作中の場合はシャットダウンします。
2. JIRA WAR ディストリビューションを Tomcat 内にインストールした場合、JIRA を再起動する前に Tomcat 作業ディレクトリを削除します。この操作を実行しない場合、JIRA ページを表示した際にエラーが発生する可能性があります。
3. 以下に対する JIRA の新しいバージョンを起動します。
   
   • 'Recommended' distributions — follow the Starting JIRA instructions.
   • WAR distributions — follow the instructions for starting JIRA for your application server within the Installing JIRA WAR section.
     During the startup process, your new JIRA installation will create any required database indexes. If you created any custom database indexes, please check them afterwards and remove any that duplicate the indexes added by JIRA.

古い JIRA のデータを、新しい JIRA にインポートします。

1. 「JIRA システム管理者」グローバル権限を持つユーザーとしてログインします。
2. Select Administration > System > Import & Export > Restore System (tab) to open the 'Restore JIRA data from Backup' page.
   Keyboard shortcut: 'g' + 'g' + type 'rest'
3. In the File name field, specify the XML backup file you created previously during the export process (above). That zipped file should contain two xml files: activeobjects.xml and entities.xml. Both of these files must be included in the zipped file for the import process to work.
4. Restore the attachments directory that you backed up previously, into the attachments directory of your new JIRA. (See Restoring Data.)
   Avoid passing through a proxy when performing an XML restore, especially if your JIRA instance is very large. Using a proxy may cause timeout errors.
5. JIRA に Web ブラウザでアクセスして、古い JIRA のときと同じユーザー名でログインします。
6. すべてのプロジェクトと課題がインポートされていて、すべての機能が正常に動いていることをさっと確認します。ページのフッター部分で新しい JIRA のバージョンを確認します。

1. Check your server logs for error messages, even if JIRA appears to be running correctly. If there are any errors there that you cannot resolve, create a support case in https://support.atlassian.com/ja, attach your log file and we will advise you on the errors.
2. If you were previously using External User Management, enable it in the new JIRA instance.
3. アップグレード時にサーバーも変更した場合は、 JIRA 管理画面でインデックス、添付ファイル、バックアップのディレクトリのパスを変更します。
4. テストの間に E メール機能を無効にしていた場合は、これを有効に戻します。
5. 古い JIRA から新しい JIRA へカスタマイズしたものを移行した場合は、それを入念にテストします。
   
   1. If you had downloaded plugins for the new version of JIRA, install the downloaded JAR file(s) in your new JIRA version and carry out any other required installation for the plugin.
   2. もしプラグインにプロパティファイルがある場合は、古い JIRA で実施したものと同じ変更を適用します（古いプロパティファイルをコピーしないようにしてください）。
6. 新しい JIRA が正しく動いていることが確認できたら、以下の方法で新しいサーバーIDをライセンスに登録します。
   
   1. Log in to https://my.atlassian.com.
   2. 利用したいライセンスを選択します。
   3. 新しいサーバー ID に変更して、保存します。
   4. 新しいサーバー上でライセンスを更新します。