Bitbucket Server アップグレード ガイド
Bitbucket のインストールまたはアップグレード
このページの内容
このセクションの項目
関連コンテンツ
- 関連コンテンツがありません
このガイドでは、インストーラーを使用して、Bitbucket Server のインストールをWindowsまたはLinuxで最新バージョンにアップグレードする方法について説明します。
現在有効なソフトウェア メンテナンスがある場合、新しいバージョンへのアップグレードは無料で行えます。詳細については、「ライセンスの FAQ」を参照してください。
Bitbucket のその他のアップグレード方法:
- 手動 – アーカイブ ファイルを使用してアップグレードします。
- Data Center – Data Center クラスタをアップグレードします。
- ローリング アップグレード - ダウンタイムなしで、Data Center クラスタを次のバグ修正バージョンにアップグレードします。
- Bitbucket Server 用の Docker コンテナ イメージ。
はじめる前に
Bitbucket をアップグレードする前に、いくつかの質問に答える必要があります。
インストーラーの使用は適切なアップグレード方法ですか? |
詳細を読む...
You can choose to upgrade using the installer, or, if the installer is not suitable for your situation you can use an archive file to update your Bitbucket Server instance. Only use an archive file to update Bitbucket Server if the installer is not suitable for your situation, as the installer is the the recommended approach to upgrade for most use cases. Bitbucket Server をアーカイブ ファイルからアップグレードする方法について確認する。
|
アップグレードの資格がありますか? |
詳細を読む...
ご利用のライセンスでソフトウェア メンテナンスが有効かどうかを調べるには、 > [ライセンス] に移動して、ライセンスのサポート期間が失効していないことを確認します。 サポート期間が失効しいる場合、プロンプトに従ってライセンスを更新し、再適用してからアップグレードを行います。
|
サポート対象プラットフォームに変更はありますか? |
詳細を読む...
「サポート対象プラットフォーム」ページで、アップグレード先の Bitbucket バージョンを確認します。ここでは、サポート対象のオペレーティング システム、データベース、およびブラウザを確認できます。
|
Have you modified your server.xml file? |
詳細を読む...
Bitbucket 5 で、ポート番号、コンテキスト パス、アクセス プロトコルなどのプロパティの設定場所を変更して単一のディレクトリおよびファイルにまとめ、以降のリリースでのアップグレードを行いやすくしました。 Bitbucket 4.14 以前の任意のバージョンから Bitbucket 5.0 以降にアップグレードする場合、 See the page Migrate customizations from
|
アップグレードを計画する
1. アップグレード パスを決定する
アップグレードにおいて必須となるパスはないため、Bitbucket Server (または Stash) の過去の任意のバージョンから最新バージョンに更新できます。
Bitbucket 7 はメジャー アップグレードです
本番サイトをアップグレードする前に、Bitbucket Server 7.0 のリリース ノートを確認し、完全なバックアップを作成して、非本番環境でアップグレードのテストを行うようにしてください。
Bitbucket 7 よりも古いバージョンからアップグレードすると、ユーザーがインストールしたすべてのアプリが起動時に無効化されます
Be sure to update your own apps and check the Atlassian Marketplace to ensure 3rd-party apps are compatible with Bitbucket Server 7 before upgrading.
次のバグ修正アップデートへのアップグレード
複数ノードの Bitbucket クラスタを次のバグ修正アップデートにアップグレードする場合 (7.9.0 から 7.9.4 など)、ダウンタイムなしでアップグレードできます。
2. アップグレード前の確認を完了する
- アップグレード先として計画しているバージョン (およびその間のバージョン) のバージョンごとのアップグレード ノートを確認します。
- > [サポート ツール] に移動し、解決が必要な問題がログ アナライザーにあるかどうかを確認します。
利用しているアプリに、アップグレード先として計画しているバージョンとの互換性があるかどうかを確認します。
- > [アプリの管理] > [Bitbucket 更新の確認] に移動します。
アップグレード先として計画しているバージョンを選択して [確認] を押します。
互換性のないアプリがある場合If your users rely on particular apps, you may want to wait until they are compatible before upgrading Bitbucket. App vendors generally update their apps very soon after a major release.
参考情報
- Bitbucket Server 6 よりも古いバージョンからアップグレードすると、ユーザーがインストールしたすべてのアプリが自動的に無効になります。Bitbucket Server 6 との互換性の有無にかかわらず、アップグレードが正常に完了したらアプリを有効にする必要があります。
- You can disable an app temporarily if it is not yet compatible.
3. Bitbucket をテスト環境でアップグレードする
- 現在の本番環境のステージング コピーを作成します。
- 以下の手順に従って、テスト環境をアップグレードします。
- 本番環境のアップグレード前に、すべてのサポート対象外のアプリ、カスタマイズ、およびプロキシ構成 (可能な場合) をテストします。
Bitbucket のアップグレード
このアップグレード プロセスは、インプレースのアップグレードではなく、新しいインストール ディレクトリに新しいバージョンの Bitbucket Server をインストールします。新しいインスタンスは、既存の Bitbucket Server のホーム ディレクトリと外部データベースを使用します。
アップグレードのロールバックは、Bitbucket Server のホーム ディレクトリと Bitbucket Server データベースの両方のバックアップを復元することでのみ行なうことができ、ホーム ディレクトリとデータベースが一貫している必要があります。その後、アプリケーションの過去のバージョンをインストール ディレクトリに再インストールできます。詳細についてはロールバックのセクションをご参照ください。
4. Bitbucket Server をダウンロードする
ご利用のオペレーティング システムに対応するインストーラーをダウンロードします (推奨) - www.atlassian.com/software/bitbucket/download
5. データをバックアップする
使用するバックアップ戦略を決定します。
Bitbucket で使用できるさまざまなバックアップ戦略の概要...Bitbucket Server (バージョン 4.8 以降) のインスタンスの場合、Bitbucket の実行中にゼロ ダウンタイム バックアップ、バックアップ クライアント (バージョン 2.7 以降)、または DIY バックアップ (バージョン 2.12 以降) を使用できます。Bitbucket を停止し、ホーム ディレクトリとデータベースを zip 圧縮して安全な場所に保存しておくこともできます。
Bitbucket Data Center (バージョン 4.8 以降) のインスタンスの場合、ゼロ ダウンタイム バックアップまたは DIY バックアップを使用するか、すべてのノードの停止中に共有ホーム ディレクトリ (NFS 上) とデータベースのスナップショットを作成できます。
For Bitbucket mirrors, the home directory doesn't 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.詳細情報と、効果的なバックアップ戦略を作成するためのガイダンスについては、「データ リカバリとバックアップ」をご参照ください。
- Bitbucket ホーム ディレクトリと外部データベースのすべてのデータをバックアップします。
6. カスタマイズ設定を移行する
Bitbucket 5 以降では、サーバーのカスタム構成は異なる場所に保存されています。これまでは、Tomcat コンテナのカスタマイズ設定は server.xml
で行い、<Bitbucket home directory>
/shared
ディレクトリ (3.8 から 4.14)、または <Stash installation directory>/
conf
(3.7 以前) に保存していました。
Bitbucket 4.14 以前からアップグレードする場合に必要な手順
First, determine if you've made customizations to your
server.xml
file. You would have made these changes if you modified the port, context path, or the access protocol, or if you are running Bitbucket Server behind a proxy and modified the Connector element.Help me find my server.xml file...リリース ディレクトリ Stash 3.7 and earlier <Stash installation directory>/
conf/server.xml
Stash 3.8 and later <Stash home directory>
/shared/server.xml
Bitbucket Server 4.0 - 4.14 <Bitbucket home directory>
/shared/server.xml
Bitbucket Server 5.0 and later N/A, replaced by <Bitbucket home directory>
/shared/bitbucket.properties
If you made any customizations to the
server.xml
file, you must migrate those changes in thebitbucket.properties
file in your existing Bitbucket home directory. Thebitbucket.properites
file uses a slightly different syntax, so it is not merely a copy and paste procedure.
Read the page Migrate customizations fromserver.xml
tobitbucket.properties
and follow the instructions to migrate your customizations. Once your changes are migrated, proceed to the next step.
If you did not make any customizations to theserver.xml
file, proceed to the next step.For custom configurations in Bitbucket Data Center...Bitbucket Data Center instances on version 3.8 or later, the single
server.xml
file in the<Bitbucket home directory>
/shared
directory replaces all the copies ofserver.xml
located in the<Bitbucket installation directory>/conf
directories of the cluster nodes using previous versions of Bitbucket Server (or Stash).
7. アプリケーションを停止する
To stop Bitbucket Server from the interface, use the Bitbucket Server items in the Windows Start menu.
To stop Bitbucket Server from a command prompt, change directories to the <Bitbucket Server installation directory>
and run this command:
bin\stop-bitbucket.bat
To stop Bitbucket Server when running as a service, stop the Bitbucket Server service from the Windows services console.
To stop Bitbucket Server from a terminal, change to the <Bitbucket Server installation directory>
and run:
bin/stop-bitbucket.sh
Bitbucket Data Center のすべてのノードが停止されていることを確認し、1 つのノードでアップグレード ステップを実行します。その後、同じ手順をそれぞれのクラスタ ノードで繰り返します。
詳細な手順については「Bitbucket の開始と終了」ページをご確認ください。
8. インストーラーを実行する
インストーラーは、GUI、コンソール または無操作モードで実行できます。
インストーラーを実行します。
Windows で実行する場合....exe ファイルを実行します。Windows 管理者アカウントを使用することをおすすめします。
Linux で実行する場合...Bitbucket Server をダウンロードしたディレクトリに移動し、次のコマンドを実行してインストーラーを実行可能にします。
chmod +x atlassian-bitbucket-x.x.x-x64.bin
sudo
を使用してインストーラーを実行することをお勧めします。これにより Bitbucket Server を実行する専用アカウントが作成され、Bitbucket Server をサービスとして実行できます。インストーラーを実行するために
sudo
を使用するには、次のコマンドを実行します。$ sudo ./atlassian-bitbucket-x.x.x-x64.bin
root ユーザー権限でインストーラーを実行することもできます。
- プロンプトに従って Bitbucket Server をアップグレードします。
[Welcome] ステップで、アップグレードするインスタンスのタイプを選択します。
アップグレードするタイプの選択方法について単一ノードの場合 (ほとんどのユースケース)、[Upgrade an existing Bitbucket instance] オプションを選択します。
Bitbucket Data Center インスタンスの場合、[Upgrade an existing Bitbucket instance] オプションを選択し、それぞれのアプリケーション ノードでアップグレード プロセスを繰り返します。
Bitbucket ミラーの場合、[Upgrade an existing mirror] オプションを選択します。「Select Bitbucket Server Home」ステップで、既存のホーム ディレクトリを選択します。
インストーラー残りのステップに従います。
9. アプリケーションを開始する
オペレーティング システムのライブラリもアップグレードしていて、PostgresSQL と glibc のバージョンが2.28よりも前のものを使い、アップグレードによって glibc のバージョンが 2.28 以降に上がる場合、Bitbucket を起動する前に PostgresSQL のインデックスを再構築する必要があります。
インストーラーを使用している場合、インストール ウィザードの最後に、アプリケーションを開始してブラウザで開くオプションがあります。
Bitbucket を手動で開始する方法を含む詳細な手順については、「Bitbucket の開始と終了」をご確認ください。
ロールバック
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.
Version-specific update notes
このセクションでは、Bitbucket Data Center および Server のそれぞれのバージョン固有のアップデート ノートを案内します。ノートの記載内容は、上述の主要なアップグレード手順を補足するものです。アプリケーションの現在のバージョンとアップグレード先のバージョンとの間の各バージョンについて、関連するセクションをご確認ください。
Bitbucket Data Center および Server 7.11 アップデート ノート
You should also see:
- the general Upgrade steps section above.
- Bitbucket Data Center および Server 7.11 リリース ノート。
- the Bitbucket Server Supported platforms page.
- サポート終了についてのお知らせ
Bitbucket Data Center および Server 7.10 アップデート ノート
You should also see:
- the general Upgrade steps section above.
- Bitbucket Data Center および Server 7.10 リリース ノート。
- the Bitbucket Server Supported platforms page.
- サポート終了についてのお知らせ
Bitbucket Server 7.9 update notes
You should also see:
- the general Upgrade steps section above.
- Bitbucket Server および Data Center 7.9 リリース ノート。
- the Bitbucket Server Supported platforms page.
- サポート終了についてのお知らせ
Bitbucket Server 7.8 update notes
You should also see:
- the general Upgrade steps section above.
- Bitbucket Server および Data Center 7.8 リリース ノート。
- the Bitbucket Server Supported platforms page.
- サポート終了についてのお知らせ
Bitbucket Server 7.7 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 7.7 release notes.
- the Bitbucket Server Supported platforms page.
- サポート終了のお知らせ。
Bitbucket Server 7.6 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 7.6 release notes.
- the Bitbucket Server Supported platforms page.
- サポート終了のお知らせ。
Bitbucket Server 7.5 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 7.5 release notes.
- the Bitbucket Server Supported platforms page.
- サポート終了のお知らせ。
Bitbucket Server 7.4 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 7.4 release notes.
- the Bitbucket Server Supported platforms page.
- サポート終了のお知らせ。
New Data Center apps check as part of your license upgrade
Bitbucket Data Center ライセンス へのアップグレードに、アプリのチェック機能が新しく追加されました。インストール済みのアプリに Data Center 認定バージョンへのアップグレードが必要なものがあれば、新しい Bitbucket ライセンスの適用前にその旨を確認できます。
また、管理コンソールの [アプリの管理] セクションに新しいステータス メッセージを追加し、新しいライセンスが必要なアプリを明確に確認できるようにしました。
New status | Host product license | 意味 |
---|---|---|
DATA CENTER LICENSE AVAILABLE | Evaluation license | The app vendor offers a Data Center version of this app. If you switch to a paid Data Center product license, you’ll need to upgrade this app license to Data Center. |
LICENSE INCOMPATIBLE | Full license | The app vendor offers a Data Center version of this app. Your Server app license is no longer compatible with the product. This means the app has either stopped working, or functionality has been lost or compromised. You need to add a Data Center license. |
Data Center への移動後に Server アプリをアップグレードする方法の詳細をご確認ください。
Build status data migration
When upgrading to Bitbucket Server 7.4, you may notice an increased load on your database and application server. This is normal. It’s due to an asynchronous upgrade task that needs to run to migrate your application’s build status data.
While the upgrade task is running, your application will be available and able to serve requests, so your team can continue working as usual.
The upgrade task will run automatically around two minutes after your application starts up. In a multi-node cluster, it will run on a node picked by the system. How long it takes will depend on the size of the data that needs to be migrated. For example, for small instances it can take 10 minutes, and for large instances it can take over an hour.
Bitbucket Server 7.4 にアップグレードする前に、本番環境のセットアップをミラーリングしたステージング環境で HTTP ホスティングをテストする必要があります。これには特にインストール済みのアプリが含まれます。これは、アプリが提供するサーブレットが非同期の HTTP によって破損する可能性があるためです。
Bitbucket Server 7.3 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 7.3 release notes.
- the Bitbucket Server Supported platforms page.
- サポート終了のお知らせ。
Bitbucket Server 7.2 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 7.2 release notes.
- the Bitbucket Server Supported platforms page.
- サポート終了のお知らせ。
Bitbucket Server 7.1 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 7.1 release notes.
- the Bitbucket Server Supported platforms page.
- サポート終了のお知らせ。
Bitbucket Server 7.0 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 7.0 release notes.
- the Bitbucket Server Supported platforms page.
- サポート終了のお知らせ。
If you are considering upgrading to bitbucket 7.0 or higher and are using version 2.8 or earlier of the Bitbucket branch source
Jenkins plugin, there is a known issue that can cause builds to fail. This is because merges are performed lazily in order to manage scaling while changes to pull requests happen continuously.
See BSERV-12284 - Getting issue details... STATUS .
Bitbucket Server 6.10 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 6.10 release notes.
- the Bitbucket Server Supported platforms page.
- サポート終了のお知らせ。
Bitbucket Server 6.9 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 6.9 release notes.
- the Bitbucket Server Supported platforms page.
- サポート終了のお知らせ。
Bitbucket Server 6.8 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 6.8 release notes.
- the Bitbucket Server Supported platforms page.
- サポート終了のお知らせ。
Bitbucket Server 6.7 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 6.7 release notes.
- the Bitbucket Server Supported platforms page.
- サポート終了のお知らせ。
Bitbucket Server 6.6 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 6.6 release notes.
- the Bitbucket Server Supported platforms page.
- サポート終了のお知らせ。
Bitbucket Server 6.5 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 6.5 release notes.
- the Bitbucket Server Supported platforms page.
- サポート終了のお知らせ。
Bitbucket Server 6.4 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 6.4 release notes.
- the Bitbucket Server Supported platforms page.
- サポート終了のお知らせ。
Bitbucket Server 6.3 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 6.3 release notes.
- the Bitbucket Server Supported platforms page.
- サポート終了のお知らせ。
Bitbucket Server 6.2 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 6.2 release notes.
- the Bitbucket Server Supported platforms page.
- サポート終了のお知らせ。
Bitbucket Server 6.1 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 6.1 release notes.
- the Bitbucket Server Supported platforms page.
- サポート終了のお知らせ。
Bitbucket Server 6.0 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 6.0 release notes.
- the Bitbucket Server Supported platforms page.
- the End of support announcements for Bitbucket Server.
To upgrade to Bitbucket Server 5+, you must migrate customizations to bitbucket.properties
Be sure to carefully read the Bitbucket Server upgrade guide to determine what impact this change may have on your instance. The page Migrate server.xml
customizations to bitbucket.properties
has specifics on which properties need to be migrated, how to migrate them, and includes some examples that demonstrate how to migrate some common customizations.
Start script changes
Bitbucket Server 5.0 以前では、一部の開始スクリプトの名前がアンダースコアで開始されていました。これらのスクリプトは廃止されたため、直接呼び出すことはできません。これは、複数の開始および停止スクリプトがあり、使用する際に混乱が生じていたためです。現在は、start
で開始するスクリプトと、stop
で開始するスクリプトのみが提供されています。
既知の問題
Bitbucket Server 5.16 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 5.16 release notes.
- the Bitbucket Server Supported platforms page.
- the End of support announcements for Bitbucket Server.
Bitbucket Server 5.15 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 5.15 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- Bitbucket Server のサポート終了のお知らせ。
Bitbucket Server 5.14 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 5.14 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- Bitbucket Server のサポート終了のお知らせ。
Bitbucket Server 5.13 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 5.13 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- Bitbucket Server のサポート終了のお知らせ。
Bitbucket Server 5.12 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 5.12 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- Bitbucket Server のサポート終了のお知らせ。
Bitbucket Server 5.11 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 5.11 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- Bitbucket Server のサポート終了のお知らせ。
Bitbucket Server 5.10 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 5.10 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- Bitbucket Server のサポート終了のお知らせ。
Bitbucket Server 5.9 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 5.9 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- Bitbucket Server のサポート終了のお知らせ。
Bitbucket Server 5.8 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 5.8 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- Bitbucket Server のサポート終了のお知らせ。
Bitbucket Server 5.7 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 5.7 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- Bitbucket Server のサポート終了のお知らせ。
Bitbucket Server 5.6 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 5.6 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- Bitbucket Server のサポート終了のお知らせ。
Bitbucket Server 5.5 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 5.5 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- Bitbucket Server のサポート終了のお知らせ。
Bitbucket Server 5.4 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 5.4 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- Bitbucket Server のサポート終了のお知らせ。
Bitbucket Server 5.3 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 5.3 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- Bitbucket Server のサポート終了のお知らせ。
Bitbucket Server 5.2 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 5.2 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- Bitbucket Server のサポート終了のお知らせ。
Bitbucket Server 5.1 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 5.1 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- Bitbucket Server のサポート終了のお知らせ。
Bitbucket Server 5.0 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 5.0 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- Bitbucket Server のサポート終了のお知らせ。
To upgrade to Bitbucket Server 5+, you must migrate customizations to bitbucket.properties
Be sure to carefully read the Bitbucket Server upgrade guide to determine what impact this change may have on your instance. The page Migrate server.xml
customizations to bitbucket.properties
has specifics on which properties need to be migrated, how to migrate them, and includes some examples that demonstrate how to migrate some common customizations.
Start script changes
In Bitbucket Server 5.0, some startup scripts have had their name prefixed with an underscore. These scripts have been deprecated, and you should no longer call these scripts directly. This is to avoid confusion, because previously there were multiple start and stop scripts, making it easy to confuse which one to call. Now, there is only one script, that begins with "start
" and one that begins with "stop
".
BitbucketServer does not support reverse proxies using AJP connections
Starting from version 5.0, Bitbucket Server does not support reverse proxies using AJP connections. While never officially supported, previous versions of Bitbucket Server could use AJP connections. However, with changes to how Bitbucket Server uses Tomcat, using AJP connections with Bitbucket Server (or Data Center) 5.0+ will cause the application to fail on startup.
既知の問題
Bitbucket Server 4.14 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 4.14 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- Bitbucket Server のサポート終了のお知らせ。
既知の問題
Bitbucket Server 4.13 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 4.13 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- サポート終了のお知らせ。
既知の問題
Bitbucket Server 4.12 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 4.12 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- サポート終了のお知らせ。
Do NOT upgrade to 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
既知の問題
Bitbucket Server 4.11 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 4.11 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- サポート終了のお知らせ。
既知の問題
Bitbucket Server 4.10 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 4.10 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- サポート終了のお知らせ。
既知の問題
Bitbucket Server 4.9 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 4.9 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- サポート終了のお知らせ。
既知の問題
Bitbucket Server 4.8 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 4.8 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- サポート終了のお知らせ。
既知の問題
Bitbucket Server 4.7 update notes
You should also see:
- the general Upgrade steps section above.
- the Bitbucket Server 4.7 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- サポート終了のお知らせ。
既知の問題
Bitbucket Server 4.6 update notes
Also see:
- the general Upgrade steps section above.
- the Bitbucket Server 4.6 release notes.
- Stash のサポート対象プラットフォーム ページ。
- サポート終了のお知らせ。
既知の問題
Bitbucket Server 4.5 update notes
Also see:
- the general Upgrade steps section above.
- the Bitbucket Server 4.5 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- サポート終了のお知らせ。
既知の問題
Bitbucket Server 4.4 update notes
Also see:
- the general Upgrade steps section above.
- the Bitbucket Server 4.4 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- サポート終了のお知らせ。
既知の問題
Bitbucket Server 4.3 update notes
Also see:
- the general Upgrade steps section above.
- the Bitbucket Server 4.3 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- サポート終了のお知らせ。
既知の問題
Bitbucket Server 4.2 update notes
Also see:
- the general Upgrade steps section above.
- the Bitbucket Server 4.2 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- サポート終了のお知らせ。
既知の問題
Bitbucket Server 4.1 update notes
Also see:
- the general Upgrade steps section above.
- the Bitbucket Server 4.1 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- サポート終了のお知らせ。
既知の問題
Bitbucket Server 4.0 update notes
Also see:
- the general Upgrade steps section above.
- the Bitbucket Server 4.0 release notes.
- Bitbucket Server の「サポート対象プラットフォーム」ページ。
- サポート終了のお知らせ。Bitbucket Server 4.0 では、Internet Explorer 9 または 10、Java 7、バージョン 1.8 より前のサーバー版 Git がサポートされない点にご注意ください。
Do you rely on user-installed add-ons?
Your plugins may not be compatible with Bitbucket Server 4.0 (yet)
Upgrading from Stash to Bitbucket Server will disable all user-installed add-ons, whether they are 3rd-party add-ons from Atlassian Marketplace, or your own custom add-ons. User-installed add-ons will need to be checked, upgraded and enabled again once you've finished the upgrade process. You should check the marketplace listing for 3rd-party add-ons to determine if there is a release that is compatible with Bitbucket Server 4.0. Unless they have been updated to work with Bitbucket Server 4.0, existing add-ons (or plugins) that use the API interfaces that have been removed in Bitbucket Server 4.0 will not work. Similarly, custom add-ons need to be upgraded for Bitbucket Server compatibility. See the documentation on how to update your add-on for details.
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:
If no newer version is available the add-on will remain disabled.
New dedicated user account '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.
Updates to logger names
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 logger name | Bitbucket Server logger name |
---|---|
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 |
Important security improvement which may require configuration changes
Previous to Bitbucket Server 4.0, a security constraint for redirecting from HTTP to HTTPS was not enforced, meaning users could type "http://<bitbucketserver-url>" into their browser and still be shown a functioning version of Bitbucket Server (or Stash). Included with the release of Bitbucket Server 4.0 was a fix to enforce that security constraint. Using the previous security configuration with Bitbucket Server 4.0 means trying to access the application over an insecure connection, when users type "http" when trying to get to the application, they could encounter erroneous behavior.
As part of upgrading from Stash to Bitbucket Server, it is recommended you update your security configuration in order to avoid encountering this problem. See this Knowledge Base article for more information and specific instructions on addressing this: Redirect HTTP Requests to HTTPS.
既知の問題
Stash 3.11 update notes
Also see:
- the general Upgrade steps section above.
- the Stash 3.11 release notes.
- the Stash Supported platforms page. Note that Stash 3.11 does not support Git 2.0.2 or 2.0.3.
- サポート終了のお知らせ。Stash 4.0 では Internet Explorer 9 または 10、Java 7、バージョン 1.8 より前のサーバー版 Git がサポートされなくなる点に特にご注意ください。
- If you have installed the stash-stream-guard-plugin (for example, if advised to do so by Atlassian Support), then you should uninstall it when upgrading to 3.11.2 as its functionality is now bundled in Stash.
既知の問題
Stash 3.10 update notes
Also see:
- the general Upgrade steps section above.
- the Stash 3.10 release notes.
- the Stash Supported platforms page. Note that Stash 3.10 does not support Git 2.0.2 or 2.0.3.
- サポート終了のお知らせ。Stash 4.0 では Internet Explorer 9 または 10、Java 7、バージョン 1.8 より前のサーバー版 Git がサポートされなくなる点に特にご注意ください。
Are you using Git 2.2x - 2.4.0?
Git 2.2.x - 2.4.0 have reported performance issues when interacting with NFS. Hence, these versions are currently not supported for Stash Data Center or for Stash Server installations that use NFS mounts for the home directory.
既知の問題
Stash 3.9 update notes
Also see:
- the general Upgrade steps section above.
- the Stash 3.9 release notes.
- the Stash Supported platforms page. Note that Stash 3.9 does not support Git 2.0.2 or 2.0.3.
- サポート終了のお知らせ。Stash 4.0 では Internet Explorer 9、Java 7、バージョン 1.8 より前のサーバー版 Git がサポートされなくなる点に特にご注意ください。
Are you using JIRA as a Crowd server?
Stash 3.9 cannot use JIRA 6.4 as a Crowd server due to a bug in JIRA 6.4. Please upgrade to JIRA 6.4.1 before upgrading Stash. (Note that Stash 3.7.2 and 3.8.0 contained a workaround for the bug but the workaround was removed in Stash 3.9)
既知の問題
Stash 3.8 update notes
Also see:
- the general Upgrade steps section above.
- the Stash 3.8 release notes.
- the Stash Supported platforms page. Note that Stash 3.8 does not support Git 2.0.2 or 2.0.3.
- サポート終了のお知らせ。Stash 4.0 では Internet Explorer 9、Java 7、バージョン 1.8 より前のサーバー版 Git がサポートされなくなる点に特にご注意ください。
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
will not have to be redone for future upgrades.
You still need to update your custom configurations in shared/server.xml
for the upgrade to Stash 3.8.
Deprecation of HighlightJS for syntax highlighting
The highlighting engine was changed in Stash 3.5 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.
既知の問題
Stash 3.7 update notes
Also see:
- the general Upgrade steps section above.
- the Stash 3.7 release notes.
- the Stash Supported platforms page. Note that Stash 3.7 does not support Git 2.0.2 or 2.0.3.
- サポート終了のお知らせ。Stash 4.0 では Internet Explorer 9、Java 7、バージョン 1.8 より前のサーバー版 Git がサポートされなくなる点に特にご注意ください。
Do you use JIRA 6.4?
JIRA 6.4 has a known issue with Stash versions 3.4.3 to 3.7.1, which prevents the user synchronization from working. This will only affect you if you use JIRA to manage your users in Stash, and is fixed in Stash 3.7.2.
Deprecation of HighlightJS for syntax highlighting
The highlighting engine was changed in Stash 3.5 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.
既知の問題
Stash 3.6 update notes
Also see:
- the general update steps section above.
- the Stash 3.6 release notes.
- the Stash Supported platforms page. Note that Stash 3.6 does not support Git 2.0.2 or 2.0.3.
- サポート終了のお知らせ。Stash 4.0 では Internet Explorer 9、Java 7、バージョン 1.8 より前のサーバー版 Git がサポートされなくなる点に特にご注意ください。
Secure email notifications
Stash 3.6 now:
- Allows you to require STARTTLS support on the mail server when using SMTP – if it is not supported, mail is not sent.
- Supports SMTPS (where the whole protocol conversation uses 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.
Deprecation of HighlightJS for syntax highlighting
The highlighting engine was changed in Stash 3.5 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.
既知の問題
Stash 3.5 update notes
Also see:
- the general update steps section above.
- the Stash 3.5 release notes.
- the Stash Supported platforms page. Note that Stash 3.5 does not support Git 2.0.2 or 2.0.3.
- サポート終了のお知らせ。Stash 4.0 では Java 7、バージョン 1.8 より前のサーバー版 Git がサポートされなくなる点に特にご注意ください。
Stash home directory location
Stash 3.5 以降のバージョンでは、ホーム ディレクトリを Stash のインストール ディレクトリと同じ場所にしたり、Stash のインストール ディレクトリのサブディレクトリにしたりすることはできません。Stash のホーム ディレクトリは STASH_HOME
環境変数で定義され、別の場所に存在する必要があります。これに違反する場合、Stash は開始に失敗します。
Deprecation of HighlightJS for syntax highlighting
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.
既知の問題
Stash 3.4 update notes
Also see:
- the general update steps section above.
- the Stash 3.4 release notes.
- the Stash Supported platforms page. Note that Stash 3.4 does not support Git 2.0.2 or 2.0.3.
- サポート終了のお知らせ。
Changed group membership aggregation with multiple user directories
Stash 3.4 uses new schemes to determine the effective group memberships when Stash is connected to multiple user directories, and duplicate user names and group names are used across those directories. The new schemes are:
- 'aggregating membership'
- 'non-aggregating membership'.
These group membership schemes are only used to determine authorization. Authentication is determined on the basis of the group mappings in each directory.
See Effective memberships with multiple directories in the Crowd documentation for more information.
When you update to Stash 3.4, an update task will apply one of those schemes as follows:
Aggregating membership will be applied to your instance:
- If there is only one active directory.
- If there are multiple active directories but only a single directory applies group memberships to any particular user.
- For example, if directory-1 contains user-a in group-x, and directory-2 contains user-b in group-y, then Stash 3.4 will apply aggregating membership, and permissions will not be affected.
Non-aggregating membership will be applied to your instance:
- If there are multiple active directories and more than one directory applies group memberships to at least one user.
- For example, if directory-1 contains user-a in group-x, and directory-2 contains user-a in group-y, then Stash 3.4 will apply non-aggregating membership. If group-y has admin provileges then user-a would have their privileges escalated in this case if aggregating membership was applied instead when upgrading to Stash 3.4.
Any changes made by the update task will be logged.
A Stash admin can change the membership scheme used by Stash using the following commands:
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
To change to non-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":false}' -u <username>:<password> <base-url>/rest/crowd/latest/application
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.
既知の問題
Stash 3.3 update notes
Also see:
- the general update steps section above.
- the Stash 3.3 release notes.
- the Stash Supported platforms page. Note that Stash 3.3 does not support Git 2.0.2 or 2.0.3.
- サポート終了のお知らせ。
既知の問題
Stash 3.2 update notes
Upgrading to Stash 3.2 or later from Stash 3.1 or earlier is irreversible – please see the Home directory migration section below.
Also see:
- the general update steps section above.
- the Stash 3.2 release notes.
- the Stash Supported platforms page.
- サポート終了のお知らせ。
注意:
- Stash 3.2 does not support Git 2.0.2 or 2.0.3.
Home directory migration
When you update to Stash 3.2 or later, an update task migrates directories in your Stash home directory to new locations. This is irreversible – once you update to Stash 3.2 or later you can not revert to Stash 3.1 or earlier, because of changes to the Stash home directory format.
For most installations, Stash 3.2 is able to perform these moves automatically and transparently. However, in the rare instance where Stash 3.2 can't perform the update automatically, please refer to Upgrading your Stash home directory for Stash 3.2 manually.
Undocumented home directory overrides are no longer supported
Before Stash 3.2 it was possible to override the location of the following subfolders in the Stash home directory, using undocumented environment variables or system properties:
export
bin
caches
config
data
lib
lib/native
log
plugins
tmp
tmp
サブフォルダのみとなります。その他のオーバーライドを試みた場合、開始時に失敗します。詳細については、「Stash の開始に失敗 - UnsupportedDirectoryOverrideException」をご参照ください。 Stash analytics
Stash 3.2 以降は、ユーザーのイベント データを収集します (管理者によって無効化されている場合を除く)。これにより、amazonaws.com への出力ネットワークが発生します。「データ収集設定の変更」をご確認ください。
既知の問題
Stash 3.1 update notes
Also see:
- the general update steps section above.
- the Stash 3.1 release notes.
- the Stash Supported platforms page.
注意:
既知の問題
Stash 3.0 update notes
Stash no longer supports Java 6
Stash 3.0 requires at least Java 7, and supports Java 8.
「サポート終了のお知らせ」をご確認ください。
Your plugins may not be compatible with 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.
Also see:
- the general update steps section above.
- the Stash 3.0 release notes.
- the Stash Supported platforms page.
注意:
- Stash now has installers for the Linux, macOS and Windows platforms.
- Stash no longer supports Internet Explorer 8, as previoiusly announced.
- Stash では Apache HTTP Server の
mod_auth_basic
モジュールはサポートされません。 - Stash does not support Git 2.0.2 or 2.0.3.
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.
サードパーティ アドオンの開発者には、リリースに先立って Stash 3.0 のアーリー アクセス プログラム (EAP) ビルドが提供されており、ほとんどの開発者が互換性を保つようにアドオンをすでに更新しています。Stash の [アドオンの管理] ページにアドオンが表示されるようにするには、公開元が Stash 3.0 との互換性を明示的にマークしている必要があります。これは 2.10 や 2.11 などの過去のマイナー リリースのように自動的に行われるわけではありません。アトラシアンでは、Stash 3.0 との互換性を持たないサードパーティ アドオンに関連する問題をサポートすることはできません。このようなサポート ケースはアドオンのサードパーティの公開元で扱う必要があります。「アプリの管理」をご確認ください。
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 |
既知の問題
Stash 2.12 update notes
Also see:
- the update steps section above.
- サポート終了のお知らせ。特に、Java 6 のサポートは廃止予定である点にご注意ください。Stash 3.0+ では Java 7 が必要になります。
- the Stash 2.12 release notes.
注意:
- Stash does not yet support Java 8.
- Stash 2.12 does not support Git 1.8.4.3
- Stash では Apache HTTP Server の
mod_auth_basic
モジュールはサポートされません。
See Supported platforms.
既知の問題
Stash 2.11 update notes
Also see:
- the update steps section above.
- サポート終了のお知らせ。
- the Stash 2.11 release notes.
Note that Stash does not support Git 1.8.4.3, nor does Stash support Java 8 yet. See Supported platforms.
既知の問題
Stash 2.10 update notes
Also see:
- the update steps section above.
- サポート終了のお知らせ。
- the Stash 2.10 release notes.
Note that Stash does not support Git 1.8.4.3. See Supported platforms.
既知の問題
Stash 2.9 update notes
Also see:
- the update steps section above.
- サポート終了のお知らせ。
- the Stash 2.9 release notes.
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 Update Required
Version 1.0.3 of the Stash Backup Client is required to back up Stash 2.9.
既知の問題
Stash 2.8 update notes
Also see:
- the update steps section above.
- サポート終了のお知らせ。
- the Stash 2.8 release notes.
既知の問題
Stash 2.7 update notes
Also see:
- the update steps section above.
- サポート終了のお知らせ。
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.
既知の問題
Stash 2.6 update notes
Also see:
- the update steps section above.
- サポート終了のお知らせ。
既知の問題
Stash 2.5 update notes
Also see:
- the update steps section above.
- サポート終了のお知らせ。
既知の問題
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 update notes
Also see:
- the update steps section above.
- サポート終了のお知らせ。
既知の問題
Stash 2.3 update notes
Please also see the update steps section above.
When upgrading to Stash 2.3 you also need to update the SCM Cache plugin, due to recent Stash API changes.
既知の問題
Stash 2.2 update notes
Please see the update steps section above.
既知の問題
Stash 2.1 update notes
Please also see the update steps section above.
既知の問題
Install location for third-party libraries
Stash 2.1 以降では、MySQL JDBC ドライバなどのサードパーティ製のライブラリや jar ファイルを、<Stash home directory>/lib
にインストールできます。ここにあるファイルは、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 update notes
This section provides specific notes for upgrading to Stash 2.0. See also the update steps section above.
Tomcat
Stash 2.0 では、Tomcat がバージョン 6 から 7 に更新されました。この更新の一環として、 server.xml
ファイルが変更されました。server.xml
ファイルをカスタマイズしている場合 (例: port
、path
、または hostname
)、現在のバージョンを更新された Stash に単純にコピーすることはできません。カスタマイズ内容を新しいバージョンの Stash の server.xml
に再適用する必要があります。
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>
You can call this command without the service name if you installed the Stash service with a default name.
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
ブランチ権限をサポートするため、Stash 2.0 は <Stash home directory>/data/repositories/NNNN/hooks
(ここで NNN は内部のリポジトリ ID) の pre-receive
および post-receive
フォルダにある既存のフックを .../hooks/pre-receive.d/10_custom
または .../hooks/post-receive.d/10_custom
に移動します。これにより、相対パス名 (例: "./foo.sh" または "../dir/foo.sh") を使用するカスタム フックは Stash 2.0 への更新で壊れます。
Deprecation of 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.
既知の問題
既知の問題やトラブルシューティング情報を確認する
Stash インストールの更新で、上述のステップを実行したあとに問題が発生する場合、次のように Stash の既知の問題を確認し、更新内容のトラブルシューティングをお試しください。
- 既知の問題の確認。既知の問題は、アトラシアンの課題追跡システムの BSERV プロジェクトで確認できます。
- Bitbucket Server のナレッジベース。Stash の最新バージョンのリリース後に問題が確認される場合があります。このような場合、Bitbucket Server のナレッジベースで情報を公開しています。
- 更新中に問題が発生していて解決が難しい場合、サポート チケットを作成してください。アトラシアンのサポート エンジニアがお手伝いします。
このセクションの項目
関連コンテンツ
- 関連コンテンツがありません