アップグレード チェックリスト

このチェックリストを Jira Software Server アップグレードの準備ガイドとしてご利用いただけます。インスタンスはそれぞれ異なり、このガイドにはインスタンスに固有のタスクやカスタマイズを補完する必要がある点にご注意ください。

このテンプレートを使用し、お使いの Jira Software インスタンスに合わせて追記することをおすすめします。

チェックリストを Trello ボードで確認 

段階タスク注意

ステータス / コメント

調査と決定

アップグレード後のバージョンを決定する


アップグレードのステークホルダーを大まかに決定する (任意)
  • 役割、責任範囲、および連絡先を一覧化して、関係者と常に情報を共有し、すべての依存関係を把握できるようにします。

準備とテスト


メンテナンス ステータスを確認する
  • Jira をアップグレードするための有効なライセンスが必要です。my.atlassian.com で確認および更新を行います。

カスタム変更を含むファイルの一覧を取得Jira をカスタマイズするためにファイルを変更した場合、その変更を保持するには、どのファイルを変更したかを把握する必要があります。 
  • ASTS プラグインの最新バージョンを使用している場合、歯車アイコン > [アプリケーション] > [アップグレードを計画する] の順に選択して、カスタム変更を行ったファイルの一覧を表示します。アップグレードしたインスタンスでこれらの変更を保持する場合は、アップグレード中に各ファイルに変更内容 (ファイル全体ではなく) をコピーする必要があります。この一覧を手元に用意しておくと、アップグレード プロセスの際に時間を節約できます。 
  • [アップグレードを計画する] ページを表示できない場合は、変更済みのファイルの一覧をコンパイルします。最も頻繁に変更されるファイルに関する推奨事項については、こちらを参照してください。 
詳細については、「アップグレード前のプランニング ツール」をご覧ください。

サポート対象プラットフォームを確認する
テスト環境のセットアップ
インスタンス ヘルス チェックの実行
  • インスタンスがアップグレード可能かどうかを確認します。ヘルス チェックは Support Tools Plugin に含まれています。詳細はこちら

アプリの互換性の確認
  1. Jira の更新チェックでアプリの互換性を確認します。
  2. Jira 8.0 では大規模な変更が加えられたため、アップグレードの前に、互換性のないアプリをすべて無効化する必要があります。また、次のステータスのアプリも無効化することをお勧めします。
    • Incompatible
    • Compatible if both upgraded
    • Unknown
  3. "Compatible if upgraded" ステータスのアプリをアップグレードします。

    互換性のないアプリ」を参照してください。

最適なアップグレード方法を決定する

Jira のアップグレード方法を選択します。

SERVER

DATA CENTER

Jira 6.4 以前から開始している場合、8.x にアップグレードする前に Jira 7.x (例: 7.13) にアップグレードする必要があります。

tip/resting Created with Sketch. Pro Tip: Depending on your OS or whether you are running a DC or a standalone Jira Server, there might be some restrictions to the upgrade method you can choose. See Upgrade methods.

アップグレードの実行

DATA CENTER アップグレードを行う際は、アップグレード前の手順をすべて実行し、1 つのノードでアップグレードを実行してアップグレード後の手順を実行します。次にテンプレートを作成し、他のすべてのノードをアップグレードします。これが完了するまでは、DC 全体でアップグレード後の手順を実行することはできません。


変更の再適用
If you have made changes any of the files copy them over to your upgraded instance. These changes might include:
  • customisations to xml configuration files (e.g so they can use load balancing)

  • custom icons (e.g replacing the Jira logo with their company logo)

  • custom email templates (similarly related to the branding thing)

アップグレード中の変更によって Jira Software のカスタマイズが使用できなくなる可能性があるため、本番インスタンスでアップグレードを実施する前にステージング環境でカスタマイズのテストを実施することを強く推奨します。

Which files did I change?

If you're unsure which files you might have modified, go to  > Applications > Plan your upgrade to see the list of files in which you introduced custom changes.

Alternatively, take a look at the list of important files in the Jira installation directory. Also, you might want to look in the logs for the Modifications section:

インストーラーを使用している場合、既存の Jira Software インストールから次のパラメーターが移行されます。

  • server.xml ファイルの TCP の値。
  • Jira-application.properties ファイルに記載された Jira ホーム ディレクトリの場所。
  • setenv.sh / setenv.bat ファイルの次の値:
    • JVM_SUPPORT_RECOMMENDED_ARGS
    • JVM_MINIMUM_MEMORY
    • JVM_MAXIMUM_MEMORY
    • Jira_MAX_PERM_SIZE
What do I do with my changed files?

