Bitbucket Server アップグレード ガイド

お困りですか?

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

コミュニティに質問

This page describes how to update your Bitbucket Server installation to the latest version. We strongly recommend that you update Bitbucket Server by performing the steps below. Note that:

  • This update process does not perform an in-place upgrade, but installs the new version of Bitbucket Server into a fresh installation directory. The new instance uses your existing Bitbucket Server home directory and external database.
  • For production environments, we recommend that you test the Bitbucket Server update on a staging server before deploying to production.
  • You can update from any previous version of Stash to the latest version of Bitbucket Server. There is no required established upgrade path.
  • Upgrading from Stash to Bitbucket Server disables all user-installed add-ons. Be sure to update your own add-ons and check the Atlassian Marketplace to ensure 3rd-party add-ons are compatible with Bitbucket Server before upgrading. Read more about this change.
  • If necessary, rolling back an update can only be performed by restoring a backup of both the Bitbucket Server home directory and the Bitbucket Server database – rolling back requires a consistent home directory and database. You can then reinstall the previous version of the application to the installation directory. Read the Rollback section for more details.

1. Review the upgrade notes

There are specific upgrade notes further down this page for each version of Bitbucket Server. You should read the relevant sections for each version between your current version and the version you are upgrading to. Note that you can update from any previous version to the latest version of Bitbucket Server.

2. データのバックアップを作成する

Before proceeding any further you must take a backup of all your data in the Bitbucket home directory first. This is important as it will allow you to return to a known starting point if you encounter trouble for any reason during the upgrade process.

For Bitbucket Server (version 4.8 or later) instances, you can use Zero Downtime Backup, the Backup Client (version 2.7 or later ), or  DIY Backup (version 2.12 or later) while Bitbucket is running, or just stop Bitbucket and zip up / snapshot the home directory and database and keep them somewhere safe.

For Bitbucket Data Center (version 4.8 or later) instances, you can use Zero Downtime BackupDIY Backup, or take snapshots of the shared home directory (on NFS) and database while all nodes are stopped. 

For Bitbucket mirrors, the home directory doesn't really store any persistent state that can't be reconstructed from the primary Bitbucket instance, but you should still make sure you have a backup of at least the important configuration files such as SSL certificate, server.xml config/ssh-server-keys.pem bitbucket.properties file, and so on in a safe place. See  How do I back up my mirrors?  for more information.

See the article Data recovery and backups for more detailed information and guidance on creating an effective backup strategy.

3. アプリケーションを停止する

See Starting and stopping Bitbucket Server for detailed instructions. 

For Bitbucket Data Center, stop all nodes of Bitbucket Data Center, perform the steps to upgrade for a single node first, then repeat the process on each cluster node.

4. Install Bitbucket Server

This update process does not perform an in-place upgrade, but installs the new version of Bitbucket Server into a fresh installation directory. The new Bitbucket Server uses your existing home directory and external database. Check that you have all the system requirements for the new version of Bitbucket Server, including Perl, to avoid any trouble. See also the End of support announcements for Bitbucket Server. You can install Bitbucket Server by either:

For Bitbucket Data Center instances, repeat the update process for every cluster node. 

Use the Bitbucket Server installer to update your installation (Recommended)

You can run the installer in GUI, console or unattended modes. On Linux, you need to set the executable flag on the installer file before running it: 

chmod +x atlassian-bitbucket-x.x.x-x64.bin

To upgrade using the installer

  1. Download the Bitbucket Server installer
  2. Open and run the installer. 
  3. At the 'Welcome' step, choose the Upgrade an existing Bitbucket instance option.
    For a Bitbucket mirror, choose the Upgrade an existing mirror option.
  4. At the 'Select Bitbucket Server Home' step, browse to your existing home directory.
    (as defined by the BITBUCKET_HOME environment variable – see Bitbucket Server home directory):

    If upgrading from Stash 3.4 or earlier...

    Stash 3.5 and later versions no longer allow the  Bitbucket Server home directory  to be the same directory as, or a subdirectory of, the Stash installation directory. The Stash home directory, as defined by the  STASH_HOME  environment variable, must be in a separate location – otherwise Stash will fail on startup.  If upgrading from a previous version of Stash where the Stash home directory is owned by a local user, the ownership of all files will be updated to atlstash . Please allow sufficient time for the installer to complete this process (it could take up to 30 minutes).

  5. インストーラー残りのステップに従います。

