How to upgrade Remote Mesh Nodes
プラットフォームについて: Data Center のみ - この記事は、Data Center プラットフォームのアトラシアン製品にのみ適用されます。
この KB は Data Center バージョンの製品用に作成されています。Data Center 固有ではない機能の Data Center KB は、製品のサーバー バージョンでも動作する可能性はありますが、テストは行われていません。サーバー*製品のサポートは 2024 年 2 月 15 日に終了しました。サーバー製品を利用している場合は、アトラシアンのサーバー製品のサポート終了のお知らせページにて移行オプションをご確認ください。
*Fisheye および Crucible は除く
目的
When upgrading Bitbucket, the version on the Remote Mesh nodes may also need to be upgraded to maintain compatibility ( See Bitbucket Mesh compatibility matrix ).
環境
Bitbucket 8+ utilizing remote Mesh
例
In this example, we are upgrading from Mesh v2.0.8 to Mesh v2.3.0. The Mesh installation directory is '/opt/atlassian/mesh/current' where 'current' is a symlink to the existing version:
# ls -l
/opt/atlassian/mesh/current -> /opt/atlassian/mesh/atlassian-bitbucket-mesh-2.0.8
Download the new version
Download the package for the new version from the Bitbucket Mesh Downloads page and place it in the installation directory.
We can use this opportunity to update the scripts to match the configuration currently running:
ファイル | 用途 |
---|---|
set-jmx-opts.sh | Add JMX settings |
set-jre-home.sh | Define JRE_HOME or JAVA_HOME |
set-mesh-home.sh | Set the MESH_HOME directory |
set-mesh-user.sh | Define the process user (aka MESH_USER ) |
_start-mesh.sh | Configure the JVM heap or set JVM_SUPPORT_RECOMMENDED_ARGS |
Update the Symlink
Using a symlink allows us to stage the files and quickly switch between versions to minimize downtime. We can update the symlink using a command such as:
# ln -sfnv /opt/atlassian/mesh/atlassian-bitbucket-mesh-2.3.0 /opt/atlassian/mesh/current
...
# ls -l
/opt/atlassian/mesh/current -> /opt/atlassian/mesh/atlassian-bitbucket-mesh-2.3.0
Restart Mesh
With the symlink updated, we can use the stop and start scripts to restart Mesh with the updated version. Logging will verify for us the updated versions:
# /var/atlassian/application-data/mesh/log/atlassian-mesh.log
INFO [main] - c.a.b.mesh.app.BuildInfoLogger Starting Mesh 2.3.0
Additional Information
- If upgrading Bitbucket and Mesh, upgrade Mesh first and restart.
- Depending on your upgrade path, the H2 database may need to be migrated ( See Bitbucket Mesh Sidecar H2 database migration )