PostgreSQL 9.6 から PostgreSQL 12 にアップグレードする方法

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

プラットフォームについて: Server および Data Center のみ。この記事は、Server および Data Center プラットフォームのアトラシアン製品にのみ適用されます。

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Fisheye および Crucible は除く

目的

このページの内容は、Jira アプリケーションでサポートされていないプラットフォームに関連しています。したがって、アトラシアンは、そのためのサポートの提供を保証できません 。この資料は情報提供のみを目的としているため、お客様自身の責任でご使用ください。

Jira 8.19 以降では PostgreSQL 9.6 のサポートは廃止されます。Jira 8.19 へのアップグレードを予定しているが、現在のデータベース インスタンスが PostgreSQL 9.6 上で実行されている場合、Jira をサポート対象外のプラットフォームで実行することによる問題を回避するためにデータベースを PostgreSQL 12 にアップグレードすることを推奨します。

サポートされるプラットフォームの一覧については、「サポート対象のプラットフォーム」を参照してください。

準備

アップグレードを巻き戻す必要が発生したときのために、PostgreSQL のネイティブのバックアップ ユーティリティを使って現在のデータベース クラスタのデータをバックアップします。詳細については PostgreSQL 9.6 Documentation — Chapter 25. Backup and Restore をご確認ください。

PostgreSQL を Amazon RDS インスタンス上で実行している場合、スナップショットを作成してデータベース インスタンス全体をバックアップします。詳細については Amazon Relational Database Service のドキュメント — DB スナップショットの作成をご確認ください。

ソリューション

アップグレードを行うには、現在のデータベースに保存されているデータの量とデータベース クラスタの構成に応じ、次のいずれかの方法を選択します。

PostgreSQL 9.6 のデータ ファイルを PostgreSQL 12 にアップグレードする

この方法では pg_upgrade ユーティリティをアップグレードに使い、古い PostgreSQL のデータ ファイルを新しいデータベース クラスタで再利用します。pg_upgrade を link モードで実行し、新しいデータベース クラスタにファイルをコピーする代わりにハード リンクを作成することで、アップグレードのダウンタイムを短縮できます。

これはオフラインのアップグレード方法です。アップグレード中は Jira と PostgreSQL データベースの両方が利用できなくなります。

pg_upgrade を link モードで実行すると、古いデータベース クラスタがレンダリングされ、アクセスできなくなります。古いクラスタにロールバックする必要が生じた場合、データをバックアップから復元する必要があります。

以降はアップグレード プロセスの概要です。詳細なアップグレード手順については PostgreSQL 12 Documentation — pg_upgrade をご確認ください。

  1. PostgreSQL 12 をインストールし、新しいデータベース クラスタを初期化します。

  2. 古いクラスタで使われていた任意のカスタム共有オブジェクト ファイルをインストールし、認証を調整します。

  3. Jira と PostgreSQL サーバーの両方を停止します。

  4. pg_upgrade を実行します (--link オプションを追加して pg_upgrade を link モードで実行します)。

  5. Perform a  VACUUM ANALYZE operation on the new database to regenerate optimizer statistics. Also consider running a database REINDEX.
    For more information, see PostgreSQL 12 documentation — ANALYZE and Optimize and Improve PostgreSQL Performance with VACUUM, ANALYZE, and REINDEX.
  6. PostgreSQL 12 サーバーを開始し、必要に応じてアップグレード後のプロセスを実行します。

  7. pg_upgrade.log ファイルと、Jira が正常に動作していることを確認して、アップグレードを検証します。

  8. アップグレードが正常に完了したことを確認したら、古い PostgreSQL 9.6 データベース クラスタを削除します。

論理レプリケーションを使って PostgreSQL 12 に最小限のダウンタイムでアップグレードする

現在、高可用性のクラスタ構成で PostgreSQL を実行している場合、PostgreSQL のネイティブのレプリケーション ツールまたは外部のレプリケーション システムを使い、プライマリ サーバーのデータを、PostgreSQL 12 を実行している新しいスタンバイ サーバーに複製できます。この方法ではアップグレードのために Jira または現在のデータベース サーバーをオフラインにする必要はなく、スイッチオーバーを行うために必要な数秒間にダウンタイムを最小化できます。

詳細については次の情報をご確認ください。

Amazon RDS インスタンスを PostgreSQL 12 にアップグレードする

PostgreSQL 9.6 を Amazon RDS インスタンス上で実行している場合、この方法を使用して PostgreSQL 12 にアップグレードできます。Amazon RDS はアップグレードの実行に内部で pg_upgrade ユーティリティを使用します。

これはオフラインのアップグレード方法です。アップグレード中は Jira と PostgreSQL データベースの両方が利用できなくなります。

以降はアップグレード プロセスの概要です。詳細なアップグレード手順については、Amazon Relational Database Service Documentation — Amazon RDS の PostgreSQL DB エンジンのアップグレードをご確認ください。

  1. 現在の PostgreSQL データベースのスナップショットを作成します。

  2. RDS のドキュメントの説明に従い、AWS Management Console、AWS の CLI、または RDS API 経由でアップグレードを開始します。

  3. アップグレードされたデータベースのスナップショットを作成します。

  4. Perform a  VACUUM ANALYZE operation on the new database to regenerate optimizer statistics. Also consider running a database REINDEX.
    For more information, see PostgreSQL 12 documentation — ANALYZE and Optimize and Improve PostgreSQL Performance with VACUUM, ANALYZE, and REINDEX.

  5. 必要に応じ、PostgreSQL の拡張機能をアップグレードします。

  6. pg_upgrade_internal.log および pg_upgrade_server.log ファイルと、Jira が正常に動作していることを確認して、アップグレードを検証します。

Additional steps if you use our QuickStart templates

If your current Jira version supports PostgreSQL 12:

  1. Scale your instance down to zero nodes.
  2. Follow the steps above to manually upgrade the Postgres RDS instance from 9.6 to 12.
    Important note: don't change the DBEngineVersion parameter in the template, as this will result in a DBGroup error. 
  3. Wait for the RDS upgrade to complete.
  4. Scale your cluster up to 1 node first, check everything is working with no issues, then you can scale your cluster back up to the ideal number. 

If your current Jira version does not support PostgreSQL 12, you will also need to upgrade Jira after the RDS upgrade is complete (before scaling your cluster up to 1 node). Refer to the Normal upgrade section of Upgrading Jira Data Center on AWS for full details of how to upgrade.

Note that the DBEngineVersion parameter in the QuickStart template will continue to be set to version 9.6. If you try to change this parameter you will get a DBGroup error. As long as your application is connected to the new database version, there shouldn't be any problems. 


説明 PostgreSQL 9.6 から PostgreSQL 12 にアップグレードする方法
製品Jira Core, Jira Service Management, Jira Software



最終更新日 2023 年 6 月 30 日

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

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