コンテンツにスキップ
Machbase DBMS マニュアル
3. インストール、デプロイ、アップグレード
3.4 アップグレード

3.4 アップグレード

アップグレードは実行ファイルの交換だけでなく、既存のデータ、設定、アプリケーションが新バージョンで 同じ意味で動作するかを確認する作業です。まず対応するバージョン間の経路を確認し、復元可能なバックアップと サービス再開基準を準備します。以下の8.7.0パッケージ名とパスは、提供された実際の配布物に合わせます。

アップグレード前の確認事項

  • 現在と対象のバージョンの互換性を確認します。マイナーバージョンが異なるとDBファイル形式が変わる場合があります。
  • アップグレード前にバックアップします。バックアップ方法を参照してください。
  • 実行中のINSERT・APPENDクライアントを確認します。

8.7.0アップグレードの事前確認

8.5から8.7.0にアップグレードする場合は、バイナリ交換前に次の依存関係を調査し、対応する方式へ移行します。

  1. 廃止されたHTTP_AUTH、HTTP_ENABLE、HTTP_MAX_MEM、HTTP_PORT_NO、RS_CACHE_*、 STREAM_THREAD_COUNT、STREAM_WAIT_MS設定を現在のファイルで探し、サポート一覧と照合します。 廃止設定は削除し、継続設定は保持します。特にClusterのHTTP_ADMIN_PORTは現行の管理ポートのため、 HTTP_*という理由で一緒に削除しないでください。
  2. /machbase、/machiotを呼ぶアプリケーションは、対応SDKを使用するバックエンドへ移行します。
  3. STREAM_*プロシージャとFLUSH RESULT_CACHEを実行するSQL・運用スクリプトを変更します。
  4. machcli.hとMachCLI*()を使用するC/C++アプリケーションをMachbase SQLCLIまたはODBCに移行します。 SQLCLIとODBCは異なるAPI集合です。
  5. WebAdmin/MWAに依存する運用手順・ダッシュボードは、コマンドラインツールまたは別アプリケーションへ移行します。

全廃止項目と継続機能は バージョンと互換性を参照してください。

アップグレード経路

Edition方式リンク
Standard Editionサーバー終了後にパッケージを交換Standard Editionのアップグレード
Cluster EditionBroker/Warehouseを順次アップグレードオンラインアップグレード
Cluster Edition全体停止全体停止アップグレード

Cluster Editionではデータ可用性の要件に応じてオンライン方式または全体停止方式を選びます。

Standard Editionのアップグレード

サーバーを終了し、パッケージを交換して再起動します。物理DBファイルをそのまま開くことがサポートされる バージョン間経路だけに適用します。データ変換やエクスポート・インポートが必要な経路は、 該当リリースの移行手順を先に実行します。

アップグレード前の準備

  1. バックアップ: 対応するBACKUPコマンドでバックアップを作成し、別環境で復元可能か確認します。 実行中のデータディレクトリを単純にコピーしただけで復旧可能なバックアップを確保したとは判断しません。

  2. クライアント接続の終了: 実行中のAppendまたはINSERTをすべて完了します。

  3. 現在のバージョン確認:

    machbased -v

アップグレード手順

1. サーバーの終了 

machadmin -s
# Machbase server shut down successfully.

2. 既存パッケージと設定の保管

実行ファイルとライブラリだけでなく、現在の設定とライセンスも別の場所に保管します。 以下のパスに以前のバックアップがないことを確認して実行します。

cp -a "$MACHBASE_HOME/bin" "$MACHBASE_HOME/bin.bak"
cp -a "$MACHBASE_HOME/lib" "$MACHBASE_HOME/lib.bak"
cp -a "$MACHBASE_HOME/conf" "$MACHBASE_HOME/conf.bak"

データディレクトリ（dbs/）と別途指定したDBS_PATHは保持します。 上記のコピーは実行ファイルと 設定の保管であり、DBバックアップの代わりにはなりません。新バージョンがデータを変更した後に旧実行ファイルを 戻すだけで復旧できるとは考えず、検証済みのバックアップ復元経路を使用します。

3. 新パッケージの展開

新パッケージは別の作業ディレクトリに展開し、構成と設定の変更点を先に確認します。

upgrade_stage=$(mktemp -d)
tar zxf machbase-SDK-8.7.0.official-LINUX-X86-64-release.tgz -C "$upgrade_stage"

