KAMONOHASHI 2.xから3.xへの移行

事前準備

KAMONOHASHI のバックアップが取れていることを確認します
KAMONOHASHI の Admin アカウントでログインできることを確認します

KAMONOHASHI 2.x のアンインストール

root ユーザーで次のコマンドを実行します

cd /var/lib/kamonohashi/deploy-tools/
./deploy-kamonohashi.sh clean all

アンインストールは ssh を用いて実行されます。
- 設定されている ssh ユーザーはdeepops/config/inventoryのansible_userの項目で確認できます。
- ssh ユーザーでの SSH にパスワードが必要な場合は、clean all に-kオプションを追加します。sudo にパスワードが必要な場合は-Kのオプションを指定します。
既知のバグによりエラーが出ますが、後の手順で再度アンインストールコマンドを実行するので無視して構いません

KAMONOHASHI 3.x 構築

KAMONOHASHI バージョン 3.1.0 用の構築ツールを入手します

cd /var/lib/kamonohashi/deploy-tools/
git fetch --tags
git checkout 3.1.0.0
(cd deepops; git stash save "backup berfore verup KAMONOHASHI 3")
git submodule update --init --recursive

構築ツールが正常に取得できているか次のコマンドで確認します

echo KAMONOHASHI deploy tool: $(git tag --points-at HEAD)
echo deepops: $(cd deepops; git tag --points-at HEAD)

KAMONOHASHI deploy tool: 3.1.0.0 , deepops: 21.03 　が表示されれば正常です。
正常でない場合、git submodule update --init --recursiveでエラーが出ていないかを確認してください

構築ツール依存パッケージの更新

プロキシ環境下では次のファイルにプロキシ設定を記載してください
- ./deepops/scripts/deepops/proxy.sh
- no_proxy にはlocalhost,127.0.0.1,.cluster.local,使用する各マシンのIPアドレス・ホスト名の記載を含めてください
- OS の no_proxy 設定にも上記と同様の no_proxy 設定が含まれるように設定してください。/etc/environmentで指定することを推奨します
次のコマンドを実行し、構築に必要なパッケージを入手します

./deploy-kamonohashi.sh prepare

移行設定の生成

次のコマンドを実行し、設定ファイルの生成を行います

./deploy-kamonohashi.sh configure verup

補足事項

このコマンドでは k8s 構築に利用するツールである deepops の設定ファイルについて、以前のバージョン 20.02.1 と現在のバージョン 21.03 で互換性がないことの対応を行っています。
deepops の設定ファイルの変更を抽出して deepops 既定外の独自の設定ファイルdeepops/config/settings.ymlに書き移します
deepops の設定ファイルは 21.03 のデフォルトに書き換えます
デプロイコマンド実行時には、deepops/config/settings.ymlの内容をデフォルト設定に上書きして適用されます
このコマンドは現在の deepops 設定ファイルと 20.02.1 の deepops 設定ファイルの差分を見るため、2 回実行すると 21.03 のデフォルトに書き換え後に 20.02.1 の deepops 設定との比較が行われ、settings.yml が意図しない内容となります。
過去の設定ファイルはdeepops/old_config配下にコピーされます
設定ファイルが正常に生成され、過去に deepops の設定ファイルを編集した内容が書き込まれているか確認します

cat deepops/conf/settings.yml

アンインストールの再実行

再度アンインストールコマンドを実行します

./deploy-kamonohashi.sh clean all

アンインストールは ssh を用いて実行されます。冒頭のアンインストールと同様に-K,-kオプションを必要に応じ追加します
deepops のデフォルト GPU ドライバパッケージがcuda-driversからnvidia-headless-450-serverに変更になりました。これらに互換性がないため、古い gpu ドライバと依存パッケージを含め、全ての nvidia パッケージのアンインストールを実施します。これらは以前の KAMONOHASHI デプロイツールのアンインストールコマンドではアンインストールされませんでした。
このコマンド実行後、GPU サーバーは再起動します
コマンド実行後に k8s master サーバーを手動で再起動します

reboot

設定の変更

設定内容をカスタマイズする場合は次を参照し、設定ファイルの編集を行ってください。カスタマイズ設定ガイド

構築の実施

再起動完了後に root ユーザーで次の構築コマンドを実行します

cd /var/lib/kamonohashi/deploy-tools
./deploy-kamonohashi.sh deploy all

構築は ssh を用いて実行されます。冒頭のアンインストールと同様に-K,-kオプションを必要に応じ追加します
シングルノード構成の場合はドライバインストールの際に k8s master サーバーが再起動されるため、再起動後に再度./deploy-kamonohashi.sh deploy allを実行してください

構築完了のメッセージが出たらブラウザで次の URL にアクセスし、admin ユーザーでログインして利用を開始してください

KAMONOHASHI: http://KAMONOHASHI 用サーバー/kamonohashi
アクアリウム機能: http://KAMONOHASHI 用サーバー/aquarium