Universal Plugin Manager の更新

Checking the UPM software version

If the Atlassian application instance is connected to the Internet, it automatically checks whether a more recent version of the UPM is available and presents a notice on the page if so.

You can see what version of the UPM software is currently running by checking the version number at the bottom of the plugins administration page.

Updating UPM software automatically

To update the UPM software to its latest version from the UPM interface:

1. As a system administrator, go to the plugins installation page. If you have UPM version 2.7 and later, this is the Manage Plugin page.
   If a software update for UPM is available, a banner similar to the following appears. 
   

   
   Note that the content of the UPM update banner varies slightly between different versions of the UPM. However, the banner should include a link for updating the UPM software.

2. Click the link for updating the UPM software in the banner. 
   UPM downloads and applies the new version of the UPM. You do not need to restart the application after the update. However, when updating from certain versions, you will need to refresh the browser page to see the changes. In this case, a message appears advising you to refresh your browser.

In UPM 2.7.4 and later, the banner offers links for three options:

• Update now: immediately downloads and applies the update to the UPM software.
• Skip this update: keeps the current version of the UPM software and suppresses future reminders about the availability of the current latest version. The reminder appears when subsequent versions become available.
• Remind me next time: closes the banner for now, but it will appear again the next time you go to the Manage Plugins page. 

Updating UPM by file upload

If not connected to the Internet or in certain troubleshooting scenarios, you may need to update the software by uploading the UPM JAR file to the Atlassian application. You need to follow these steps to update the Universal Plugin Manager for JIRA, Confluence, FishEye or Crucible from versions 1.5 and lower.

To update the UPM:

1. Download the latest version of the UPM plugin from the Atlassian Marketplace.
2. As an administrator in the Atlassian application, go to plugins administration page.
3. Navigate to the Install tab.
4. Click Upload Plugin.
5. Browse to the UPM plugin JAR that you downloaded and select it.

6. Press Upload to apply the update.
   A dialog appears indicating that the installation is being performed.

   Depending on the UPM version you are replacing, the installation process may appear to fail in various ways, such as appearing to hang, returning immediately, or by finishing and showing an error message. In most cases, the installation actually succeeds, but appears to fail due to issues with older UPM versions. If you think you have encountered this situation, wait a few minutes for the installation to finish and then refresh the browser. Check the footer at the bottom of the page to verify the UPM version.

7. プロンプトが表示されたら、ブラウザを更新するかアプリケーションを再起動します。

   If you are updating the UPM in Confluence 3.4.x, you need to restart Confluence a second time. (See bug report CONF-22323. Note that this bug affects Confluence versions 3.4.x only.)

UPM のバージョンが最新のものになりました。

Updating or reverting UPM by JAR file replace

If for any reason you cannot update UPM through the Atlassian application administration page, you can update UPM file by replacing the UPM file in the directory instead.

This procedure also applies if you need to revert UPM to an earlier version. This is the only way to revert UPM to an earlier version.

Before starting, get the version of the UPM plugin that you want to install from Atlassian Marketplace. Then follow the instructions appropriate to your application.

Jira

To update the UPM file on disk in JIRA:

1. Jira をシャットダウンします。
2. Remove the existing UPM JAR file from this directory in your JIRA home directory:
   plugins\installed-plugins
   The name of the JAR file may be prepended with a number, such as: 
   846688264762062110.atlassian-universal-plugin-manager-plugin-2.7.6.jar
3. 新しい UPM の JAR ファイルを同じディレクトリにコピーします。
4. Jira を再起動します。

Confluence

Confluence stores plugins, such as UPM, in its database. Rather than attempting to remove the plugin from the database, you can use the Confluence plugin servlet, which presents a secondary web interface for managing plugins.

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

1. Go to this URL on your Confluence site:

   http://<confluence_site>/admin/viewplugins.action

   The installed version of the Confluence Plugin Manager appears.

2. Click Browse and find the UPM plugin JAR and upload the JAR into Confluence.
3. Confluence を再起動します。

FishEye

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

1. Fisheye インスタンスをシャットダウンします。
2. Using an archive management tool, open the following archive in your FishEye installation directory:
plugins/bundled-plugins.zip

3. Delete (do not extract) the existing atlassian-universal-plugin-manager-plugin-x.x.x.jar from the zip file.
4. 新しいプラグイン バージョンをダウンロードしたフォルダから、新しい プラグイン バージョンを zip ファイルに追加します。
5. Close the zip file.
6. Delete the following file from you FishEye installation directory:
var/plugins/bundled/atlassian-universal-plugin-manager-plugin-x.x.x.jar file.
7. インスタンスを再起動します。

Stash

To update the UPM file on disk in Stash:

1. Shut down Stash.
2. Remove the existing UPM JAR file from this directory in the Stash home directory:
   plugins\installed-plugins
The name of the JAR file may be prepended with a number, such as:
   846688264762062110.atlassian-universal-plugin-manager-plugin-2.7.6.jar
3. 最新の UPM の JAR ファイルを同じディレクトリにコピーします。
4. Restart Stash.