When you know which files have been modified, copy these modifications to the respective files in your upgraded Jira. Copy only the modified parts not the entire files!

If you're upgrading to Jira 8.6 and later and running the ATST version 1.20.0 or later, we will show you the files whose modifications have not been copied over on Jira startup. Then, you'll be able to copy the changes automatically.

You'll be prompted to restart Jira after copying is completed.


再インデックスのタイミングの決定

7.x から 8.x へのアップグレード Jira は起動時に、互換性のない古いインデックスを自動的に削除し、完全な再インデックスを開始します。一部のアプリでは追加の再インデックスが必要になるため、アプリをアップグレードするまで再インデックスを延期することもできます。詳細は、「自動的な再インデックスの無効化」を参照してください。


Jira の起動

アプリのアップグレードこれで、"Compatible if both upgraded" ステータスのアプリをアップグレードできます。
Re-apply any modifications (if you haven't done it already)

If you're upgrading to Jira 8.6 and later and running the ATST version 1.20.0 or later, you can see a list the files whose modifications have not been copied over on Jira startup. Then, you can just click to copy the changes automatically.

Note that when checking for changes, we're only looking at the files/folders below:

- <jira-home-directory>/atlassian-jira/ directory
- <jira-home-directory>/conf/server.xml
- <jira-home-directory>/bin/setenv.sh

To automatically transfer the changes, the installer copy of the modified file needs to be the same as in the version you're upgrading to.

You'll be prompted to restart Jira after copying is completed.


ユーザーによるアップグレード テスト
  • Jira ユーザーに、アップグレード後に Jira を正常に利用できているかどうかを確認します。これは、メジャー バージョン (例: 8.0) を越えるアップグレードを行う場合に非常に便利です。Jira Software の異なる機能を活用するサンプル グループを選択します。

確認事項の記録 (任意)
  • アップグレード中に気付いた点を文書化します。これは将来のアップグレードに役立ちます。
  • 必要に応じてタイムラインとステークホルダーを更新します。

タイムラインの作成とコミュニケーション
  • アップグレードに十分な時間を確保するようにします。ある程度の猶予時間も必要です。
  • 変更をエンドユーザーに通知します。

準備と実施



メンテナンス ステータスを確認する
  • Jira をアップグレードするための有効なライセンスが必要です。my.atlassian.com で確認および更新を行います。

サポート対象プラットフォームを確認する
インスタンス ヘルス チェックの実行
  • インスタンスがアップグレード可能かどうかを確認します。ヘルス チェックは Support Tools Plugin に含まれています。詳細はこちら

アプリの互換性の確認
  1. Jira の更新チェックでアプリの互換性を確認します。
  2. 7.x から 8.x へのアップグレード Jira 8.0 では大規模な変更が加えられたため、アップグレードの前に、互換性のないアプリをすべて無効化する必要があります。また、次のステータスのアプリも無効化することをお勧めします。
    • Incompatible
    • Compatible if both upgraded
    • Unknown
  3. "Compatible if upgraded" ステータスのアプリをアップグレードします。

    互換性のないアプリ」を参照してください。

インスタンス データのバックアップ
  • ネイティブのデータベース バックアップ ツールを使用します。ただし、環境の一部 (例: データベース ソフトウェア) を変更した場合は、Jira の XML バックアップ ユーティリティを使用する必要があります。
  • 2 つのプロセスの詳細な内容については、こちらをご確認ください。 

ディレクトリのバックアップ
  • インストール ディレクトリとホーム ディレクトリのバックアップを作成します。詳細についてはこちらをご参照ください。
    DATA CENTER すべてのノードでバックアップを実行し、共有ディレクトリのバックアップも作成します。

7.x から 8.x へのアップグレード 再インデックスのタイミングの決定

Jira 8.0 は互換性のない古いインデックスを自動的に削除し、起動時に完全な再インデックスを開始します。一部のアプリでは追加の再インデックスが必要になるため、アプリをアップグレードするまで再インデックスを延期することもできます。詳細については、「自動的な再インデックスの無効化」をご確認ください。


本番環境でのアップグレードの実行

次のアップグレード方法を使用できます。

SERVER

DATA CENTER

Jira 6.4 以前から開始している場合、8.x にアップグレードする前に Jira 7.x にアップグレードする必要があります。

tip/resting Created with Sketch. Pro Tip: Depending on your OS or whether you are running a DC or a standalone Jira Server, there might be some restrictions to the upgrade method you can choose. See Upgrade methods.

DATA CENTER アップグレードを行う際は、アップグレード前の手順をすべて実行し、1 つのノードでアップグレードを実行してアップグレード後の手順を実行します。次にテンプレートを作成し、他のすべてのノードをアップグレードします。これが完了するまでは、DC 全体でアップグレード後の手順を実行することはできません。


データベース ドライバーのアップグレード (Oracle または MySQL を使用している場合)

Jira を正常に起動するには、次の手順を実行します。

  • 最新の JDBC ドライバ (Oracle または MySQL) をダウンロードします。
  • <Jira-installation-directory>/lib に配置します。

変更の再適用
If you have made changes any of the files copy them over to your upgraded instance. These changes might include:
  • customisations to xml configuration files (e.g so they can use load balancing)

  • custom icons (e.g replacing the Jira logo with their company logo)

  • custom email templates (similarly related to the branding thing)

Which files did I change?

If you're unsure which files you might have modified, go to  > Applications > Plan your upgrade to see the list of files in which you introduced custom changes.

Alternatively, take a look at the list of important files in the Jira installation directory. Also, you might want to look in the logs for the Modifications section:

インストーラーを使用している場合、既存の Jira Software インストールから次のパラメーターが移行されます。

  • server.xml ファイルの TCP の値。
  • Jira-application.properties ファイルに記載された Jira ホーム ディレクトリの場所。
  • setenv.sh / setenv.bat ファイルの次の値:
    • JVM_SUPPORT_RECOMMENDED_ARGS
    • JVM_MINIMUM_MEMORY
    • JVM_MAXIMUM_MEMORY
    • Jira_MAX_PERM_SIZE
What do I do with my changed files?

When you know which files have been modified, copy these modifications to the respective files in your upgraded Jira. Copy only the modified parts not the entire files!

If you're upgrading to Jira 8.6 and later and running the ATST version 1.20.0 or later, we will show you the files whose modifications have not been copied over on Jira startup. Then, you'll be able to copy the changes automatically.

You'll be prompted to restart Jira after copying is completed.


7.x から 8.x へのアップグレード 再インデックスのタイミングの決定

Jira 8.0 は互換性のない古いインデックスを自動的に削除し、起動時に完全な再インデックスを開始します。一部のアプリでは追加の再インデックスが必要になるため、アプリをアップグレードするまで再インデックスを延期することもできます。詳細は、「自動的な再インデックスの無効化」を参照してください。
Jira の起動

アプリのアップグレードこれで、"Compatible if both upgraded" ステータスのアプリをアップグレードできます。
Re-apply any modifications (if you haven't done it already)

If you're upgrading to Jira 8.6 and later and running the ATST version 1.20.0 or later, you can see a list the files whose modifications have not been copied over on Jira startup. Then, you can just click to copy the changes automatically.

Note that when checking for changes, we're only looking at the files/folders below:

- <jira-home-directory>/atlassian-jira/ directory
- <jira-home-directory>/conf/server.xml
- <jira-home-directory>/bin/setenv.sh

To automatically transfer the changes, the installer copy of the modified file needs to be the same as in the version you're upgrading to.

You'll be prompted to restart Jira after copying is completed.


アップグレード後ユーザーによるアップグレード テスト
  • アップグレード後に Jira を正常に利用できているかどうかをユーザーに確認します。
  • テスト アップグレードと同じサンプル グループを使用します。
  • アップグレードを完了する前に課題を解決します。

エンドユーザーへの通知

主要な機能追加や、問い合わせ用の連絡先情報を含めます。


アップグレードのふりかえり (任意)

想定どおりに進んだ点、進まなかった点、次回に変更すべき点を文書化します。この作業は、次回のアップグレードをさらにスムーズに実行するために役立ちます。



リソース

問題が発生した場合、次のリソースを利用できます。記載順で確認することをおすすめします。 

  • Jira Software ドキュメント サイトおよび Jira Software Server ナレッジベースを参照または検索します (ドロップダウンで適切なバージョンを選択するようにします)。
  • アトラシアン コミュニティ サイト で、トピックに関する記事やディスカッションを検索します。または、アトラシアン内外のコミュニティ エキスパートに質問します。 
  • サポート エンジニアがサポートできるようサポート サイトで課題を作成します。
  • 認定ソリューション パートナーを通じてライセンスを購入した場合は、インスタンスのトラブルシューティングについてのパートナーに問い合わせてください。
  • さらにサポートが必要な場合、24 時間/週 7 日のサポート、ヘルス チェック、専任のシニア サポート エンジニアが含まれるプレミアム サポートも提供しています。詳細は、「プレミアム サポートについて」をご覧ください。


おつかれさまでした

ランディング ページに移動

最終更新日: 2019 年 12 月 17 日

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

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