展開だけでは既存インストールの実行ファイルは変わりません。以下はbin/、lib/、include/を含む Standard tarballから実行ファイル・ライブラリ・ヘッダーを反映する例です。先にサーバー終了を確認し、 コマンドが失敗した場合は次の起動段階に進まないでください。

(
  set -e
  test -n "$MACHBASE_HOME"
  test -x "$upgrade_stage/bin/machbased"
  test -d "$upgrade_stage/lib"
  test -d "$upgrade_stage/include"
  test -d "$MACHBASE_HOME/bin"
  test -d "$MACHBASE_HOME/lib"
  test -d "$MACHBASE_HOME/include"
  cp -a "$upgrade_stage/bin/." "$MACHBASE_HOME/bin/"
  cp -a "$upgrade_stage/lib/." "$MACHBASE_HOME/lib/"
  cp -a "$upgrade_stage/include/." "$MACHBASE_HOME/include/"
  "$MACHBASE_HOME/bin/machbased" -v
)

既存のconf/machbase.conf、ライセンス、実際のDBS_PATHのデータは保持し、新設定項目を既存設定に マージします。コピーは同名の配布ファイルを交換しますが、旧バージョンにしかないファイルは自動削除しません。 SDKやプラグインは新バージョンに合うファイルを明示的に選び、追加の交換対象と削除項目はリリース情報で確認します。 出力されたバイナリバージョンと設定の確認が完了してからサーバーを起動します。

4. サーバーの起動 

machadmin -u
# Machbase server started successfully.

5. バージョンの確認 

machbased -v

# サーバーへ接続
machsql -s 127.0.0.1 -P 5656 -u SYS -p MANAGER
SELECT EDITION, BINARY_DB_MAJOR_VERSION, BINARY_DB_MINOR_VERSION FROM V$VERSION;

注意事項

  • dbs/ディレクトリを削除・初期化（machadmin -d）しないでください。
  • マイナーバージョン間のアップグレードではDBファイルの移行が必要な場合があります。必ずリリースノートを確認してください。
  • Windowsでは新パッケージまたはインストーラー適用前にMachbaseサービスを停止します。

Cluster Editionのアップグレード

サービス停止の可否に応じて2つの方式から選びます。

方式サービス停止適している状況
オンラインアップグレードBroker/Warehouseを順次再起動BrokerとWarehouseだけを交換する本番環境
全体停止アップグレードありメンテナンス時間帯を確保できる場合、メジャーバージョン変更

共通の事前注意事項

  • アップグレード中はDDLまたはDELETEを実行しないでください。
  • アップグレード中にノードの追加・起動・終了・削除を並行して行わないでください。
  • オンラインアップグレードはBrokerとWarehouseが対象です。Coordinator、Deployer、Lookupも交換する場合は全体停止方式を使用します。
  • アップグレード前のバックアップを推奨します。

オンラインアップグレード

稼働中のクラスターでBrokerとWarehouseを順次アップグレードします。Coordinator、Deployer、Lookupを 含む全バイナリの交換が必要な場合は 全体停止アップグレードを使用します。

アップグレード手順

1. cluster.yamlのパッケージ変更

cluster.package.nameとcluster.package.origin_pathを新パッケージに変更します。 パッケージ内容が変わる場合は、パッケージ名とアーカイブ名も一意な新しい名前に変更します。

cluster:
  package:
    name: machbase-v8.7.0
    origin_path: /home/machbase/packages/machbase-cluster-8.7.0.official-LINUX-X86-64-release.tgz

registered_pathはmachclusterctl exportが記録するCoordinatorのパッケージ保存先パスです。 アップグレードするアーカイブの指定にはorigin_pathを使用します。

2. 実行計画の確認 
machclusterctl upgrade -f cluster.yaml --online --dry-run --verbose
3. オンラインアップグレードの実行 
machclusterctl upgrade -f cluster.yaml --online --yes --verbose

--onlineを省略してもオンラインモードになりますが、運用手順を明確にするため明示を推奨します。

4. 全体状態の確認 
machclusterctl status

手動アップグレードの補足

machcoordinatoradmin --upgrade-nodeを直接使用する場合は、対象ノードとパッケージ名をともに指定します。

machcoordinatoradmin --upgrade-node=192.168.1.11:5401 --package-name=machbase-v8.7.0