Use an archive file to update your Bitbucket Server installation

Only use an archive file to update Bitbucket Server if the installer is not suitable for your situation. The installer is the the recommended approach to upgrade for most use cases.

Follow the instructions at Upgrade Bitbucket Server from an archive file. Note that on Windows, Bitbucket Server 3.5 and later versions will refuse to start if the installation path contains spaces when Bitbucket Server is installed from an archive file. The installer prevents you from creating such a path.

Change dedicated user account from 'atlstash' to 'atlbitbucket'

When upgrading from Stash 3.x or older to Bitbucket 4.x or later, the installer provides an option to remove the atlstash dedicated user account and replaces it with a user account named atlbitbucket. If you are installing Bitbucket Server using an archive file you must create the atlbitbucket user account for Bitbucket Server to work properly. Read more about creating this dedicated user account

5. Update server.xml (upgrading from Stash 3.7 or earlier)

If you are upgrading from Stash 3.8 or later you can skip to step 6, Start the application, below.  If you are upgrading from Stash 3.7 or earlier and you have made  custom changes  to the server.xml file in your installation, you have to make those changes in the server.xml file of your new installation as well, which is in a different location as of Stash 3.8.  You would have made these changes if you modified the portcontext path, or the access protocol, or if you are running Bitbucket Server behind a proxy and modified the Connector element. 

Locating the server.xml file

The location of the server.xml file changed in Stash 3.8 to keep editable configuration files in the Bitbucket home directory and out of the (version specific) installation directories. 

リリース ディレクトリ 
Stash 3.7 以前 <Stash installation directory>/ conf/server.xml
Stash 3.8 以降 <Stash home directory> /shared/server.xml
Bitbucket Server 4.0 以降 <Bitbucket home directory> /shared/server.xml

Applying your customizations

The default content of server.xml was not always identical in past versions of Bitbucket Server (or Stash). Rather than just copying server.xml from your existing <Bitbucket installation directory>/conf to <Bitbucket home directory>/shared of your latest Bitbucket Server instance, you should carefully review the differences between your customized version and the default version and re-apply just your custom changes to the new server.xml file. Once you have applied your custom changes in  <Bitbucket home directory>/shared/server.xml, you will not need to perform this step again in future upgrades. 

Custom configurations in Bitbucket Data Center

For Bitbucket Data Center, using Stash 3.8 or later, the single server.xml file in the <Bitbucket home directory> /shared directory replaces all the copies of server.xml located in the  <Bitbucket installation directory>/conf directories of the cluster nodes using previous versions of Bitbucket Server (or Stash).

6. アプリケーションを開始する

If you installed Bitbucket Server using the installer, there is an option to start the application. If you installed Bitbucket Server manually from an archive file then see Starting and stopping Bitbucket ServerFor Bitbucket Data Center instances, repeat the process on every cluster node. Either way, note that the database schema migration task that runs when Bitbucket Server is started after an update can take a while, especially if the update skipped a few releases (for example, upgrading from 2.2 to 2.7). Bitbucket Server should never be interrupted while this is happening, even if it appears to hang for a bit – allow the server to either come up, or fail to come up (when it will provide an explanation of what went wrong).

ロールバック

If necessary, rolling back an update can only be performed by restoring a backup of both the Bitbucket Server home directory and the Bitbucket Server database – rolling back requires a consistent home directory and database. You can then reinstall the previous version of the application to the installation directory. Never start an older binary against an upgraded home directory.


バージョンごとのアップデート ノート

