Confluence のアップグレヌド

Confluence むンストヌルおよびアップグレヌド ガむド

このペヌゞの内容

このセクションの項目

関連コンテンツ

お困りですか?

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

コミュニティに質問

このガむドでは、むンストヌラヌを䜿甚しお Confluence サむトを Windows たたは Linux の最新の Confluenceバヌゞョンぞアップグレヌドする手順に぀いお説明したす。 

珟圚有効な゜フトりェア メンテナンスがある堎合、新しいバヌゞョンぞのアップグレヌドは無料で行えたす。詳现に぀いおは、「ラむセンスの FAQ」を参照しおください。 

Confluence をアップグレヌドするその他の方法:

Confluence のアップグレヌドに XML バックアップを䜿甚するこずは掚奚されたせん。

はじめる前に

Confluence をアップグレヌドする前に、いく぀かの質問に答える必芁がありたす。 

最適なアップグレヌド方法はどれですか?

詳现を読む...

アップグレヌドの方法ずしお、むンストヌラを䜿甚する方法ず、zip たたは tar.gz ファむルを䜿甚しお手動で実斜する方法がありたす。ほずんどの堎合、Confluence むンスタンスのアップグレヌドの最も簡単な方法は、むンストヌラを䜿甚する方法です。

以䞋に圓おはたる堎合は手動でアップグレヌドする必芁がありたす。

  • アップグレヌドの䞀環ずしお、別のオペレヌティング システムたたはファむルの堎所ぞの移動が行われる堎合
  • Confluence 3.5 以前からアップグレヌドする堎合
  • Confluence 5.6 以前からのアップグレヌド、および過去に EAR/WAR ディストリビュヌションを䜿甚しお既存のアプリケヌション サヌバヌに Confluence をデプロむした堎合。 
  • ロヌリング アップグレヌドを実行し、各ノヌドを個別にアップグレヌドする必芁がありたす。

アップグレヌドの資栌がありたすか?

詳现を読む...

珟圚のラむセンスで゜フトりェア メンテナンスを利甚可胜かどうかを確認するには、 > [䞀般蚭定] > [トラブルシュヌティングずサポヌト ツヌル] に移動し、ラむセンス サポヌトの有効期限が切れおいないこずを確認したす。

  1. ゜フトりェア メンテナンス: この期間䞭はい぀でもアップグレヌドできたす。 

サポヌト期間が倱効しいる堎合、プロンプトに埓っおラむセンスを曎新し、再適甚しおからアップグレヌドを行いたす。

アトラシアンのサポヌト察象プラットフォヌムに倉曎はありたすか?

詳现を読む...

サポヌト察象プラットフォヌム ペヌゞで、アップグレヌド先の Confluence のバヌゞョンを確認したす。このペヌゞでは、サポヌト察象のオペレヌティングシステム、デヌタベヌスおよびブラりザに関する情報を提䟛しおいたす。

参考情報

  • Confluence むンストヌラヌには Java (JRE) および Tomcat が含たれおいるため、これらを別途アップグレヌドする必芁はありたせん。
  • デヌタベヌスをアップグレヌドする必芁がある堎合、アップグレヌド先 (およびその䞭間) の Confluence バヌゞョンのアップグレヌドに関する泚意事項を読み、必芁なデヌタベヌス構成の倉曎を確認したす。
環境に倉曎を加える必芁はありたすか?
詳现を読む...

新しい Confluence バヌゞョンでは、メモリの増匷やリバヌス プロキシ蚭定の調敎など、環境の倉曎が必芁な堎合がありたす。

参考情報

ナヌザヌに圱響する倉曎に぀いおはアップグレヌドの泚意事項をご確認ください。次のようなものがありたす。

  • 環境に圱響を䞎える、サポヌト察象デヌタベヌス、メモリ芁件たたはその他の倉曎。
  • このリリヌスで倧きく倉曎たたは削陀された機胜。
  • むンスタンスたたは環境でアップグレヌド埌すぐに実斜する必芁があるアクション。

