CodeMeter オフラインライセンス展開説明書

背景

LCC再構築の運用サーバーが外部ネットワークに接続できず、XGRIDSライセンスサーバーからライセンス制御情報をリアルタイムに取得できない場合、CodeMeter方式によるイントラネットライセンスに対応する。

方案概要

• プライベートな機器室内で、1台のマシンを選定し、CodeMeterライセンス管理サーバーとする。

  • CodeMeterライセンス管理サーバーは、Windowsマシンでも、Linuxマシンでもよい
  • 機器室が【USBドングル】に対応している場合、このマシンにUSBドングルを挿す（XGRIDSがイントラネットライセンスに対応した緑色のUSBドングルを提供する）
  • 機器室のサーバーがUSBハードドングルに対応していない場合、XGRIDSは特定のマシン向けに【ソフトライセンス】を生成し、そのマシンにインポートできる。

• Dockerコンテナがライセンスサーバーに実行許可を申請するモードの概要：

Linuxプライベートライセンスサーバーの展開

CodeMeterサービスのインストール

選定したライセンスサーバー上で、CodeMeter Runtime 実行環境をインストールし、その後：

• USBドングル形式を採用する場合、USBドングルをそのサーバーに挿すだけでよい；
• ソフトライセンスモードを採用する場合、ソフトライセンスは選定したライセンスサーバーのハードウェア特徴とバインドされる必要があり、変更できない。

※ 仮想マシンにソフトライセンスをインストールする場合、このソフトライセンスを常に利用可能に保つため、仮想マシンが存在する物理マシンを変更しないこと。また、その物理マシンの主要ハードウェア（cpu、マザーボード、ネットワークカードなど）も変更しないこと。

CodeMeter Runtime インストールパッケージのダウンロードアドレス

サーバーOSのバージョンが比較的新しい場合（Ubuntu20.04以上など）は、CodeMeter Runtime（Version 8.20）の使用を推奨する ：

• Linux rpm：https://cdn-bukbb1.xgrids.cloud/developer/deploy/codemeter/CodeMeter-8.20.6558-501.x86_64.rpm
• Linux deb：https://cdn-bukbb1.xgrids.cloud/developer/deploy/codemeter/codemeter-lite_8.20.6558.501_amd64.deb

サーバーOSのバージョンが比較的古い場合は、CodeMeter Runtime（Version 7.51）のインストールを推奨する

• Linux rpm：https://cdn-bukbb1.xgrids.cloud/developer/deploy/codemeter/CodeMeter-lite-7.51.5429-500.x86_64.rpm
• Linux deb：https://cdn-bukbb1.xgrids.cloud/developer/deploy/codemeter/codemeter-lite_7.51.5429.500_amd64.deb

CodeMeter Runtime のインストール方法

# DOWNLOAD Version8.20
wget https://cdn-bukbb1.xgrids.cloud/developer/deploy/codemeter/codemeter-lite_8.20.6558.501_amd64.deb

# INSTALL
sudo dpkg -i --force-all ./codemeter-lite_8.20.6558.501_amd64.deb

または

# DOWNLOAD
wget https://cdn-bukbb1.xgrids.cloud/developer/deploy/codemeter/codemeter-lite_7.51.5429.500_amd64.deb

# INSTALL
sudo dpkg -i --force-all ./codemeter-lite_7.51.5429.500_amd64.deb

CodeMeter Runtime のアンインストール方法

オペレーティングシステムのバージョンが比較的新しい場合（Ubuntu 20.04.6 LTS 以上など）、7.51バージョンのインストールコマンドを実行すると、出力に【Segmentation fault (core dumped)】のようなエラー情報が含まれる可能性がある。

sudo dpkg -i ./codemeter-lite_7.51.5429.500_amd64.deb    
                                                                                                                                                     
Selecting previously unselected package codemeter-lite.                                                                                                                                                                             
(Reading database ... 113440 files and directories currently installed.)                                                                                                                                                            
Preparing to unpack .../codemeter-lite_7.51.5429.500_amd64.deb ...                                                                                                                                                                  
Unpacking codemeter-lite (7.51.5429.500) ...                                                                                                                                                                                        
Setting up codemeter-lite (7.51.5429.500) ...                                                                                                                                                                                       
Segmentation fault (core dumped)                                                                                                                                                                                                    
Processing triggers for systemd (245.4-4ubuntu3.20) ...                                                                                                                                                                             
Processing triggers for man-db (2.9.1-1) ...     