This section provides specific update notes for each version of Bitbucket Server (previously known as Stash). These notes supplement the primary upgrade instructions above. You should read the relevant sections for each version between your current version of the application and the version you are upgrading to.

Bitbucket Server 4.14 アップデート ノート

次のページもご確認ください。

既知の問題

P キー 概要 Status
Loading...
Refresh

Bitbucket Server 4.13 アップデート ノート

次のページもご確認ください。

既知の問題

P キー 概要 Status
Loading...
Refresh

Bitbucket Server 4.12 アップデート ノート

次のページもご確認ください。

 

Git 2.11 以降へのアップグレード禁止

Any version after Git 2.11.0 (including future 2.12+ releases) cannot be used with Bitbucket Server. Bitbucket Server 4.12 will fail on startup if Git 2.11+ is detected. Only upgrade to versions of Git which are explicitly marked supported on our Supported Platforms page.

BSERV-9388 - Getting issue details... STATUS

 

既知の問題

P キー 概要 Status
Loading...
Refresh

Bitbucket Server 4.11 アップデート ノート

次のページもご確認ください。

既知の問題

P キー 概要 Status
Loading...
Refresh

Bitbucket Server 4.10 アップデート ノート

次のページもご確認ください。

既知の問題

P キー 概要 Status
Loading...
Refresh

Bitbucket Server 4.9 アップデート ノート

次のページもご確認ください。

既知の問題

P キー 概要 Status
Loading...
Refresh

Bitbucket Server 4.8 アップデート ノート

次のページもご確認ください。

既知の問題

P キー 概要 Status
Loading...
Refresh

Bitbucket Server 4.7 アップデート ノート

次のページもご確認ください。

既知の問題

P キー 概要 Status
Loading...
Refresh

Bitbucket Server 4.6 アップデート ノート

Please also see:

既知の問題

P キー 概要 Status
Loading...
Refresh

Bitbucket Server 4.5 アップデート ノート

Please also see:

既知の問題

P キー 概要 Status
Loading...
Refresh

Bitbucket Server 4.4 アップデート ノート

Please also see:

既知の問題

P キー 概要 Status
Loading...
Refresh

Bitbucket Server 4.3 アップデート ノート

Please also see:

既知の問題

P キー 概要 Status
Loading...
Refresh

Bitbucket Server 4.2 アップデート ノート

Please also see:

既知の問題

P キー 概要 Status
Loading...
Refresh

Bitbucket Server 4.1 アップデート ノート

Please also see:

既知の問題

P キー 概要 Status
Loading...
Refresh

Bitbucket Server 4.0 アップデート ノート

Please also see:

ユーザーがインストールしたアドオンを使用している場合

ご利用のプラグインに Bitbucket Server 4.0 との互換性がない可能性があります

Stash から Bitbucket Server へのアップグレードでは、ユーザーがインストールしたすべてのアドオンが無効化されます。これは、アドオンが Atlassian Marketplace から取得したサードパーティ製のものであるか、自身のカスタム アドオンであるかを問いません。アップグレード プロセスが完了した後に、ユーザーがインストールしたアドオンを確認し、アップグレードおよび再有効化する必要があります。Marketplace のサードパーティ製のアドオンについては、Marketplace の一覧で、Bitbucket Server 4.0 との互換性があるリリースがあるかどうかを確認する必要があります。Bitbucket Server 4.0 との互換性があるリリースがない場合、Bitbucket Server 4.0 で削除された API インターフェイスを使用する既存のアドオン (またはプラグイン) は動作しません。同様に、カスタム アドオンも Bitbucket Server での互換性のためにアップグレードする必要があります。詳細は、「アドオンの更新方法」に関するドキュメントを参照してください。

If you are upgrading from Stash 3.x to Bitbucket Server 4.x, you should be aware that most user-installed add-ons will be incompatible with Bitbucket Server 4.0. After upgrading, go to Admin > Manage add-ons, look for messages of this form, and follow the advice to update:

