How to change the Confluence Data Center License in confluence.cfg.xml file

プラットフォームについて: Data Center のみ。 - This article only applies to Atlassian apps on the Data Center プラットフォーム

この KB は Data Center バージョンの製品用に作成されています。Data Center 固有ではない機能の Data Center KB は、製品のサーバー バージョンでも動作する可能性はありますが、テストは行われていません。 Server* 製品のサポートは 2024 年 2 月 15 日に終了しました。Server 製品を実行している場合は、 アトラシアン Server サポート終了 のお知らせにアクセスして、移行オプションを確認してください。

*Fisheye および Crucible は除く

要約

As a Confluence administrator, you might need to manually change the license directly in confluence.cfg.xml file for any number of reasons including:

  • アップグレードに失敗する

  • ライセンスが破損している

  • Confluence の UI でライセンスを変更できない

  • など

ソリューション

If that is the case, please, follow below steps to achieve it:

  1. Install a new instance of Confluence using the same Confluence version.

    • Be sure to use the license listed at https://my.atlassian.com

    • 必要な情報はライセンス情報のみのため、この手順では組み込みの HSQL データベースを使用することができます。

    • この新しいインストールを、ライセンスの適用先と同じサーバーで実行する必要はありません。

  2. After you have completed all steps in the Confluence setup wizard, open this new instance's <confluence_home>/confluence.cfg.xml file.

  3. 次のプロパティを確認します。

    <property name="atlassian.license.hash">xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</property> <property name="atlassian.license.message">yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy</property>

    Confluence の一部のバージョンではハッシュ化されたライセンスが要求されません。これらのバージョンでは、confluence.license.message プロパティを編集します。

  4. Copy these properties into the original <confluence_home>/confluence.cfg.xml file replacing the information already there

  5. Confluence を起動します。

  6. この時点で、一時インスタンスを削除してかまいません。

更新日時: September 25, 2025

さらにヘルプが必要ですか?

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