同時に、cmu -l コマンドを実行すると、出力情報に "CodeMeter not running" エラー情報が含まれる。

この場合、現在のバージョンをアンインストールし、8.20バージョンをダウンロードして再インストールすることを推奨する。

# UNINSTALL 
sudo apt-get --purge remove codemeter-lite 

CodeMeterネットワークライセンスサービスの設定＆起動

インストール完了後、CodeMeterのネットワークサーバー機能を開く必要がある。具体的な操作手順は以下のとおり：

a) CodeMeter サービスを停止する。コマンドラインを使用する

sudo service codemeter stop 
sudo service codemeter-webadmin stop

**※ ここでは必ず先にstopしてから、iniファイルを修正できる。そうでないと修正は無効となる。**

b) Server.ini 設定ファイルを修正する；

sudoedit /etc/wibu/CodeMeter/Server.ini

# または管理者権限で任意のエディタを起動して編集します：
sudo vim /etc/wibu/CodeMeter/Server.ini

c) Server.ini 設定ファイル中の IsNetworkServer=1 を修正する（コンテナにライセンスを供与するサーバーとして動作することを許可することを表す）

Server.ini 設定ファイル中の CleanUpTimeOut=3 を修正する（クライアントが異常終了して3分後にライセンスポイント数を自動的に解放することを表す）

Server.ini 設定ファイル中の RemoteRead=2 を修正する（他のコンピュータからライセンスサーバーのWEBUIへのアクセスを許可することを表す）

修正後、ファイルを保存する。

d) 再度 CodeMeter サービスを起動する。コマンドラインを使用する

sudo service codemeter start
sudo service codemeter-webadmin start

e) コマンドライン cmu -l を使用して CodeMeter サービスが正常に起動したかを検出する。正常であれば下図のように表示される

f) 起動が異常な場合、出力内容にCodeMeter not runningが表示される。

上記のマニュアルに厳密に従って設定してもなお異常な場合は、テクニカルサポートに連絡してサポートを受けること。

CodeMeterライセンスサーバー管理ページ

ライセンスサーバーのオペレーティングシステム自体にグラフィカルインターフェースがある場合、本機のブラウザで http://localhost:22352/dashboard.html にアクセスして管理ページを開くことができる。

本機から開いた管理ページは「書き込み操作」の権限を持ち、ライセンス供与済みクライアントのオフライン化などの操作を実行できる。

ライセンスサーバーのオペレーティングシステムにグラフィカルインターフェースがない場合、上記のインストール手順でServer.iniのRemoteRead=2を設定済みであれば、他のコンピュータからその管理WebUIページにアクセスできる。まだ設定していない場合、設定方法は以下のとおり：

1) まず CodeMeter の WebAdmin サービスを停止します（必ず先に停止すること）
sudo service codemeter-webadmin stop

2) ini ファイルを編集します
sudo vim /etc/wibu/CodeMeter/Server.ini

[HTTP] セクションの RemoteRead を 2 に設定します
RemoteRead=2   

3) 再起動します
sudo service codemeter-webadmin start

この時、別のコンピュータからウェブページ http://サーバーIPアドレス:22352/dashboard.html にアクセスでき、ウェブページ内でライセンス管理状況を確認できる：

ライセンスのインポート

USBドングルライセンスのインポートフロー

緑色のUSBドングルをこのサーバーに挿すだけでよい。

ソフトライセンスのインポートフロー

1. XGRIDSオフラインライセンスツールソフトウェアをダウンロードする

#DOWNLOAD
wget https://xgbb1.oss-cn-shanghai.aliyuncs.com/developer/deploy/codemeter/codemeter-xgrids-tool