オンラインの対象はBrokerとWarehouseに限定します。Brokerが1台しか残っていないときにそのBrokerを アップグレードすると、その間クライアント接続が切れる場合があります。

オンラインモードはクラスター全体の停止を省略する方式であり、無停止を保証するHA対応のローリング アップグレードではありません。Warehouseグループが一時的に読み取り専用になる場合があるため、 アプリケーションの再接続・再試行と書き込み遅延を検証する必要があります。プロトコル互換性が変わる場合や、 全役割のバイナリを合わせる必要がある場合は全体停止方式を使用します。

全対象ノードの役割状態とバージョンを確認してから、代表的な検索・入力とレプリケーション状態まで検証します。

全体停止アップグレード

クラスターを完全に終了し、全ノードを一括アップグレードします。Coordinator、Deployer、Lookupを含む 全バイナリの交換が必要な場合や、DBファイル形式の変更を伴う場合に使用します。

アップグレード手順

1. クライアント接続の終了

全INSERT・APPEND・SELECT操作が完了したことを確認します。

2. cluster.yamlのパッケージ変更

cluster.package.nameとcluster.package.origin_pathを新パッケージに変更します。 アップグレード前にノード追加・削除・ポート変更などのトポロジー変更を残してはいけません。 変更がある場合は先にapplyで反映してからアップグレードします。

machclusterctl upgrade --full-stopはCoordinatorとDeployerを含む全ノードホームに同じパッケージを 交換反映します。そのためorigin_pathにはmachcoordinatoradminとmachdeployeradminを含む 完全なClusterパッケージを指定します。

3. 実行計画の確認 
machclusterctl upgrade -f cluster.yaml --full-stop --dry-run --verbose
4. 全体停止アップグレードの実行 
machclusterctl upgrade -f cluster.yaml --full-stop --yes --verbose

machclusterctlはクラスター全体の停止を前提に、パッケージを一時準備パスへ展開してから ノードホームへ交換反映します。

手動デプロイの補足

手動デプロイ環境で直接交換する場合は、Coordinatorに新パッケージを登録します。

machcoordinatoradmin --add-package=machbase-v8.7.0 \
  --file-name=/home/machbase/packages/machbase-cluster-8.7.0.official-LINUX-X86-64-release.tgz

Warehouse → Broker → Lookup → Deployer → Coordinatorの順で終了します。

machcoordinatoradmin --shutdown-node=192.168.1.13:5501
machcoordinatoradmin --shutdown-node=192.168.1.14:5501
machcoordinatoradmin --shutdown-node=192.168.1.11:5401
machcoordinatoradmin --shutdown-node=192.168.1.10:5301
machdeployeradmin --shutdown
machcoordinatoradmin --shutdown

各ノードホームを新パッケージに交換する際は、既存のconf/machbase.conf、dbs/、meta/、package/を 保持します。別の作業パスに新パッケージを展開し、保持対象パスを除いて交換します。

Coordinator → Deployer → Lookup → Broker → Warehouseの順で起動します。

machcoordinatoradmin --startup
machdeployeradmin --startup
machcoordinatoradmin --startup-node=192.168.1.10:5301
machcoordinatoradmin --startup-node=192.168.1.11:5401
machcoordinatoradmin --startup-node=192.168.1.13:5501
machcoordinatoradmin --startup-node=192.168.1.14:5501

再起動後、BrokerとWarehouseのパッケージメタデータを新パッケージ名に同期します。

machcoordinatoradmin --upgrade-node=192.168.1.11:5401 --package-name=machbase-v8.7.0
machcoordinatoradmin --upgrade-node=192.168.1.13:5501 --package-name=machbase-v8.7.0
machcoordinatoradmin --upgrade-node=192.168.1.14:5501 --package-name=machbase-v8.7.0
5. 状態の確認 
machclusterctl status

ノード状態に加え、Broker接続、代表データの検索・入力、レプリケーション、ライセンス、設定値を確認してから サービスを再開します。インストール検証の結果を変更前の記録と比較し、 検証完了まで旧パッケージ・設定とバックアップを保持します。

注意事項

  • メジャーバージョンのアップグレードではDBファイル形式が変わる場合があります。必ずリリースノートを確認し、事前にバックアップしてください。
  • conf/machbase.conf、dbs/、meta/、package/を削除・初期化しないでください。
最終更新日
3.3 Cluster Editionのインストールとデプロイ3.5 インストール検証チェックリスト