ライセンスサーバ

1 ライセンスサーバの概要

ライセンスサーバは、ネットワークにより相互接続されたマシン上で、同時使用されるソフトウェアの使用許諾権(ライセンス)の管理を一括して行うプログラムをいいます。 Wnn6 for Linux/BSD を管理するライセンスサーバ dpkeyserv では、出荷時の初期設定で 同時使用が可能なライセンス数 2 を設定しています。（注）

（注）

ライセンス数など、ライセンス管理に関する情報を記述、設定したファイルを dpkeylist といいます。dpkeylist はソフトウェア許諾リストです。dpkeylist の取り扱いについては、インストレーションガイドでご確認の上、正しい設定を行うようにしてください。

jserver によるかな漢字変換時に、ライセンスサーバに対してライセンスの要求が行われます。 ライセンスサーバは、ライセンス管理ファイル(ソフトウェア許諾リスト、アクセス制御リストなど)で設定されている内容にしたがって、ライセンスの供与を行います。
下図を参照してください。



（例）

ライセンス数 2 が設定されている環境下では下図のようになります。

本章では、このライセンス管理のしくみについて、ライセンス管理ファイルの内容とライセンス管理コマンドの使用方法を中心に説明しています。
Wnn6 for Linux/BSD では、ライセンスサーバからライセンスを取得できなかった(供与されなかった)クライアントで、かな漢字変換を行うことはできません。

2 ライセンス管理ファイル

ライセンスサーバを管理(制御)するファイルは以下の通りです。
1. ソフトウェア許諾リスト(dpkeylist)
   Wnn6 for Linux/BSD の、ネットワーク上で同時に使用可能な最大数(ライセンス数)を設定します。
2. アクセス制御リスト(dpkeyallow)
   ライセンスサーバへ接続できるクライアントを制限します。
   dpkeyallowファイルが設定されていない場合は、クライアントの制限は行われずに、ネットワーク上のどのクライアントマシンからでもライセンスサーバマシンへ接続してライセンスを取得することができます。
   
3. サーバアクセスリスト(dpkeyservlist)
   1 つのクライアントから複数のライセンスサーバへ接続できるようにします。
   

   1.はライセンスサーバマシン側で必ず設定します。
   2.はライセンスサーバマシン側で必要に応じて設定します。
   3.はクライアントマシン側で必要に応じて設定します。
   

((参))