利用可能な新しいバージョンがない場合、アドオンは無効化されたままになります。 

新しい専用ユーザー アカウント "atlbitbucket"

A new dedicated user account will be created to run Bitbucket Server, called atlbitbucket. During the upgrade process, you will have an option to delete the dedicated user account for running Stash, named atlstash. For most users, deleting this dedicated user account won't have any negative consequences, however if you rely on this dedicated user accounts, for example in custom backup scripts, you will need to update the user account in those scripts.

ロガーの名前の更新

If you have customized your logging configuration by manually editing the logback.xml file (using steps found in the Configure Stash Logging KB article), you should be aware of changes to several logger names that may require you to update some of your configuration files.

ロガー名の変更を確認...
Stash のロガー名 Bitbucket Server のロガー名 
stash.application
bitbucket.application
stash.profiler bitbucket.profiler
stash.access-log bitbucket.access-log
stash.audit-log bitbucket.audit-log
stash.mail-log bitbucket.mail-log

セキュリティ上の重大な改善事項 (設定の変更が必要な場合があります)

Bitbucket Server 4.0 まででは、HTTP から HTTPS へのリダイレクトのセキュリティ制約は強制されていなかったため、ユーザーがブラウザで「http://<bitbucketserver-url>」と入力すると、Bitbucket Server (または Stash) の有効なバージョンを利用することができました。Bitbucket Server 4.0 リリースには、このセキュリティ制約を強制するための修正が含まれています。Bitbucket Server 4.0 で従来のセキュリティ設定を使用する場合、セキュアではない接続でアプリケーションにアクセスしようとした際に、ユーザーが「http」と入力してアプリケーションを指定すると、エラーのような挙動が発生する可能性があります。 

Stash から Bitbucket Server へのアップグレードの一環として、セキュリティ設定を更新してこの問題を回避するようにすることをおすすめします。詳細情報や、この問題に対応するための具体的な手順については、ナレッジベース記事「HTTP リクエストを HTTPS にリダイレクトする」をご参照ください。

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 3.11 アップデート ノート

Please also see:

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 3.10 アップデート ノート

Please also see:

Git 2.2x - 2.4.0 を使用していますか?

Git 2.2.x - 2.4.0 では、NFS とのやり取りでパフォーマンスの問題が発生することが確認されています。このため、これらのバージョンは、ホーム ディレクトリに NFS マウントを使用する Stash Data Center または Stash Server のインストールでは現在サポートされていません。

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 3.9 アップデート ノート

Please also see:

Jira を Crowd サーバーとして使用していますか?

Jira 6.4 のバグのため、Stash 3.9 では Jira 6.4 を Crowd サーバーとして使用することはできません。Stash へのアップグレードを行う前に、Jira 6.4.1 にアップグレードしてください (Stash 3.7.2 と 3.8.0 にはこのバグに関連する回避策が含まれていましたが、これは Stash 3.9 で削除されています)。

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 3.8 アップデート ノート

Please also see:

Have you made customizations to Tomcat's server.xml file?

For Stash 3.8 (and future versions) the server.xml file is now located in the <stash home directory>/shared directory. The benefit of this move is that your customizations to server.xml (such as those described in step 5) will not have to be redone for future upgrades.

(warning) You do still need to update your custom configurations in shared/server.xml  for the upgrade to Stash 3.8, as described in step 5.

シンタックス ハイライトでの HighlightJS の廃止

Stash 3.5 では、ハイライト エンジンを HighlightJS から CodeMirror に変更しました。Stash での HighlightJS によるシンタックス ハイライトは非推奨となり、Stash 4.0 で廃止される予定です。HighlightJS で行っていたカスタム マッピングを移行する方法については、「シンタックス ハイライトへの変更」をご参照ください。

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 3.7 アップデート ノート

Please also see:

Jira 6.4 を使用していますか?