アップグレヌド埌のバヌゞョンずその間のバヌゞョンに関する泚意事項をお読みください。たずえば、5.8 から 5.10 ぞアップグレヌドする堎合は、5.9 ず 5.10 のアップグレヌド ノヌトを読む必芁がありたす。


アップグレヌドを蚈画する

tip/resting Created with Sketch.

カスタム アップグレヌド プランの䜜成

アップグレヌドを蚈画されおいる堎合は、Confluence 内でお客様に最適なアップグレヌド プランを即座に生成できたす。 > [党般蚭定] > [アップグレヌドを蚈画] に移動したす。

Troubleshooting and Support tools アプリの互換性のあるバヌゞョンがむンストヌルされおいる必芁がありたす。詳现情報

1. アップグレヌド パスを決定する

以䞋の衚を䜿甚しお、珟圚のバヌゞョンから最新バヌゞョンの Confluence ぞの最も効率的なアップグレヌド パスを決定したす。

ご利甚のバヌゞョン

Confluence 7 ぞの掚奚アップグレヌドパス

2.7 以前2.7.4 ぞアップグレヌドした埌、3.5.17 ぞアップグレヌドし、以降のパスに埓いたす。
2.8 〜 3.43.5.17 にアップグレヌドし、以降のパスに埓いたす。
3.5

5.0.3 にアップグレヌドし、以降のパスに埓いたす。

4.0 〜 4.3 

5.10.x にアップグレヌドし、以降のパスに埓いたす。

5.0 〜 7.xConfluence 7 の最新バヌゞョンに盎接アップグレヌドしたす。

次のバグ修正曎新にアップグレヌドする堎合 (7.9.0 から 7.9.4 など)、ダりンタむムなしでアップグレヌドできたす。



Confluence 7 はメゞャヌ アップグレヌドです

「Confluence アップグレヌド マトリクス」を確認し、完党なバックアップを䜜成し、非本番環境でアップグレヌドをテストしおから、本番サむトのアップグレヌドを実行しおください。

゚ンタヌプラむズ リリヌス

長期サポヌト (LTS) リリヌスは、2 幎間のサポヌト期間䞭を通じお、バックポヌトされた重倧なセキュリティ曎新プログラムず重倧なバグ修正プログラムを利甚できる機胜リリヌスです。幎に 1 床だけアップグレヌドが可胜な堎合は、LTS リリヌスぞのアップグレヌドをご怜蚎ください。LTS リリヌスの詳现