ライセンスサーバ dpkeyserv は、弊社における他の製品(dp/NOTE for Linux/BSD など）のライセンス管理も行います。したがって、上記のライセンス管理ファイルは Wnn6 に限らず、dpkeyserv からライセンスを取得するようになっている弊社製のアプリケーションの動作で共通に適用されるものです。

以下で、上記のそれぞれのファイルについて説明します。


2.1 dpkeylist

ライセンスサーバが一度に供与できるライセンス数を定義します。 ライセンスサーバマシン上で必ず設定しておきます。 dpkeylist の設定方法として、格納場所、記述内容について以下に説明します。


1. 格納場所
   dpkeylist は、以下の定められたファイルパスで保存します。
   （優先度の高い順で記述）
   

   1./usr/jp/lib/dp/dpkeylist
   2./usr/local/lib/dp/dpkeylist
   

   ((参))

   ライセンスサーバ dpkeyserv の起動時のオプション -f で dpkeylist ファイルを上記の格納場所に関わらず指定することができます。このときのファイル指定が最優先されます。

2. 記述内容
   dpkeylist に記述(定義)する内容は、ライセンス管理を行うアプリケーション名、ライセンス最大供与数(ライセンス数)、パスワードの 3 つです。
   記述形式は以下のようになります。
   

   アプリケーション名:ライセンス数:パスワード

   ":"（コロン）で各要素を区切ります。同一行中で "#" 以降の記述はコメントとなります。
   

   • アプリケーション名
     Wnn6 for Linux/BSD では、WNN2 となります。(小文字不可)
   • ライセンス数
     出荷時に 2 が設定されています。
     それ以上のライセンス数を希望される場合は、直接弊社へご請求ください。
     その際の弊社窓口については、インストレーションガイドなどでご確認ください。
     
   • パスワード
     出荷時に弊社から発行いたします。
     パッケージに含まれているユーザ登録カードに刻印されているパスワード（文字列）を使用します。(注）
     パスワードは 1 台のマシンに特異なもので、複数のマシン間で流用することはできません。

   (注）

   パスワードの文字列は、すべて半角英数字の大文字です。その他の文字種は使用して いません。 アルファベットの O は使用していません。 アルファベットの I と数字の 1 を間違えないように注意してください。

   （例）

   出荷時における設定内容: 　WNN2:2:F2D5C0FA708CD65D49E2202C2B




2.2 dpkeyallow

ライセンスサーバと接続できるクライアントホストを制限します。
必要に応じてライセンスサーバマシン上に設定します。
dpkeyallow の設定方法として、格納場所、記述内容について以下に説明します。


1. 格納場所
   dpkeyallow は、以下の定めれられたファイルパスで保存します。
   (優先度の高い順で記述)
   

   　1./usr/jp/lib/dp/dpkeyallow
   　2./usr/local/lib/dp/dpkeyallow
   

   ((参))

   ライセンスサーバ dpkeyserv の起動時のオプション -a で dpkeyallow ファイルを上記の格納場所に関わらず指定することができます。このときのファイル指定が最優先されます。

2. 記述内容 dpkeyallow には、ライセンスサーバと接続可能なクライアントホスト名を記述します。
   記述形式は以下のようになります。
   

   クライアントホスト名　　 クライアントホスト名　　 クライアントホスト名　　 　　　　・ 　　　　・ 　　　　・

   ((例))

   hostnameA　　　　　 hostnameB　　　　　 hostnameC

   ネットワーク上の、hostnameA / hostnameB / hostnameC 以外のクライアントマシンへはライセンスサーバは供与されなくなります。
   

2.3 dpkeyservlist

任意のホストのクライアントから使用できるライセンスサーバを登録します。
必要に応じてクライアントマシン上に設定します。（注）


dpkeyservlist に複数のライセンスサーバホストマシンを設定することにより、1 台のサーバホストマシンに障害が発生してダウンすることになっても、自動的に別のサーバホストマシンに接続して、クライアント側でのアプリケーションの使用を中断させません。
また、クライアント数やマシンの台数が多い場合などには、ネットワーク資源を有効に活用して、負荷分散・危険分散させる手段となります。
dpkeyservlist の設定方法として、格納場所、記述内容について以下で説明します。


（注）

Wnn6 for Linux/BSD 出荷時では、dpkeyservlist はインストール対象外となっています。このファイルを使用される場合には、以下の説明をよくお読みの上、新規に作成してください。

1. 格納場所
   dpkeyservlist は、以下の定めれられたファイルパスで保存します。
   (優先度の高い順で記述)
   

   　1./usr/jp/lib/dp/dpkeyservlist
   　2./usr/local/lib/dp/dpkeyservlist
   

2. 記述内容
   dpkeyservlist には、ライセンスサーバホストマシン名のみを記述します。
   (複数設定可)

   （例）

   hostname1　　　　　 hostname2

   この設定例では、hostname1 からライセンスが供与されない場合に、自動的に hostname2 へライセンスを要求するようになります。

3. 実行コマンド

ライセンスサーバの起動、制御コマンドには以下の 2 つがあります。


1. サーバ起動コマンド(dpkeyserv)
   ライセンスサーバを起動します。
   
2. サーバ制御コマンド(dpkeystat)
   ライセンスサーバの現在の使用状況や現在取得(消費)されているライセンスの開放(返却)を行います。

上記のそれぞれについて説明します。


3.1 dpkeyserv

前述の「2.1 dpkeylist」「2.2 dpkeyallow」(dpkeyallow は設定されていれば)の設定ファイルの内容にしたがって、ライセンスサーバを起動します。
1 つのホストマシン上では、ライセンスサーバは同時に 1 個しか起動させることができません。
また、dpkeylistファイルの記述に誤りがある場合、ライセンスサーバは起動しません。
ライセンスサーバは、SIGUP, SIGTERM, SIGKILL, SIGINT, SIGQUIT のシグナルを受けるまで、その動作を続行します。

ライセンスサーバdpkeyservの起動方法は以下の通りです。

dpkeyserv　[-a　dpkeyallow_file] [-f　dpkeylist_file] 　　　　　[-l　<logfile>] [-L　<logfile>]




[-a　dpkeyallow_file]	ライセンスサーバのアクセス制御リストのファイルパス名を指定します。 このオプション指定がなければ、前述の「2.2 dpkeyallow」にあるファイルの格納場所を検索します。
[-f　dpkeylist_file]	ライセンスサーバのソフトウェア許諾リストのファイルパス名を指定します。 このオプション指定がなければ、「2.1 dpkeylist」にあるファイルの格納場所を検索します。
[-l　<logfile>]	ライセンスサーバにおける通信のログをlogfileに保存します。 ログファイル名 logfile の引数の省略時には以下の優先順位で対応します。 環境変数 DPKEY_LOGFILE 設定されたファイルパス名 /usr/local/lib/dp/log
[-L　<logfile>]	-l オプションと同じくライセンスサーバにおける通信のログを logfile に保存します。ただし、-L オプションでは、-l オプションと比べて通信パケットのダンプを余分に保存します。 ログファイル名省略時の対応は -l オプションでのそれと同じです。

3.2 dpkeystat

dpkeystat は、ライセンスサーバ dpkeyserv の使用(消費)状況の表示と一旦取得されたライセンスの開放、dpkeyserv の終了などを行います。
ライセンスの開放と dpkeyserv の終了は root の権限で行います。(注）


（注）

ライセンスの開放は、使用中のライセンスを開放することなくクライアントが異常終了した場合などに、強制的にライセンスを開放するために行います。

dpkeystat　[-D　server_hostname] [-h　client_hostname] 　　　　　[-a　application] [-u　username] [-i　interval] 　　　　　[<-y>　license_number] [-k　<server_hostname>]

[-D　server_hostname]	dpkeystatコマンドの実行対象となるライセンスサーバマシンを指定します。 -D オプションを使用しない場合は、「2.3 dpkeyservlist」にある dpkeyservlist ファイルに登録されているホスト名に対応します。 dpkeyservlist ファイルが存在しない場合は、localhost に対応します。
[-h　client_hostname]	client_hostname で指定されたクライアントホストについてのみライセンスの使用状況の表示や開放を行います。
[-a　application]	application で指定されたアプリケーションについてのみ、ライセンスの使用状況の表示や開放を行います。 ((参)) 　ここで使用するアプリケーション名は、ライセンスサーバ管理関連での名称です。Wnn6 for Linux/BSD の場合は、前述の「2.1 dpkeylist」で記述している通りに WNN2 となります。
[-u　username]	username で指定されたユーザについてのみ、ライセンスの使用状況の表示や開放を行います。
[-i　interval]	dpkeystat 実行による表示を interval で指定された間隔で繰り返します。interval は秒単位で指定します。 この指定を行うと、SIGINTなどで強制終了させない限り、永久に繰り返されることになります。
[<-y>　license_number]	ライセンスを開放します。スーパーユーザの権限で行ってください。 license_numberには、dpkeystat の表示で LNO の欄にあるライセンス番号を指定します。 通常、このオプションの使用時には、実行(kill)の確認を行いますが、ライセンス番号の前に -y を指定すると、この確認が行われなくなり、すぐにライセンスが開放されることになります。
[-k　<server_hostname>]	ライセンスサーバ dpkeyserv を終了(kill)します。 スーパーユーザの権限で行ってください。指定時には、必ず実行の確認が行われます。