Bitbucket Server upgrade guide
This guide describes how to upgrade your Bitbucket Server installation on Linux to the latest version using the installer.
現在有効なソフトウェア メンテナンスがある場合、新しいバージョンへのアップグレードは無料で行えます。詳細については、「ライセンスの FAQ」を参照してください。
Other ways to upgrade Bitbucket:
- Manually – upgrade using an archive file.
- Data Center – Data Center クラスタをアップグレードします。
- ローリング アップグレード - ダウンタイムなしで、Data Center クラスタを次のバグ修正バージョンにアップグレードします。
- Docker container image for Bitbucket Server.
はじめる前に
Before you upgrade Bitbucket there are a few questions you need to answer.
Is using the installer the right upgrade method for you? | |
アップグレードの資格がありますか? | |
Have our support platforms changed? | |
Have you taken into consideration all the version-specific upgrade information? | Make sure you read the following pages for each version between your current version of the application and the version you're upgrading to: This will give you information about specific update notes for each version of Bitbucket Data Center and Server. |
Are you upgrading from Bitbucket 4.x or earlier and have you modified your server.xml file? |
アップグレードを計画する
1. アップグレード パスを決定する
You can update from any previous version of Bitbucket Server (or Stash) to the latest version, as there is no required upgrade path.
Bitbucket 8 is a major upgrade
Be sure to read the Bitbucket Server 8.0 release notes, take a full backup, and test your upgrade in a non-production environment before upgrading your production site.
Bitbucket 8 よりも古いバージョンからアップグレードすると、ユーザーがインストールしたすべてのアプリが起動時に無効化されます
Be sure to update your own apps and check the Atlassian Marketplace to ensure 3rd-party apps are compatible with Bitbucket Server 8 before upgrading.
次のバグ修正アップデートへのアップグレード
複数ノードの Bitbucket クラスタを次のバグ修正アップデートにアップグレードする場合 (8.0.0 から 8.0.1 など)、ダウンタイムなしでアップグレードできます。
2. Complete pre-upgrade checks
- アップグレード先として計画しているバージョン (およびその間のバージョン) のバージョンごとのアップグレード ノートを確認します。
- > [サポート ツール] に移動し、解決が必要な問題がログ アナライザーにあるかどうかを確認します。
Check the compatibility of your apps with the version you plan to upgrade to.
- > [アプリの管理] > [Bitbucket 更新の確認] に移動します。
アップグレード先として計画しているバージョンを選択して [確認] を押します。
3. Upgrade Bitbucket in a test environment
- Create a staging copy of your current production environment.
- 以下の手順に従って、テスト環境をアップグレードします。
- Test any unsupported apps, customizations and proxy configuration (if possible) before upgrading your production environment.
Upgrade Bitbucket
This upgrade process does not perform an in-place upgrade, but instead installs the new version of Bitbucket Server into a new installation directory. The new instance uses your existing Bitbucket Server home directory and external database.
If necessary, rolling back an upgrade 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.
4. Download Bitbucket Server
Download the installer (the recommended approach) for your operating system - www.atlassian.com/software/bitbucket/download.
5. データをバックアップする
Determine which backup strategy to use.
- Back up all the data in your Bitbucket home directory and external database.
6. Migrate customizations
If upgrading from Bitbucket 4.x or earlier, see migrate customizations.
7. Stop the application
To stop Bitbucket Server from your Linux terminal, change to the <Bitbucket Server installation directory>
and run:
bin/stop-bitbucket.sh
詳細な手順については「Bitbucket の開始と終了」ページをご確認ください。
8. インストーラーを実行する
You can run the installer in GUI, console or unattended modes.
Run the installer.
From your Linux terminal, change to the directory where you downloaded Bitbucket Server then execute this command to make the installer executable:chmod +x atlassian-bitbucket-x.x.x-x64.bin
sudo
を使用してインストーラーを実行することをお勧めします。これにより Bitbucket Server を実行する専用アカウントが作成され、Bitbucket Server をサービスとして実行できます。インストーラーを実行するために
sudo
を使用するには、次のコマンドを実行します。$ sudo ./atlassian-bitbucket-x.x.x-x64.bin
You can also run the installer with root user privileges.
- Follow the prompts to upgrade Bitbucket Server.
At the 'Welcome' step, choose the type of instance to upgrade
At the 'Select Bitbucket Server Home' step, select your existing home directory.
Proceed with the remaining installer steps.
9. Start the application
If you’re also upgrading your operating system libraries and using PostgresSQL and glibc version lower than 2.28, and the upgrade increases the glibc version to 2.28 or later, you’ll need to rebuild the PostgresSQL indices before starting Bitbucket.
When using the installer, there will be an option to start the application (and launch it in a browser) at the end of the installation wizard.
Bitbucket を手動で開始する方法を含む詳細な手順については、「Bitbucket の開始と終了」をご確認ください。
Rollback
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.
Check for known issues and troubleshooting
If something is not working correctly after you have completed the steps above to update your Stash installation, please check for known Stash issues and try troubleshooting your update as described below:
- Check for known issues. Known issues can be seen in the BSERV project on our issue tracker.
- Bitbucket Server 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 Bitbucket Server Knowledge Base.
- If you encounter a problem during the update and cannot solve it, please create a support ticket and one of our support engineers will help you.