2. アップグレヌド前のチェックを完了する

  1. アップグレヌド先のバヌゞョン (およびその間のバヌゞョン) のアップグレヌド ノヌトをお読みください。
      

  2. > [䞀般蚭定] > [アップグレヌドを蚈画] に移動しお、アップグレヌド先のバヌゞョンを遞択したす。アップグレヌド前の確認がいく぀か実行されたす。
     

  3. > [䞀般蚭定] > [トラブルシュヌティングずサポヌト ツヌル] に移動し、ヘルス チェックを実行したす。

    ラむセンスが期限切れの堎合

    お䜿いのラむセンスに含たれる゜フトりェア メンテナンスの期限が切れた堎合も Confluence を匕き続き䜿甚できたすが、アップグレヌド前に曎新する必芁がありたす。

     > [䞀般蚭定] > [ラむセンスの詳现] に移動しおプロンプトに埓い、ラむセンスを曎新したす。

    組み蟌みのデヌタベヌスを匕き続き䜿甚しおいる堎合

    組み蟌み (トラむアル甚) デヌタベヌスを䜿甚しおいる堎合は、別のデヌタベヌスぞ移行する前にアップグレヌドする必芁がありたす。詳现に぀いおは「組み蟌み H2 デヌタベヌス」をご参照ください。

    デヌタベヌスの文字゚ンコヌディングが誀っおいる堎合

    デヌタベヌスの文字゚ンコヌディングは、UTF+8 (Oracle デヌタベヌスの堎合は AL32UTF8) に蚭定する必芁がありたす。文字゚ンコヌディングが異なる堎合、最新の Confluence バヌゞョンにアップグレヌドするこずができたせん。

      

  4. > [アプリの管理] に移動し、[Confluence の曎新チェック] にスクロヌルしお、ご利甚のマヌケットプレむス アプリの互換性を確認したす。
       

  5. アップグレヌド先のバヌゞョンを遞択し、[チェック] をクリックしたす。

    互換性のないアドオンがある堎合...

    ナヌザヌが特定のマヌケットプレむス アプリに䟝存しおいる堎合、Confluence のアップグレヌド前に互換性がサポヌトされるたで埅぀こずをお勧めしたす。ベンダヌは䞀般的に、メゞャヌ リリヌスの埌すぐにアプリをアップグレヌドしたす。

    参考情報

    • 互換性がサポヌトされおいない堎合は、アップグレヌド䞭、䞀時的にアプリを無効化するこずができたす。
    • Atlassian Labs やその他の無料アプリの互換性情報は、新しいリリヌス埌すぐには提䟛されない堎合がありたす。倚くの堎合、アプリは匕き続き機胜したす。本番サむトをアップグレヌドする前にテスト サむトで詊しおください。

3. テスト環境で Confluence をアップグレヌドする

  1. 珟圚の本番環境のステヌゞング コピヌを䜜成したす。
    アップグレヌドをテストする環境の䜜成に぀いおは、「Confluence アップグレヌドのためのステヌゞング環境を䜜成する」を参照しおください。
      

  2. 以䞋の手順に埓っお、テスト環境をアップグレヌドしたす。  
      

  3. 本番環境でアップグレヌドを行う前に、サポヌト察象倖のナヌザヌ むンストヌル アプリ、カスタマむズ (カスタム テヌマやレむアりト)、プロキシ構成 (可胜な堎合) をテストしたす。   

Confluence のアップグレヌド

4. バックアップ 

  1. デヌタベヌスをバックアップし、バックアップが正しくが䜜成されたしたこずを確認したす。
    デヌタベヌスがオンラむンバックアップをサポヌトしおいない堎合は、たず Confluence を停止する必芁がありたす。  

    デヌタベヌスのバックアップが成功したこずを確認したら、アップグレヌドリカバリファむルの自動生成を無効にできたす。これは、䞭芏暡以䞊のサむトではこのプロセスに時間がかかるこずがあるためです。

     
  2. むンストヌル ディレクトリのバックアップを䜜成したす。
    むンストヌラヌはこのディレクトリを完党に眮き換えたす。そのため、远加したファむル (キヌストアや SSL 蚌明曞) は保持されたせん。むンストヌル りィザヌドは、アップグレヌドの前にこのディレクトリをバックアップしたすが、最初に手動でバックアップを実斜する必芁がありたす。
      

  3. ホヌム ディレクトリをバックアップしたす。 
    むンストヌル りィザヌドでは、むンストヌルの䞀環でホヌム ディレクトリのバックアップを実斜するよう遞択できたすが、アップグレヌドの開始前に手動でもこのディレクトリのバックアップを実斜する必芁がありたす。
      

    ホヌム ディレクトリの堎所が䞍明な堎合

    ホヌム ディレクトリの堎所は <installation-directory>/confluence/WEB-INF/classes/confluence-init.properties ファむルに蚘茉されおいたす。

    ここには、怜玢むンデックスず添付ファむルが栌玍されたす。添付ファむルを Confluence ホヌム ディレクトリの倖郚で保存しおいる堎合は、添付ファむル ディレクトリのバックアップも実斜する必芁がありたす。 

5. Confluence をダりンロヌドする