Jira 6.4 には Stash のバージョン 3.4.3 〜 3.7.1 に関連する既知の不具合があり、ユーザーの同期が動作しません。これは Stash のユーザー管理に Jira を使用している場合にのみ影響し、Stash 3.7.2 で修正済みです。

シンタックス ハイライトでの HighlightJS の廃止

Stash 3.5 では、ハイライト エンジンを HighlightJS から CodeMirror に変更しました。Stash での HighlightJS によるシンタックス ハイライトは非推奨となり、Stash 4.0 で廃止される予定です。HighlightJS で行っていたカスタム マッピングを移行する方法については、「シンタックス ハイライトへの変更」をご参照ください。

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 3.6 アップデート ノート

Please also see:

安全なメール通知

Stash 3.6 には次のような更新があります。

  • SMTP を使用している場合、メール サーバー側での STARTTLS サポートを要求できます。サポートされない場合、メールは送信されません。 
  • SMTPS のサポート (プロトコルのやり取り全体で SSL / TLS を使用)。

See Setting up your mail server for more information.

Note that if you use either SMTP with STARTTLS or SMTPS and connect to a self-signed mail server you may need to import the server's certificate and set up a custom cacerts file for Stash (just as you do for any outbound SSL/TLS connection to a self-signed server). See this  Stash knowledge base article for information about how to do that.

シンタックス ハイライトでの HighlightJS の廃止

Stash 3.5 では、ハイライト エンジンを HighlightJS から CodeMirror に変更しました。Stash での HighlightJS によるシンタックス ハイライトは非推奨となり、Stash 4.0 で廃止される予定です。HighlightJS で行っていたカスタム マッピングを移行する方法については、「シンタックス ハイライトへの変更」をご参照ください。

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 3.5 アップデート ノート

Please also see:

Stash のホーム ディレクトリの場所

Stash 3.5 and later versions no longer allow the Bitbucket Server home directory to be the same directory as, or a subdirectory of, the Stash installation directory. The Stash home directory, as defined by the STASH_HOME environment variable, must be in a separate location – Stash will fail on startup otherwise.

シンタックス ハイライトでの HighlightJS の廃止

The highlighting engine in Stash has been changed from HighlightJS to CodeMirror. The use of HighlightJS for syntax highlighting in Stash is now deprecated, and will be removed in Stash 4.0. See Syntax highlight changes for information about how to migrate any custom mappings for HighlightJS that you may have made.

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 3.4 アップデート ノート

Please also see:

複数のユーザー ディレクトリでのグループ メンバーシップ アグリゲーションの変更

Stash 3.4 では、Stash が複数のユーザー ディレクトリに接続されていて、それらのディレクトリ間でユーザー名やグループ名が重複している場合に、新しいスキームを使用して有効なグループ メンバーシップを判定します。新しいスキームは次のとおりです。 

  • 'aggregating membership'
  • 'non-aggregating membership'.

これらのグループ メンバーシップ スキームは、認証の判定にのみ使用されます。認証は、各ディレクトリでのグループ マッピングに基づいて判断されます。

See Effective memberships with multiple directories in the Crowd documentation for more information.

Stash 3.4 に更新すると、更新タスクによっていずれかスキームを次のように適用されます。

Aggregating membership will be applied to your instance:

    • アクティブなディレクトリが 1 つだけ存在する場合。
    • アクティブなディレクトリが複数あるが、任意のユーザーに対しては 1 つのディレクトリのみが適用される場合。
    • 例として、directory-1 に group-x の user-a が含まれ、directory-2 に group-y の user-b が含まれる場合、Stash 3.4 は aggregating membership を適用し、権限への影響はありません。

Non-aggregating membership がインスタンスに適用される条件:

    • 複数のアクティブなディレクトリがあり、2 つ以上のディレクトリが少なくとも 1 ユーザーにグループ メンバーシップを適用している場合。
    • 例として、directory-1 に group-x の user-a が含まれ、directory-2 に group-y の user-a が含まれる場合、Stash 3.4 は non-aggregating membership を適用します。group-y に管理権限が割り当てられていて、Stash 3. 4へのアップグレード時に aggregating membership が適用されていた場合、user-a では権限の昇格が行われます。

