Universal Plugin Manager のインストール

Universal Plugin Manager (UPM) は UPM を使用するアトラシアンのホスト アプリケーションの最新バージョンに事前インストールされているため、通常は UPM を手動でインストールする必要はありません。

If you do need to install the UPM manually for some reason, you can download the JAR file from the Universal Plugin Manager page on the Atlassian Marketplace.

インストールしようとしている UPM のバージョンがご利用のアプリケーション バージョンでサポートされていることを確認します。これは、Marketplace の UPM のページのバージョン履歴情報で確認できます。

1. このバージョンの UPM とご利用のアプリケーション バージョンとの互換性を確認します。
2. UPM の JAR ファイルをダウンロードします。 

JAR をダウンロードしたら、後述のように適切なディレクトリにコピーすることでインストールします。UPM の JAR ファイルを削除したり置き換えたりするのではなく、ファイルを対象のディレクトリにコピーします。

UPM は "Plugins 2" タイプのアプリであるため、そのタイプ用のディレクトリに UPM の JAR ファイルを移動するようにします。

Jira アプリケーション

How you do this depends on whether you run Jira in a cluster. 

To update the UPM file on disk in a Jira cluster:

1. Download the UPM JAR from the Atlassian Marketplace. 
2. Remove the existing UPM JAR file from this directory <jira-shared-home>/plugins/installed-plugins.
3. Place the new UPM .jar file in <jira-shared-home>/plugins/installed-plugins folder.
4. Perform a rolling restart of all cluster nodes:
   1. Stop Jira on the first node
   2. Clear the plugins cache on that node by removing the following directories
      

      <jira-local-home>/plugins/.bundled-plugins
      <jira-local-home>/plugins/.osgi-plugins

   3. Start Jira on that node
   4. Repeat these steps for the remaining nodes. 

To update the UPM file on disk in Jira applications (non-clustered):

1. アプリケーションをシャットダウンします。
2. Jira のホーム ディレクトリで、次のディレクトリから既存の UPM の JAR ファイルを削除します。
   plugins/installed-plugins
   JAR ファイルの名前の先頭には次のように数字が使われている場合があります。
   846688264762062110.atlassian-universal-plugin-manager-plugin-2.7.6.jar
3. 新しい UPM の JAR ファイルを同じディレクトリにコピーします。
4. Clear the plugins cache by removing the following directories
   

   <jira-local-home>/plugins/.bundled-plugins
   <jira-local-home>/plugins/.osgi-plugins

5. Restart your Jira application.

Confluence

Confluence は UPM などのアドオンをデータベースに保管するため、ファイル置換による更新プロセスは他の製品での手順とは少し異なります。

Confluence で UPM ファイルを更新するには、次の手順を実行します。

1. Download the UPM JAR from the Atlassian Marketplace. 
2. Confluence を停止します。 
3. <install-directory>/confluence/WEB-INF/atlassian-bundled-plugins から既存の UPM の JAR ファイルを削除します。
4. 新しい UPM の JAR ファイルを同じディレクトリにコピーします。 
5. Confluence のプラグイン キャッシュをクリアします。 

6. ダウングレードのみ: 次のクエリで行を削除する必要があるため、データベースの完全なバックアップを取得します。

   DELETE FROM plugindata WHERE pluginkey LIKE 'com.atlassian.upm.atlassian-universal-plugin%';

7. Confluence を再起動します。

FishEye

Fisheye でディスク上の UPM ファイルを更新するには、次の手順を実行します。

1. Fisheye インスタンスをシャットダウンします。
2. アーカイブ管理ツールを使い、Fisheye のインストール ディレクトリで次のアーカイブを開きます。
plugins/bundled-plugins.zip 

3. ZIP ファイルから既存の atlassian-universal-plugin-manager-plugin-x.x.x.jar を削除します。展開は行わないでください。
4. 新しいプラグイン バージョンをダウンロードしたフォルダから、新しい プラグイン バージョンを zip ファイルに追加します。
5. ZIP ファイルを閉じます。
6. Fisheye のインストール ディレクトリから次のファイルを削除します。
var/plugins/bundled/atlassian-universal-plugin-manager-plugin-x.x.x.jar
7. インスタンスを再起動します。

Stash/Bitbucket Server

Stash/Bitbucket Server でディスク上の UPM ファイルを更新するには、次の手順を実行します。

1. Stash/Bitbucket Server をシャットダウンします。
2. Stash/Bitbucket Server のホーム ディレクトリで、次のディレクトリから既存の UPM の JAR ファイルを削除します。
   plugins/installed-plugins

   JAR ファイルの名前の先頭には次のように数字が使われている場合があります。
   846688264762062110.atlassian-universal-plugin-manager-plugin-2.7.6.jar
3. 最新の UPM の JAR ファイルを同じディレクトリにコピーします。
4. Stash/Bitbucket Server を再起動します。

Bamboo

Bamboo でディスク上の UPM ファイルを更新するには、次の手順を実行します。

1. Bamboo をシャットダウンします。
2. Bamboo のホーム ディレクトリで、plugins/ ディレクトリから既存の UPM の JAR ファイルを削除します。
JAR ファイルの名前の先頭には次のように数字が使われている場合があります。
   846688264762062110.atlassian-universal-plugin-manager-plugin-2.7.6.jar
3. 最新の UPM の JAR ファイルを同じディレクトリにコピーします。
4. Bamboo を再起動します。