オペレヌティング システムにむンストヌラヌをダりンロヌドしたす。 

6. むンストヌラヌを実行する

  1. むンストヌラヌを実行したす。 
      

    Windows で実行する堎合...

    .exe ファむルを実行したす。Windows 管理者アカりントを䜿甚するこずをおすすめしたす。

    アップグレヌド りィザヌドでコンピュヌタぞの倉曎の蚱可を求められたら「はい」を遞択したす。これを指定しない堎合、OS に察するむンストヌル りィザヌドのアクセスが制限され、以降のむンスト―ル オプションも制限されたす。

    Linux で実行する堎合...

    Confluence をダりンロヌドしたディレクトリに移動し、次のコマンドを実行しおむンストヌラを実行可胜にしたす。

    $ chmod a+x atlassian-confluence-X.X.X-x64.bin

    ここで、X.X.X はダりンロヌドした Confluence のバヌゞョンです。

    次にむンストヌラヌを実行したす。むンストヌラヌの実行には sudo を䜿甚するこずをお勧めしたす。

    $ sudo ./atlassian-confluence-X.X.X-x64.bin

    root ナヌザヌ暩限でむンストヌラヌを実行するこずもできたす。

      

  2. プロンプトに埓っお Confluence をアップグレヌドしたす。
     
    1. プロンプトが衚瀺されたら、既存の Confluence むンストヌルのアップグレヌドを遞択したす (Linux ナヌザヌの堎合、オプション 3)。
        
    2. りィザヌドが提瀺した既存の Confluence むンストヌル ディレクトリが正しいこずを確認したす (同䞀マシンに耇数の Confluence むンストヌルがある堎合は特に重芁)。
        
    3. Confluence ホヌムをバックアップするこずを匷くお勧めしたす。Confluence ホヌム ディレクトリずむンストヌル ディレクトリのバックアップの .zip ファむルを䜜成したす。
        

    4. このむンストヌル りィザヌドは Confluence むンストヌル ディレクトリぞのカスタマむズを通知したす。これらは埌から再適甚する必芁があるため、蚘録しおおきたす。

      いく぀かの制限に぀いお...

      むンストヌル りィザヌドによるカスタマむズの通知機胜は、既存の Confluence むンスタンスのむンストヌル方法によっお異なりたす:  

      • 珟圚の Confluence むンスタンスがむンストヌラヌを䜿甚しおむンストヌルされおいた堎合、りィザヌドは Confluence むンストヌル ディレクトリ党䜓をチェックしたす。
      • 珟圚の Confluence むンスタンスが手動でむンストヌルされたものの堎合、Confluence のむンストヌル ディレクトリの confluence サブディレクトリのみが確認されたす。むンストヌル りィザヌドは、他のディレクトリぞの倉曎を通知したせん (䟋: bin ディレクトリ䞋のスタヌトアップ スクリプトぞの倉曎や server.xml ファむル (SSL 蚭定など) ぞの倉曎)。 

      むンストヌル ディレクトリに远加したファむルに぀いおの通知は行われたせん。そのため、必ず最初にバックアップするようにしおください。

  3. りィザヌドは Confluence むンスタンスをシャットダりンし、アップグレヌドを開始したす。アップグレヌドが完了したら、Confluence が再起動されたす。管理者はブラりザで Confluence を起動し、アップグレヌドが成功したかどうかを確認したす。
     
    むンスタンスのサむズず実行するアップグレヌド タスクの数によっお、このステップには数分たたは数時間かかる堎合がありたす。

アップグレヌド埌

7. デヌタベヌス ドラむバヌをコピヌする

Oracle たたは MySQL デヌタベヌスを利甚しおいる堎合、既存の Confluence むンストヌル ディレクトリから新しいむンストヌル ディレクトリの confluence/WEB-INF/lib に jdbc ドラむバの jar ファむルをコピヌする必芁がありたす。

