別のサーバーへの Jira アプリケーションの移行

This document describes how to migrate and upgrade to Jira applications on different server hardware or in a different server environment that entails one or more of the following:

  • オペレーティング システムの変更

  • インデックスや添付ファイルの保存場所の変更

  • データベースやデータベース システムの変更

Jira を新しいサーバーまたは場所に移行するには、新しい Jira インスタンスをインストールする必要があります。インストールが完了したら、データベース間で既存のデータを移行してから、ホーム ディレクトリとすべての既存設定を移動します。 

tip/resting Created with Sketch.

Jira Data Center Migration アプリ

If you're planning to migrate your Jira instance to clustered infrastructure on AWS, consider using the Jira Data Center Migration App. This app will automate the customization and deployment of AWS infrastructure. Afterward, it'll also walk you through the migration process. For detailed information, see How to use the Data Center Migration app to migrate Jira to an AWS cluster.

Perform pre-migration checks

  • Check your license. Verify that your license support period is still valid.

  • Check for known issues. Use the JIRA Knowledge Base to search for any issues in the new version that will affect you.

  • Check for compatibility:

    • Confirm that your operating system, database, other applicable platforms, and hardware still comply with the requirements for Jira applications.

    • Make sure the source and target instances are initially set with the same timezones to avoid any issues with date and time fields.

    • If you have installed Jira application apps that aren’t included with Jira applications, verify that these apps will be compatible. You can find an app's compatibility information from the app's home page on the Atlassian Marketplace. You can also follow the procedure outlined here: Checking app compatibility with application updates to have the Universal app manager help you with this.


最初にテスト環境で移行を実行してみることを強く推奨します。テスト環境でのアップグレードが成功しない限り、本番環境の Jira サーバー アプリケーションの移行を行わないでください。

  • If you have any problems with your test environment that you can't resolve, create an issue at our support site so that we can assist you.

  • 本番環境の Jira サーバー アプリケーションの移行中に問題が発生した場合、ユーザーに移行先サーバーの利用を許可してはいけません。代わりに、以下のことを行って下さい。

    • 古い Jira サーバー アプリケーションを引き続き使用します。これによって、本番環境のデータが失われずにすみます。

    • Create an issue at our support site so that we can help you resolve the problems with your migration.

Consider that some anti-virus or other Internet security tools may interfere with the migration and prevent the process from completing successfully. If you experience or anticipate experiencing such an issue with your anti-virus/Internet security tool, disable this tool first before proceeding with the Jira application migration.


データのバックアップ

Before you proceed, keep in mind that if you're changing your operating system from Windows to Linux, or vice versa, remember that you will need to reverse the “slashes” when required in your file paths ('/' to '\', or '\' to '/').

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

Create a backup of your database by following instructions from these guides:

Back up your Jira home directory

  1. Jira をシャットダウンします。

  2. Jira ホーム ディレクトリを見つけます。このディレクトリの場所に関する情報は、Jira アプリケーション インストール ディレクトリ<jira-application-dir>/WEB-INF/classes/jira-application.properties ファイルに移動することによって確認できます。または、Jira 設定ツールを開いて Jira ホームとして設定されているディレクトリを調べることもできます。

  3. Navigate to the directory specified in the configuration file and create a backup of it in another directory. After the migration, this new directory will be used as your Jira home directory.

  4. After the backup is complete, delete the <home-directory>/dbconfig.xml file from your existing home directory. This will remove the existing connection between Jira and your database, and allow you to connect to a new database.

Back up your Jira installation directory

Installation directory contains the Jira application files and libraries that were extracted when Jira was installed.

Back up your attachments and index directories if located outside your Jira home directory

添付ファイルおよびインデックスのディレクトリがJIRA ホームディレクトリ外にある場合は、この2つのディレクトリのバックアップをそれぞれ作成する必要があります。ご使用の実装でこれらのディレクトリの場所を見つける方法については、次のページで説明しています。

For more information about backing up attachments in Jira, see Backing up data.

Migrate Jira to a new server

If you're upgrading both Jira Core and Software and Jira Service Desk during the migration process, upgrade Jira Core or Software only. You'll later upgrade Service Desk directly in Jira, without a separate installer.

See Upgrading Jira applications for information on the pre-requisite tasks you need to complete before upgrading.

Jira のダウンロード

Download one of the Jira applications from our website. Choose the zip or tar.gz archive.

Start the migration

  1. 既存の Jira インスタンスを停止します。

  2. Copy the backup of your existing Jira Home Directory from the old server to the new server.

  3. Extract (unzip) the archive you’ve downloaded to a newly created directory on the new server that you’re migrating to. This is the new installation directory, and it must be different from your existing installation directory. 

  4. After you’ve located a new Jira installation on the new server, edit the following file: 

    <installation-directory>\atlassian-Jira\WEB-INF\classes\Jira-application.properties


    It must point to your Jira home directory on the new server. If you are moving to a new database server, make sure to modify the dbconfig.xml file on the new server by by changing the connection parameters. Otherwise, Jira will try to connect to your existing database. 


  5. (オプション) ユーザー管理に Crowd を使用している場合は、この追加手順を完了します。

    Crowd 設定

    If you are using Crowd for user management, reapply modifications from the following files that are in your existing installation directory to the new files. Do not copy the files as they may be different in the new version of Jira.

    • <Installation-Directory>/atlassian-Jira/WEB-INF/classes/crowd.properties

    • <Installation-Directory>/atlassian-Jira/WEB-INF/classes/seraph-config.xml