1. サーバー上でツールを実行し、ライセンスリクエストファイル "XGrids-LCC-LICENSE-シリアル番号.WibuCmRaC" を出力する

   #DOWNLOAD codemeter-xgrids-tool
   wget https://xgbb1.oss-cn-shanghai.aliyuncs.com/developer/deploy/codemeter/codemeter-xgrids-tool
   
   #RUN codemeter-xgrids-tool
   chmod +x ./codemeter-xgrids-tool
   ./codemeter-xgrids-tool
   
   #OUTPUT：
   -----> Make XGrids.WibuCmLIF
   Executing command: /usr/bin/cmu -l
   Command output:
    cmu - CodeMeter Universal Support Tool.
   Version 8.20a of 2024-Dec-03 (Build 6558) for Linux
   Copyright (C) 2007-2024 by WIBU-SYSTEMS AG. All rights reserved.
   
   List all locally connected CmContainers:
   - CmContainer with Serial Number 130-2780241535 and version 3.00 (empty)
   Result: 1 CmContainer(s) listed.
   
   Found Serial Number: 130-2780241535
   Executing command: /usr/bin/cmu --create-lt-context --lt-request-file XGrids-LCC-LICENSE-130-2780241535.WibuCmRaC -s 130-2780241535 --firmcode 6001945
   Command output:
    cmu - CodeMeter Universal Support Tool.
   Version 8.20a of 2024-Dec-03 (Build 6558) for Linux
   Copyright (C) 2007-2024 by WIBU-SYSTEMS AG. All rights reserved.
   
    Context file created successfully.
   
   ====== XGrids-LCC-LICENSE-130-2780241535.WibuCmRaC Created!  ======
   

2. 生成された XGrids-LCC-LICENSE-シリアル番号.WibuCmRaC ファイルをXgrids 営業担当者に送付する；

   1. Xgrids 営業担当者はそのファイルを利用して、ライセンス供与の申請フローを起こす。
   2. 申請が承認された後、Xgridsの技術担当者がライセンスファイル（XGrids-LCC-LICENSE-シリアル番号.WibuCmRaU）を生成する。

3. Xgrids は更新後のライセンスファイル（XGrids-LCC-LICENSE-シリアル番号.WibuCmRaU）を顧客に送付する。

4. 顧客はライセンスファイル（XGrids-LCC-LICENSE-シリアル番号.WibuCmRaU）を受け取った後、サーバー上で以下のコマンドを実行してアップグレードファイルをインポートする：

   cmu --import-lt-update --lt-update-file XGrids-LCC-LICENSE-<serial-number>.WibuCmRaU --firmcode 6001945 -s <serial-number>
   

5. ライセンスサーバー内にインポートされたライセンスを確認するには http://サーバーIPアドレス:22352/dashboard.html にアクセスする

ライセンス更新フロー

1. 現在のサーバー内のライセンスシリアル番号を照会し記録する

`cmu -l`コマンドを実行すると、現在のシステム内のライセンスシリアル番号（例えば、130-1299254712）が表示される。このシリアル番号は後続の手順でライセンスリクエストファイルを生成する際に使用する

1. サーバー上で【ライセンスリクエストファイルの生成】コマンドを実行する cmu --create-lt-context --lt-request-file "xxx.WibuCmRaC" -s130-xxxxxxxxxx --firmcode 6001945

   1. 130-xxxxxxxxxx：前の手順で取得したライセンスシリアル番号
   2. xxx.WibuCmRac：ライセンスリクエストファイル名（名前は任意にカスタマイズ可能、拡張子は固定）

2. 生成された xxx.WibuCmRac をXgrids 関連担当者に渡し、Xgrids がライセンスアップグレードファイル xxx.WibuCmRaU （拡張子は固定） を生成する

3. サーバー上で【ライセンスアップグレードファイルのインポート】コマンドを実行する： cmu --import-lt-update --lt-update-file xxx.WibuCmRaU --firmcode 6001945 -s 130-xxxxxxxxxx

   1. 130-xxxxxxxxxx：前の手順で取得したライセンスシリアル番号
   2. xxx.WibuCmRaU ：XGRIDSが生成したライセンスアップグレードファイル名（名前は任意にカスタマイズ可能、拡張子は固定）

4. 更新後のサーバー権限を確認するには http://サーバーIPアドレス:22352/dashboard.html にアクセスする