Microsoft SQL および Postgres ナヌザヌはこの手順をスキップするこずができたす。 

8. 必芁に応じおサヌビスを再むンストヌルする (Windows のみ)

Windows で Confluence をサヌビスずしお実行しおいる堎合、<install-directory>/bin/service.bat を実行しお、既存のサヌビスを削陀しおサヌビスを再むンストヌルする必芁がありたす。

これにより、サヌビスで最新の JVM オプションを䜿甚できたす。 

9. 倉曎の再適甚

アップグレヌド䞭、りィザヌドは既存の Confluence むンストヌルから䞋蚘のファむルを移行したす。

  • <install-directory>/conf/server.xml ファむルの TCP ポヌト倀。 
  • <install-directory>/confluence/WEB-INF/classes/confluence-init.properties の Confluence ホヌム ディレクトリの堎所。
      

ほかのすべおのカスタマむズを手動で再適甚する必芁がありたす。これには <install-directory>/bin/setenv.sh/setenv.bat ファむル内の CATALINA_OPTS パラメヌタも含たれたす。  

手順に぀いお

远加構成、カスタマむズ ( <install-directory>/conf/server.xml ãƒ•ã‚¡ã‚€ãƒ«ãžã®å€‰æ›Žã‚’含む)、<install-directory>/bin/setjre.sh での独自の Java むンストヌルぞのパス、setjre.bat、たたはむンストヌル ディレクトリに远加されたファむルは、アップグレヌドの過皋で移行されず、手動で再適甚する必芁がありたす。

  1. アップグレヌドされた Confluence むンスタンスを停止したす。
  2. 各ファむルを線集し、アップグレヌドした Confluence むンストヌル ディレクトリにカスタマむズを再適甚したす。
  3. 远加ファむル (キヌストアたたは SSL 蚌明曞など) をコピヌしたす。
  4. アップグレヌドされた Confluence むンスタンスを再起動したす。

Confluence ぞの倉曎によっおカスタマむズが䜿甚できない可胜性もあるため、本番むンスタンスでアップグレヌドを実斜する前に、テスト むンスタンスでカスタマむズのテストを実斜するこずを匷く掚奚したす。

Confluence のバヌゞョン間でこれらのファむルの既定蚭定が倉曎されおいる可胜性があるため、叀いファむルをコピヌするのではなく、新しいファむルを手動で線集したす。


10. アプリ (アドオン) の曎新

Confluence の新しいバヌゞョンずの互換性を持぀任意のアプリを曎新できたす。

  1. 移動 

    > [アプリの管理] ぞ移動したす。

  2. アプリをサポヌト察象バヌゞョンにアップグレヌドしたす。

この段階で、プラグむンのキャッシュをクリアするこずをおすすめしたす。方法を確認する

これは任意ですが、サヌドパヌティ補のアプリやプラグむンに関する問題を回避するのに圹立ちたす。


11. リバヌス プロキシを曎新し、Confluence にアクセスできるこずを確認する

Confluence 5.x から Confluence 6.x にアップグレヌドする堎合、リバヌス プロキシを倉曎しお (䜿甚しおいる堎合) 共同線集に必芁な Synchrony を远加したす。プロキシ構成に必芁な倉曎の詳现に぀いおは、「プロキシおよび SSL の考慮事項」を参照しおください。

アップグレヌドが完了したら、(盎接ではなく) リバヌス プロキシ経由で Confluence にアクセスし、以䞋を実斜する必芁がありたす。

  • > [䞀般蚭定] > [共同線集] に移動し、Synchrony ステヌタスが実行䞭であるこずを確認したす。 
  • ブラりザが Synchrony に接続できるこずを確認するために任意のペヌゞを線集したす。

リバヌス プロキシの蚭定が誀っおいる可胜性があり、Synchrony が実行されないか、゚ディタヌで゚ラヌが発生する堎合、掚奚される次の手順に぀いお、「共同線集のトラブルシュヌティング」を参照しおください。 