データベース ドライバのインストール

If you're using an Oracle or MySQL database, download a new JDBC driver. For other databases, you can omit this step. For instructions on how to connect Jira to a new database, see Connecting Jira applications to a database.

tip/resting Created with Sketch.

ドライバが最新の場合、以前のバージョンからコピーすることもできます。

  1. 次のドライバのいずれかをダウンロードします。
    • Oracle: JDBC ドライバ 12.2.0.1
    • MySQL: the latest JDBC driver.
  2. <installation-directory>/lib に配置します。

Re-apply any modifications to Jira files 

Jira を使用する際、Jira ファイルにカスタム変更を行う場合があります。このような変更には、接続の詳細、メモリ割り当てに関する設定や、他の JVM 引数などが含まれます。このステップでは、バックアップからコピーすることで新しいファイルに同じ変更を再適用する必要があります。

If you made any custom modifications to Jira files, make sure to apply those changes to the files on the new server.

通常は次のようなファイルを変更します。

  • server.xml
  • dbconfig.xml
  • Jira-config.properties
  • setenv.sh / setenv.bat (メモリ割り当ておよびその他の JVM 引数)
  • for more, see Important files in Jira

See Important files in Jira for a complete list of commonly modified files and their locations within your Jira Installation Directory.

Jira の初回起動


Verify that your old Jira installation is shut down before proceeding. If this Jira server is still operating, shut it down.

Start your new Jira version, and connect it to the database.

  1. <installation-directory>/bin に移動し、次のファイルのいずれかを実行します。
    • Windows:  start-Jira.bat
    • Linux:  start-Jira.sh
  2. Open Jira in your browser.
  3. When prompted, select I'll set it up myself to get access to more setup options, which are outlined in the following sections.

Restore backed-up data and attachments

  1. If you aren’t reusing your old database, connect the Jira to the new one. In the Set up application properties dialog, select My own database, and provide details of a new, empty database.

  2. On the next screen, select Import your data, and select the file with your data backup. Avoid passing through a proxy when importing your data, especially if your Jira instance is large. Using a proxy may cause timeout errors.

  3. 画面の指示に従い、セットアップを完了します。 

  4. It’s time to unpack your backed up attachments. Check the following guides for instructions:

Perform post-migration checks and tasks

新しい Jira アプリケーションのインスタンスを起動したあと、以下の確認と作業を行うことを強く推奨します。 

  1. Check your server logs for error messages, even if Jira applications appear to be running correctly. If there are any errors there that you cannot resolve, create a support case, attach your log file, and we will advise you on the errors.

  2. 以前、外部ユーザー管理を使用していた場合は、新しい Jira アプリケーションのインスタンスで、それを有効にします。

  3. If you changed machines when upgrading, change the paths to the indexes, attachments, and backup directories, from within your application's Jira Administration section.

  4. テストの間に E メール機能を無効にしていた場合は、これを有効に戻します。

  5. 古い Jira から新しい Jira へカスタマイズを移行した場合は、そのカスタマイズを十分にテストします。

    1. If you had downloaded plugins for the new Jira application versions, install the downloaded JAR file(s) in your new version and carry out any other required installation for the plugin.

    2. もしプラグインにプロパティファイルがある場合は、古い JIRA で実施したものと同じ変更を適用します(古いプロパティファイルをコピーしないようにしてください)。

あともう一歩です!

お客様の Jira インスタンスは移行されました。Service Desk をお持ちの場合のアップグレード方法と、アプリのアップグレード方法は以下で確認できます。

(オプション) Jira Service Management の更新

Jira Service Management を使用している場合、個別のインストーラをダウンロードせずに UI で直接更新できます。

  1. 画面右上で [管理] > [アプリ] の順に選択します。

  2. On the Versions and licenses page, select update Jira Service Management. This will automatically update Service Management to a compatible version.

アプリ (アドオン) のアップグレード

新しいバージョンとの互換性を持つよう、アプリをアップグレードします。

  1. 画面右上で [管理] > [アプリ] の順に選択します。
  2. Go to Manage apps and under Atlassian Marketplace (left-side panel) select Manage apps.
  3. アプリをサポート対象バージョンにアップグレードします。

インデックスの再構築

古いインデックスは新しいバージョンとの互換性がないため、Jira によって削除されます。インデックスの再作成を実行して一から再構築します。課題とアプリの数に応じて、このステップには時間がかかる可能性があります。

  1. 画面右上で [管理] > [システム] の順に選択します。

  2. Under Advanced (left-side panel), select Indexing.
  3. Run Full re-index.  
最終更新日 2022 年 7 月 25 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.