要約

Confluence goes to some lengths to prevent itself from becoming unusable due to a problematic add-on, but it's still possible. This page describes what to do if an app cannot be disabled or deleted using the Universal Plugin Manager in the Confluence administration console.

Removing add-ons manually

アドオンの場所

1. アドオン ファイルの場所を確認します。通常は次の場所にあります。
   1. データベースの PLUGINDATA テーブル
   2. <Confluence ホーム>/bundled-plugins フォルダ
   3. <Confluence ホーム>/plugin-cache フォルダ
   4. <Confluence ホーム>/plugins-osgi-cache フォルダ
   5. <Confluence ホーム>/plugins-temp フォルダ
   6. <Confluence インストール ディレクトリ>/confluence/WEB-INF/lib フォルダ (廃止予定)

アドオンの読み込みの問題のトラブルシューティングを行うときにはこれらの場所を確認します。

開始時にアドオンを一時的に無効化する (Confluence 6.1 以降)

アドオンの問題のトラブルシューティングを行っている場合や、Confluence またはアドオンの更新後に Confluence が起動しない場合は、開始時にアドオンを一時的に無効化できます。これによって Confluence を開始し、場合によっては UPM を使用して問題のあるアドオンを削除できます。  

すべての非システム アドオンを一時的に無効化するには、次の手順を実行します。

$ ./start-confluence.sh --disable-all-addons

 > start-confluence.bat /disablealladdons

If Confluence is unable to manually start within Windows, please see if CONFSERVER-60001 In Windows, Confluence can't start manually after an upgrade applies.  If so, try the prescribed workaround.

特定のアドオンを一時的に無効化するには、アドオンのキー (例: com.atlassian.test.plugin) を指定します。コロン区切りのリストを使用して、複数のアドオンを無効化することができます。

$ ./start-confluence.sh --disable-addons=com.atlassian.test.plugin

> start-confluence.bat /disableaddon=com.atlassian.test.plugin

これらのパラメータはスタートアップ時のみ適用されます。再起動後は保持されません。アドオンを永続的に無効化または削除したい場合は引き続き UPM (UPM が利用できない場合は以降の方法のいずれか) を利用する必要があります。

アドオンをデータベースから削除

Confluence が実行されていないときに Confluence からアドオンを削除する方法

1. Confluence のデータベースに接続します。

2. データベース内で次の SQL ステートメントを実行します。

   select PLUGINDATAID, PLUGINKEY, FILENAME, LASTMODDATE from PLUGINDATA;
   

3. 問題のあるアドオンの plugindataid 値を見つけたら、次のように実行します。

   delete from PLUGINDATA where PLUGINDATAID= XXXXXX;
   

   ここで、XXXXXX が plugindataid 値です。

4. Confluence を再起動します。

  If the add-on is subsequently re-added to Confluence, its previous configurations will still be present.

アドオンをデータベースから無効化

データベース内でアドオンを無効化する方法

Confluence のデータベースで次のクエリを実行します。

select BANDANAVALUE from BANDANA where BANDANAKEY = 'plugin.manager.state.Map';

次のような値が返されます。

<map>
  <entry>
    <string>com.atlassian.confluence.ext.usage</string>
    <boolean>true</boolean>
  </entry>
</map>

プラグインを無効化するには、ブール値を false にします。

<map>
  <entry>
    <string>com.atlassian.confluence.ext.usage</string>
    <boolean>false</boolean>
  </entry>
</map>

Confluence のキャッシュをクリアするか Confluence を再起動して、変更を適用します。

バンドルされたアドオンの削除

バンドルされたアドオンは、アドオンの管理ページ内のアプリケーションの管理コンソールで管理できます。ここで、アップロードや無効化を行えます。

The bundle add ons are located at the directory <confluence-install>/confluence/WEB-INF/atlassian-bundled-plugins. At Confluence startup, they are copied into the $CONFLUENCE_HOME/bundled-plugins directory, from whence they are loaded. To remove a bundled add-on (you normally shouldn't have to do this), remove the add-on from the atlassian-bundled-plugins directory and the bundled-plugins directory, otherwise Confluence will just put it back in place on the next startup. You'll have to recreate the .jar file (if the jar file is from the lib folder) or recreate the zip folder (if its in the classes folder). Bundled add-ons can be upgraded or disabled.

バンドルされたアドオンを削除する必要がある場合、<confluence-home>/bundled-plugins または <confluence-home>/plugin-cache ディレクトリに重複があるかどうかを確認します。

多くの場合、適切にバンドルされたアドオンと古いアドオンが同時に読み込まれるのが問題になります。

See also CONFSERVER-52749 Cannot start Confluence due to corrupt plugin cache.