OpenLM Router の変更、アップグレード、削除

Router はライセンス経路上にあるため、アップグレード、移行、削除のときは手順の順序が重要です。停止した Router をまだ指しているクライアントは、ライセンスをチェックアウトできません。このページでは、それぞれの変更を安全に行う順序を説明します。

始める前に

次の点を確認してください。

• Router ホストで、docker-compose.yml と .env ファイルがあるディレクトリーから docker compose を実行できること。
• どのクライアントが Router を指しているかを把握していること。クライアントは、LM_LICENSE_FILE、ベンダー固有の変数、または licpath.lic ファイルで port@router-host を使います。クライアントを Router に向けるを参照してください。
• OpenLM Platform で LicOps Configuration を開けること。Navigation メニューの Licenses and Features にあります。

OpenLM Router をアップグレードする

Router を新しいビルドにアップグレードするには、次の手順に従います。

1. docker-compose.yml で、各 Router イメージの新しいタグを固定します。どのビルドがあるかを確認するには、利用可能なビルドを確認するを参照してください。OpenLM は 2 つのイメージを別々にリリースするため、タグが異なる場合があります。

2. イメージを取得し、コンテナーを再作成します。

   docker compose pull routerapi routerui
   docker compose up -d routerapi routerui

3. Router が構成を再び適用したことを確認します。

   curl http://localhost:8100/readyz

   boundPorts が desiredPorts と一致していれば、Router はクライアントを受け付ける準備ができています。

構成はコンテナーではなく MongoDB と OpenLM Platform に保存されています。コンテナーを置き換えても失われず、Router の起動とともにリッスンポートが再び開きます。ほかの再起動と同じく、短い中断が発生します。開いているセッションは切断され、FlexLM クライアントは再接続します。

フェイルオーバーペアまたは Platform 接続を変更する

フェイルオーバーペアは、Router ではなく LicOps Configuration で変更します。フェイルオーバーペアを定義するを参照してください。Platform 接続を変更するには、Router UI を開いて Platform Connection を更新します。Router を Platform に接続するを参照してください。

OpenLM Router を新しいホストへ移す

新しい Router は独自の ID を持ちます。Router は初回起動時に ID を作成して MongoDB に保存し、OpenLM Platform は新しい ID の Router を別の Router として扱います。停止なしで移行するには、短時間だけ両方の Router を実行し、その間にクライアントを移します。

1. 新しいホストに、空の MongoDB データベースを使って新しい Router をデプロイします。OpenLM Router をデプロイするを参照してください。
2. Identity で、その Router 用に新しい Router クライアントを作成し、OpenLM Platform に接続します。Router を Platform に接続するを参照してください。
3. LicOps Configuration で、フェイルオーバーペアを定義し直します。Platform は、新しい Router に対して空の初期構成を作成します。新しいリッスンポートを使うか、古い Router を先に停止してから同じポートを使います。
4. テスト用のワークステーションを新しい Router に向け、lmutil lmstat を実行します。クライアントを Router に向けるを参照してください。
5. 残りのクライアントを新しい Router に向けます。
6. OpenLM Router を削除するの説明に従って、古い Router を削除します。

LicOps Configuration が一度に扱う Router は 1 つで、最後に報告した Router です。両方の Router が報告している間は、ページが 2 つの間で切り替わることがあります。移行は手早く終え、クライアントを移したらすぐに古い Router を停止してください。LicOps Configuration に別の Router が表示されるのはなぜですかを参照してください。

OpenLM Router を削除する

Router を運用から外すには、先にクライアントの向き先を戻し、Router は最後に停止します。次の順序で実行してください。

1. すべてのクライアントを、ライセンスサーバーまたは別の Router に向け直します。クライアントを Router に向けるの説明に従って、LM_LICENSE_FILE、ベンダー固有の変数、licpath.lic ファイルを変更します。各アプリケーションを、ライセンスサーバーに対して lmutil lmstat で確認します。

2. Router を使用しているクライアントが残っていないことを確認します。直接接続のフォールバックエントリーを残しているクライアントは、Router が停止している間も動作します。残していないクライアントは、停止した時点でライセンスを失います。

3. 不要になったフェイルオーバーペアを削除します。LicOps Configuration の Port Mappings でペアを選択し、Delete を選択します。

4. Router を停止します。廃止した Router が動作したままだと、OpenLM Platform への報告が続き、LicOps Configuration にその Router のペアが表示されます。

   docker compose stop

5. Router の ID クライアントを削除します。OpenLM Platform で Navigation、Identity の順に選択します。Authorization を選択し、この Router のエントリーを選択して Delete を選択し、確認します。削除すると、その認証ファイルではサインインできなくなります。

6. コンテナーを削除します。

   docker compose down

   このコマンドは Docker ボリュームを残すため、MongoDB と Redis のデータはホストに残ります。この Router を二度と再利用しないと確信できる場合にだけ、-v を付けてください。MongoDB には、Router の ID、暗号化された Platform 接続、フェイルオーバー履歴が保存されています。データベースを削除すると、後で起動する Router は別の Router になります。

同じ Router をもう一度起動する予定がある場合は、MongoDB ボリュームを残し、手順 5 の ID クライアントは削除しないでください。

次のステップ

Router を再び追加する、または別のアプリケーションを保護するには、OpenLM Router を設定するに進みます。

関連項目

• OpenLM Router をデプロイする
• OpenLM Router を運用する
• OpenLM Router のトラブルシューティング