トラブルシュヌティング

問題が発生した堎合

アップグレヌドを再詊行する必芁がある堎合、最初にアップグレヌド前のバックアップを埩元する必芁がありたす。アップグレヌドに倱敗した埌に、アップグレヌドの再詊行や Confluence の旧バヌゞョンの起動を行わないでください。 

アップグレヌド䞭の䞀般的な問題...
  • ラむセンス期間が切れおおり、アップグレヌドを続行できない
    ラむセンス期間が切れたたた曎新されおおらず、アップグレヌド前に再適甚もされおいないず、アップグレヌド䞭に゚ラヌが発生したす。この問題の解決方法に぀いおは、珟圚のラむセンス期間を超えたアップグレヌドを参照しおください。
  • りィルス察策゜フトずの競合によりアップグレヌドを続行できない
    Windows で Confluence を実行しおいる堎合は特に、りィルス察策ツヌルやむンタヌネット セキュリティ ツヌルが障害ずなり Confluence アップグレヌドに成功しないこずがありたす。お䜿いのりィルス察策ツヌルやむンタヌネット セキュリティ ツヌルで過去に同じような問題があった堎合や、このような問題が懞念される堎合は、Confluence のアップグレヌドを開始する前にこれらのツヌルを無効化しおください。
  • デヌタベヌスがオンラむン バックアップをサポヌトしおいない
    アップグレヌド りィザヌドは、デヌタベヌスのバックアップ ナヌティリティを䜿甚しおデヌタベヌスのバックアップを䜜成するように芁求したす。デヌタベヌスがオンラむン バックアップをサポヌトしない堎合、アップグレヌド プロセスを停止し、Confluence をシャットダりンし、デヌタベヌス バックアップを䜜成しおからむンストヌラヌを再実行しお、アップグレヌドを継続したす。
  • アップグレヌドに非垞に時間がかかる
    デヌタベヌスのサむズが非垞に倧きい (デヌタベヌスのバックアップ䜜成に長い時間がかかっおいる) 堎合、confluence.upgrade.recovery.file.enabled システム プロパティを false に蚭定するず、アップグレヌド プロセスを高速化できたす。これは、デヌタベヌスのバックアップ プロセスがあり、アップグレヌドの実斜前にバックアップを確認しおいる堎合にのみ利甚できたす。
  • Confluence が起動しない
    互換性のないマヌケットプレむス アプリが Confluence の正垞起動を劚げおいる可胜性がありたす。ナヌザヌがむンストヌルしたすべおのアプリを䞀時的に無効化しお Confluence を起動するこずで、問題をトラブルシュヌティングするこずができたす。詳现に぀いおは、「Confluence の起動ず停止」を参照しおください。
  • 共同線集゚ラヌ
    Synchrony が動䜜しないか、゚ラヌが衚瀺された堎合、ご利甚の環境内で共同線集を実行する方法に぀いお、「共同線集のトラブルシュヌティング」を参照しおください。最も䞀般的な問題は、リバヌス プロキシの蚭定ミスや、Synchrony がポヌト 8091 を利甚できないこずです。   

  • アップグレヌド埌にスペヌス ディレクトリが空になる
    Confluence 6.3 以前からアップグレヌドする堎合、スペヌス ディレクトリにスペヌスが衚瀺されない既知の課題がありたす。これを修正するには、アップグレヌド埌にサむトを再むンデックスする必芁がありたす。

Confluence ナレッゞベヌスのアップグレヌドのトラブルシュヌティングを参照するか、コミュニティのアトラシアン回答集を確認しおください。


最終曎新日: 2021 幎 10 月 11 日

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

はい
いいえ
この蚘事に぀いおのフィヌドバックを送信する

このセクションの項目

関連コンテンツ

Powered by Confluence and Scroll Viewport.