更新タスクによって行われたすべての変更が記録されます。

Stash 管理者は次のコマンドを使用して、Stash が使用するメンバーシップ スキームを変更できます。

  • To change to aggregating membership, substitute your own values for <username><password> and <base-url> in this command:

    curl -H 'Content-type: application/json' -X PUT -d '{"membershipAggregationEnabled":true}' -u <username>:<password> <base-url>/rest/crowd/latest/application 
  • aggregating membership に変更するには、次のコマンドで <username><password>、および <base-url> を自身の値で置き換えます。

    curl -H 'Content-type: application/json' -X PUT -d '{"membershipAggregationEnabled":false}' -u <username>:<password> <base-url>/rest/crowd/latest/application 

 

Please note that changing the aggregation scheme can affect the authorization permissions for your Stash users, and how update operations are performed. Read more about using Stash with multiple use directories.

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 3.3 アップデート ノート

Please also see:

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 3.2 アップデート ノート

Stash 3.1 以前から Stash 3.2 へのアップグレードは、不可逆的な操作です。以降のホーム ディレクトリの移行セクションをご参照ください。

Please also see:

注意:

ホーム ディレクトリの以降

Stash 3.2 以降に更新すると、更新タスクによって Stash のホーム ディレクトリのディレクトリが新しい場所に移行されます。これは不可逆的な操作です。Stash のホーム ディレクトリの形式が変更されるため、Stash 3.2 以降に更新したあとは、Stash 3.1 以前に戻すことはできません。

ほとんどのインストールにおいて、Stash 3.2 はこれらの移行を自動かつ透過的に実行できます。稀に、Stash 3.2 が自動更新を実行できないインスタンスがあります。その場合、「Stash のホーム ディレクトリを手動で Stash 3.2 にアップグレードする」を参照してください。

ドキュメントに未記載のディレクトリのオーバーライドのサポートを廃止

Stash 3.2 まででは、Stash のホーム ディレクトリの次のサブフォルダの場所を、ドキュメントに未記載の変数やシステム プロパティでオーバーライドすることができました。

  • export
  • bin
  • caches
  • config
  • data
  • lib
  • lib/native
  • log
  • plugins
  • tmp

In Stash 3.2 only the  tmp  subfolder can be overridden in this way. Attempting to override the others will fail on startup. For more information, please see  Stash fails to start - UnsupportedDirectoryOverrideException

Stash の統計情報

Stash 3.2 以降は、ユーザーのイベント データを収集します (管理者によって無効化されている場合を除く)。これにより、amazonaws.com への出力ネットワークが発生します。詳細については、「Bitbucket Server の統計情報の収集」をご参照ください。

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 3.1 アップデート ノート

Please also see:

注意:

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 3.0 アップデート ノート

Stash での Java 6 のサポートの廃止

Stash 3.0 では Java 7 以降が必要で、Java 8 がサポートされます。

Bitbucket Server のサポート終了のお知らせをご参照ください。

ご利用のプラグインに Stash 3.0 との互換性がない可能性があります

The interfaces in the Stash API for plugin developers that were deprecated in Stash 2.11 and earlier have been removed in Stash 3.0. This means that, unless they have been updated to work with Stash 3.0, existing Stash add-ons (or plugins) that use these interfaces will not work with Stash 3.0.

Please see the section below about Stash add-on incompatibilities for more details.

Please also see:

注意:

Stash add-on incompatibilities

Unless they have been updated to work with Stash 3.0, existing Stash add-ons (or plugins) that use the API interfaces that have been removed in Stash 3.0 will not work.

Fresh installs of Stash 3.0 shouldn't encounter any problems. The Stash 'Manage add-ons' page (in the admin area) should only display add-ons from the Marketplace that have been marked as compatible with Stash 3.0. Incompatible add-ons won't be available in the list. 

