How to disable the content re-migration job on startup
プラットフォームについて: Data Center - この記事は、Data Center プラットフォームのアトラシアン製品に適用されます。
このナレッジベース記事は製品の Data Center バージョン用に作成されています。Data Center 固有ではない機能の Data Center ナレッジベースは、製品のサーバー バージョンでも動作する可能性はありますが、テストは行われていません。サーバー*製品のサポートは 2024 年 2 月 15 日に終了しました。サーバー製品を利用している場合は、アトラシアンのサーバー製品のサポート終了のお知らせページにて移行オプションをご確認ください。
*Fisheye および Crucible は除く
目的
Because of a fix in Confluence 5.7.4 ( CONF-35004 ), each restart following a plugin update/upgrade/install triggers a job to re-migrate "unmigrated" pages, which includes pages that have unknown macros. These pages will get re-migrated again if any plugins are updated/enabled/re-enabled and followed by a restart. This creates additional entries in the change histories of the "re-migrated" pages, and can have a possible performance impact since attachments on such re-migrated pages are then re-indexed.
ソリューション
For Confluence 5.10.7 and below
You can disable the remigration job via SQL.
データベースの変更を行う場合は必ず事前にバックアップを取得してください。可能な場合は、まずステージング サーバーで SQL コマンドの変更、挿入、更新、または削除を行うようにします。
Before every Confluence startup, run the following query to determine whether the content remigration job will be triggered:
SELECT * FROM BANDANA WHERE BANDANAKEY = 'migration.required';
If the "bandanavalue" column shows "true", then update this to "false" to prevent the startup from starting the re-migration job.
UPDATE BANDANA SET BANDANAVALUE = '<boolean>false</boolean>' WHERE BANDANAKEY = 'migration.required';
This value should be checked on every restart because the aforementioned plugin operations may set the "migration.required" value back to "true".
For Confluence 5.10.8 and above
A system variable was added to enable/disable remigration behavior during startup. To use this feature:
- Open CONF_INSTALL_FOLDER/bin/setenv.sh (or setenv.bat under Windows)
Locate "CATALINA_OPTS" and add the following line to the file:
CATALINA_OPTS="-Dconfluence.startup.remigration.disable=true $ {CATALINA_OPTS}"
- Save the file and restart Tomcat