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/inventoryansible_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