However, if you are upgrading from Stash 2.x to Stash 3.0, you should be aware that some existing installed add-ons may be incompatible with Stash 3.0. After upgrading, you should go to Admin > Manage add-ons, look for messages of this form, and follow the advice to update:

If no newer version is available, the add-on must be disabled. 

Custom add-ons

Please note that your custom locally-developed plugins may be affected by the API removals in Stash 3.0. You will need to update your custom plugins if you want those to work with Stash 3.0. See the Stash API changelog for details of the deprecated APIs.

他社製アドオン

You'll need to check on Atlassian Marketplace for the compatibility status of any 3rd-party add-ons that you use.

Third-party add-on developers have been given an Early Access Program (EAP) build of Stash 3.0 in advance of release, and many have already updated their add-ons to be compatible. Add-ons must be explicitly marked by the publisher as compatible with Stash 3.0 for them to appear in 'Manage add-ons' page in Stash. This is NOT automatic as was the case with previous minor releases such as 2.10 and 2.11. Atlassian can not support issues involving third party Add-ons that are incompatible with Stash 3.0; such support cases must be directed to the third-party publisher of the add-on. See Managing add-ons.

Atlassian add-ons

All of the Atlassian add-ons for Stash that are available from the Atlassian Marketplace have been updated to be compatible with Stash 3.0. If you use any of these in your Stash installation you'll need to update them to the Stash 3.0 compatible version.

Add-on JAR file name Stash 3.0 compatible version
Custom Navigation Plugin custom-navigation-plugin 2.0.3

Stash Archive Plugin

stash-archive 1.3.0
Repository git operations plugin stash-git-ops-plugin 1.2.1
Stash Auto Unapprove Plugin stash-auto-unapprove-plugin

1.1

Stash Protect Unmerged Branch Hook stash-protect-unmerged-branch-hook 1.1
Stash Reviewer Suggester stash-suggest-reviewers 1.2
Stash Web Post Hooks Plugin stash-web-post-receive-hooks-plugin 1.1.0
Realtime Editor for Stash stash-editor-plugin 1.0.6

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 2.12 アップデート ノート

Please also see:

注意:

  • 現時点では、Stash は Java 8 に対応していません。
  • Stash 2.12 does not support Git 1.8.4.3
  • Stash does not support the Apache HTTP Server mod_auth_basic module. 

See Supported platforms.

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 2.11 アップデート ノート

Please also see:

Note that Stash does not support Git 1.8.4.3, nor does Stash support Java 8 yet. See Supported platforms.

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 2.10 アップデート ノート

Please also see:

Note that Stash does not support Git 1.8.4.3. See Supported platforms.

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 2.9 アップデート ノート

Please also see:

Note that Stash does not support Git 1.8.4.3. See Supported platforms.

Pull Request Ref Optimization

When you first start Stash after upgrading to Stash 2.9 a repository update task runs that optimizes the pull request refs for all repositories managed by Stash. It's important that you do not interrupt this update process. You can track the progress of this in the Stash logs. See  STASH-3469 - Getting issue details... STATUS .

Backup Client の更新が必要

Version 1.0.3 of the Stash Backup Client is required to back up Stash 2.9.

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 2.8 アップデート ノート

Please also see:

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 2.7 アップデート ノート

Please also see:

Repository System Information Plugin is now deprecated

The functionality of the repository system information plugin has now been moved into core Stash. The plugin will still work for Stash 2.x versions but is redundant as of Stash 2.7.

MySQL default isolation level

Stash 2.7.x uses READ_COMMITTED instead of the MySQL default isolation level (REPEATABLE_READ). This can result in exceptions when installing or upgrading to 2.7.x, if binary logging is enabled in your MySQL server. More details and a fix can be found in this KB article.

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 2.6 アップデート ノート

Please also see:

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 2.5 アップデート ノート

Please also see:

既知の問題

