ライセンスサーバ

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

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

（注）

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

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



（例）

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

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

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

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

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

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


2.1 dpkeylist

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

1. 格納場所
   dpkeylist は、以下の定められたファイルパスで保存します。

   /usr/local/lib/dp/dpkeylist

   ((参))

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

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

   アプリケーション名:ライセンス数:パスワード[:未使用時間のタイマ]

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

   • アプリケーション名
     Wnn6 for Linux/BSD Ver.3.0 では、WNN6 となります。(小文字不可)

   • ライセンス数
     出荷時に 2 が設定されています。
     それ以上のライセンス数を希望される場合は、直接弊社へご請求ください。
     その際の弊社窓口については、インストレーションガイドなどでご確認ください。
     なお、一つのマシンで設定できる最大ライセンス数は 255 です。

   • パスワード
     出荷時に弊社から発行いたします。
     パッケージに含まれているユーザ登録カードに刻印されているパスワード（文字列）を使用します。(注）
     パスワードは 1 台のマシンに特異なもので、複数のマシン間で流用することはできません。

   • 未使用時間のタイマ（オプション）
     アプリケーションが未使用の状態で、ある一定時間を経過した場合に、 そのアプリケーションが獲得したライセンスを開放します。
     このときの未使用時間のタイマ値を分単位で指定します。この設定は 必要に応じて行うもので省略可能です。

   (注）

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

   （例）

   未使用時間のタイマを設定しない場合: （提供されたパスワードの記述のみ） 　WNN6:2:B0E314D784C7800D6B8C81515B 未使用時間のタイマを設定する場合: （提供されたパスワードの末尾にタイマ時間を追加記述） 　WNN6:2:B0E314D784C7800D6B8C81515B:30（注） （注）上記の例では、タイマ値を 30 分に設定しています。

2.2 dpkeyallow

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

   /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 Ver.3.0 出荷時では、dpkeyservlist はインストール対象外となっています。このファイルを使用される場合には、以下の説明をよくお読みの上、新規に作成してください。

1. 格納場所
   dpkeyservlist は、以下の定めれられたファイルパスで保存します。

   /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>] [-t min]

[-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 オプションでのそれと同じです。

（参）

dpkeyserv には、jserver / wnnds と同様に syslog 出力機能があります。この機能で出力されるログは、レベル 1 から レベル 5 に分類されます。上記の -l オプションでは dpkeyserv のレベル 4 に相当するログが出力されることになります。-L オプションでは 同 レベル 5 に相当するログが出力されます。レベル 1〜3 のログ（エラーメッセージ他）は syslog ファイルに出力すると同時に標準エラー出力(stderr)もされます 　dpkeyserv における出力ログ内容については、付録の「エラーメッセージ一覧」dpkeyserv の箇所を参照してください。

[-t　min]

アプリケーションが dpkeyserv からライセンスを供与されながら一定時間未使用である場合に、そのライセンスを開放します。 min に未使用の時間間隔を分単位で指定します。 この指定は、Wnn6 に限らず dpkeylist で設定されている全アプリケーションに対して有効となります。

3.2 dpkeystat

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


（注）

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

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

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