• 注意：システムの再インストールによってライセンスが失効した後は、すべての【*.WibuCmRaU】を順番にインポートしてはじめて元のライセンスを復元できる。毎回納品された【*.WibuCmRaU】ファイルを大切に保存すること。

LCCコンテナ起動時の設定

LCCコンテナ起動時、ライセンスサーバーのIPアドレスを「CODEMETER_SERVER」環境変数としてコンテナに渡す。

具体的には【LCC再構築ソフトウェア Docker版】の説明書を参照すること。

※ LCCコンテナ起動時には、起動コマンドラインで –privileged パラメータを使用しないよう注意すること

※ コンテナのネットワーク接続は一般的にデフォルトでブリッジ Bridge モードであり、このモードを保持すること。そうでないと暗号化プログラムが通信できない可能性がある

その他

ライセンスサーバーのアクセス可否を確認する方法

コンテナが別のホストマシン上で実行される場合、まずそのホストマシンがライセンスサーバーの22350ポートにアクセスできることを確認する必要がある。

テストコマンドは以下のとおり：

telnet 192.168.68.205 22350

Trying 192.168.68.205...
Connected to 192.168.68.205.
Escape character is '^]'.

同時に注意が必要なのは、ライセンスサーバー以外のホストマシンには、CodeMeter Runtime をインストールしないことである。そうでないと、コンテナの実行時にまず現在のホストマシン内のライセンスを探し、正常にライセンスを取得できなくなる。

CodeMeter Runtime の起動が異常かどうかを判断する方法

cmu -l コマンドの出力情報に CodeMeter not running が含まれる場合、正常に起動していないことを示す。テクニカルサポート担当者に連絡して原因を調査すること（インストール中に失敗が発生した可能性がある。）

cmu -l 

cmu - CodeMeter Universal Support Tool. 
Version 7.51 of 2022-Aug-25 (Build 5429) for Linux
                                            
List all locally connected CmContainers:   
Result: 0 CmContainer(s) listed. (CodeMeter not running)

現在のライセンス占有状況を確認する方法

コンテナ内のプログラムが起動した後、指定されたCodeMeterライセンスサーバーアドレスに従って実行に必要なライセンス数を申請する。

プロセスが正常に終了した場合、一般的に数分以内にライセンスが解放される；ライセンスは次回の起動で正常に利用できる。

ライセンスを手動で解放する方法

コンテナが直接KILLされた場合、コンテナ内プロセスが申請したライセンスはタイムアウトを待ってはじめて解放される（CodeMeterライセンスサーバーのデフォルトのタイムアウト時間は一般的に120分だが、本ドキュメントのインストールチュートリアルでは、すでに3分に変更している）。

ライセンスモニターページから、最終アクセス時刻に基づき、終了済みのプログラムを確認し、操作ボタンをクリックして手動で解放できる。

注意：ライセンスサーバー本機上でWebUIページを開いた場合にのみ、操作権限を持つ。そうでない場合は自動解放を待つしかない。

ライセンス異常の処理方法

何らかの原因（システム異常）によってライセンスが破損した場合：

まず、既存のライセンスを削除する cmu -sシリアル番号 --delete-cmact-license

次に初回ライセンスのWibuCmRaUファイルから1つずつインポートする

参考：ソフトライセンスのインポート具体操作フロー公式ドキュメント

https://help.wibu.com.cn/help/FAQ/codemeter/cmact/1757

サーバー上にバインドされたソフトロックライセンスの削除

公式ドキュメントの説明を参照： https://help.wibu.com.cn/help/FAQ/codemeter/cmact/ad7e

1. Windowsシステムで操作する場合は、CMDを開き、コマンドライン`cmu32 –l`を入力して、ソフトロックのシリアル番号を確認する。
   

1. さらに以下のコマンドでソフトロックを削除する：
   

cmu32 -s130-1633636009 --delete-cmact-license

1. Linuxシステムで操作する場合は、`cmu –l`コマンドを入力してソフトロックのシリアル番号を確認し、さらに以下のコマンドでソフトロックを削除する。
   

cmu -s130-1633636009 --delete-cmact-license