P キー 概要 Status
Loading...
Refresh

Limited support for JIRA 4.4.x and earlier

JIRA 4.3+ allows for showing commits associated with issues in JIRA. However, viewing issues within Stash is not supported for JIRA 4.4.x and earlier.

Stash 2.4 アップデート ノート

Please also see:

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 2.3 アップデート ノート

Please also see the update steps section above.

Stash 2.3 にアップグレードする場合、最新の Stash API の変更に対応するため、SCM Cache プラグインも更新する必要があります。

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 2.2 アップデート ノート

Please see the update steps section above.

既知の問題

P キー 概要 Status
Loading...
Refresh

Stash 2.1 アップデート ノート

Please also see the update steps section above.

既知の問題

P キー 概要 Status
Loading...
Refresh

Install location for third-party libraries

As of Stash 2.1 you can install third-party libraries and jar files, such as the MySQL JDBC driver, into <Stash home directory>/lib. This has the advantage that files in this location are not overwritten, and lost, when you update Stash.

Microsoft SQL Server JDBC driver

Stash 2.1 now uses the Microsoft SQL Server JDBC driver to access Microsoft SQL Server, instead of using the jTDS driver. In most cases, Stash will automatically swap to using the Microsoft driver on update and no configuration is required.

If Stash was configured to use Microsoft SQL Server by manually entering a JDBC URL, please refer to this guide.

Stash 2.0 アップデート ノート

This section provides specific notes for upgrading to Stash 2.0. See also the update steps section above.

Tomcat

For Stash 2.0, Tomcat has been updated from version 6 to 7. As part of that update, the server.xml file has changed. If you have customized server.xml (for example, for port, path or hostname), you can not simply copy your own version across to the updated Stash; you must reapply your customizations to the server.xml file for the new version of Stash.

If you were running Stash as a Windows service and are upgrading from 1.x to 2.x you will need to reinstall the Stash service to make it use Tomcat 7.

To uninstall the Stash service you need to execute following commands from <STASH DISTRIBUTION DIR>\bin:

> net stop <service name>
> service.bat uninstall <service name>

Stash サービスを既定の名前でインストールした場合、このコマンドはサービス名なしで呼び出すことができます。

After the service is uninstalled you can proceed with the update steps and Running Bitbucket Server as a Windows service instructions to configure Stash 2.x running as a service.

Perl

Stash 2.0 requires Perl for its branch permission functionality. If Perl is unavailable, Stash 2.0 will not start.

On Windows machines, Perl will only have been installed by the Git installer if the correct install option was chosen. See Installing and upgrading Git.

Existing Git hooks

In order to support Branch Permissions, Stash 2.0 moves existing hooks in the pre-receive and post-receive folders under  <Stash home directory>/data/repositories/NNNN/hooks (where NNN is the internal repository id)  to .../hooks/pre-receive.d/10_custom or .../hooks/post-receive.d/10_custom. Consequently, custom hooks that use relative path names (e.g. "./foo.sh" or "../dir/foo.sh") will be broken by the update to Stash 2.0.

Internet Explorer 8 の廃止

Support for Internet Explorer 8 is deprecated from the release of Stash 2.0. The official end-of-support date is yet to be determined. See Supported platforms for details.

既知の問題

P キー 概要 Status
Loading...
Refresh

Checking for known issues and troubleshooting

Stash インストールの更新で、上述のステップを実行したあとに問題が発生する場合、次のように Stash の既知の問題を確認し、更新内容のトラブルシューティングをお試しください。

  • Check for known issues. Known issues can be seen in the STASH project on our issue tracker.
  • Stash Knowledge Base. Sometimes we find out about a problem with the latest version of Stash after we have released the software. In such cases we publish information in the Stash Knowledge Base.
  • 更新中に問題が発生していて解決が難しい場合、サポート チケットを作成してください。アトラシアンのサポート エンジニアがお手伝いします。
最終更新日 2017 年 5 月 1 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.