下記で、各ライセンスキーごとにプロパティについて説明しています。

• wrapper.license.debug
• wrapper.license.dev_application
• wrapper.license.features
• wrapper.license.host_id
• wrapper.license.id
• wrapper.license.key.<n>
• wrapper.license.lease_term.begin_date
• wrapper.license.lease_term.end_date
• wrapper.license.licensee
• wrapper.license.type
• wrapper.license.upgrade_term.begin_date
• wrapper.license.upgrade_term.end_date

問題？：

もしライセンスに関する問題に遭遇した場合には、 ［wrapper.license.debug］ プロパティを「TRUE」に設定して、 インクルード・ファイル（カスケード形式）のデバッグを有効にしてください。 併用することで、ほとんどのコンフィギュレーション問題が明らかになります。

サーバー・ライセンスキーは、コンフィギュレーション・ファイル 「wrapper.conf」や コンフィギュレーション・ファイルのカスケード を使って参照する他のコンフィギュレーション・ファイルの中に直接に配置されるプロパティのセットで構成されています。 ライセンスキーは、ライセンスキーの中で指定されたホストIDから判断し、特定のサーバーに制限されます。

与えられたサーバーのホストIDは、シェル内部から、あるいは、コマンドプロンプトから、 ［-h］パラメーターを使い、Wrapperバイナリ を起動することで入手できます。 これにより、以下のような出力が得られます。

Java Service Wrapper Professional Edition nn-bit n.n.n
  Copyright (C) 1999-2009 Tanuki Software, Ltd.  All Rights Reserved.
    http://wrapper.tanukisoftware.org

A license can be obtained from the Java Service Wrapper site:
  http://wrapper.tanukisoftware.org/doc/japanese/purchase.html

Licenses can be generated for any of the following Host Ids.
The first Host Id is recommended.
  Host Ids:
    00123456789a (#1)

Optional host name for license: myhost

Java Service Wrapper Professional Edition nn-bit n.n.n
  Copyright (C) 1999-2009 Tanuki Software, Ltd.  All Rights Reserved.
    http://wrapper.tanukisoftware.org

A license can be obtained from the Java Service Wrapper site:
  http://wrapper.tanukisoftware.org/doc/japanese/purchase.html

Licenses can be generated for any of the following Host Ids.
The first Host Id is recommended.
  Host Ids:
    00123456789a (eth0:avahi)
    00123456789b (eth1)

表示されるホストIDのどれも、ライセンスキーを生成するために利用されます。

wrapper.license.type=NODE
wrapper.license.id=200804010006
wrapper.license.licensee=Acme, Inc.
wrapper.license.host_id=00123456789a
wrapper.license.features=pro, 64bit
wrapper.license.upgrade_term.begin_date=2008-04-01
wrapper.license.upgrade_term.end_date=2009-04-01
wrapper.license.key.1=0222-2e8a-6f6d-4a4a
wrapper.license.key.2=007d-7e3c-5e2a-427e
wrapper.license.key.3=ce16-f5f0-59f4-d18a
wrapper.license.key.4=b6ca-c31a-6be8-323d

• ［.type（タイプ）］は、サーバー・ライセンスキーのため、常に「ノード（NODE）」です。

• ［.id（ID）］は、ライセンスキーを固有に識別するために使われ、 ライセンス管理ページで、確認することができます。

• ［.licensee（ライセンス保有者）］は、Wrapperが起動するといつでも、 Wrapperログファイルやコンソールに表示されます。 上記のライセンスキーのケースでは、Wrapper出力は以下のようになります：

  Java Service Wrapper Professional Edition nn-bit n.n.n Copyright (C) 1999-2009 Tanuki Software, Ltd. All Rights Reserved. http://wrapper.tanukisoftware.org Licensed to Acme, Inc.

• ［.host_id（ホストID）］は、Wrapperが動作している単一のサーバーを特定し、利用の有効化の承認に利用されます。

• ［.features（機能）］は、承認されたWrapperのエディションを表示するために利用されます。 この例では、「64ビットのプロフェッショナル版」の利用が承認されています。 これは同時に、その下位である「32ビットのスタンダード版」も利用が可能です。

• ［.upgrade_term.begin_date（アップグレード有効期間の開始日）］ ［.upgrade_term.end_date（アップグレード有効期間の終了日）］ は、ライセンスキーで承認されたWrapperのリリース日により決まります。 上記のライセンスの例では、2009-04-01より以前にリリースされたWrapperバージョンの利用が可能です。 指定されたアップグレード有効期間内にリリースされたバージョンへ、アップグレードすることが認められており、 そのアップグレード有効期間の最終日を過ぎても、継続的に利用することができます。

• トライアル ライセンスキーには、リース期間のオプションが表示される場合もあります。 Wrapperの運用が認められている期間を限定します。 一旦、リース期間が切れると、Wrapperは、もはや起動しません。

• ［.key.1-4（４つのキー）］は、ライセンス・プロパティの残りを有効化するために使われます。

ライセンスキー・プロパティ名の中に、ホスト名を含んでいる単一のファイルの中に、 複数のサーバーのライセンスキーを含めることも可能です。 下記の例では、ホスト名「myhost」が提供されたライセンスキーを示しています。 ライセンスキーを再発行せずに、ライセンスキー・プロパティのホスト名の一部を変更することが可能です。

wrapper.myhost.license.type=NODE
wrapper.myhost.license.id=200804010006
wrapper.myhost.license.licensee=Acme, Inc.
wrapper.myhost.license.host_id=00123456789a
wrapper.myhost.license.features=pro, 64bit
wrapper.myhost.license.upgrade_term.begin_date=2008-04-01
wrapper.myhost.license.upgrade_term.end_date=2009-04-01
wrapper.myhost.license.key.1=0222-2e8a-6f6d-4a4a
wrapper.myhost.license.key.2=007d-7e3c-5e2a-427e
wrapper.myhost.license.key.3=ce16-f5f0-59f4-d18a
wrapper.myhost.license.key.4=b6ca-c31a-6be8-323d

代わりに、Wrapperバージョン3.3.2を利用して、 ライセンスキー・プロパティ名の内部で、複数のhost_id自体を利用することも可能です。 つまり、１台の単一のホストのために、１つのキー以上を定義することも可能になります。 これは必要とされる一例をあげると、現在有効な固有の物理カード次第で、ホストIDを変更したいところで、 バランス化されたネットワーク・カードのロードを使うシステムです。

wrapper.00123456789a.license.type=NODE
wrapper.00123456789a.license.id=200804010006
wrapper.00123456789a.license.licensee=Acme, Inc.
wrapper.00123456789a.license.host_id=00123456789a
wrapper.00123456789a.license.features=pro, 64bit
wrapper.00123456789a.license.upgrade_term.begin_date=2008-04-01
wrapper.00123456789a.license.upgrade_term.end_date=2009-04-01
wrapper.00123456789a.license.key.1=0222-2e8a-6f6d-4a4a
wrapper.00123456789a.license.key.2=007d-7e3c-5e2a-427e
wrapper.00123456789a.license.key.3=ce16-f5f0-59f4-d18a
wrapper.00123456789a.license.key.4=b6ca-c31a-6be8-323d

開発ライセンスキーは、コンフィギュレーション・ファイル 「wrapper.conf」や コンフィギュレーション・ファイルのカスケード を使って参照する他のコンフィギュレーション・ファイルの中に 直接に配置されるプロパティのセットで構成されています。 ライセンスキーは、アプリケーションのメイン・クラスの値を使い、特定のアプリケーションに制限されます。

アプリケーションのメイン・クラスは、 ［wrapper.java.mainclass］ プロパティを使って指定されます。 もし、メイン・クラスがWrapper とともに含まれるヘルパークラス （［org.tanukisoftware.wrapper.WrapperSimpleApp］ あるいは ［org.tanukisoftware.wrapper.WrapperStartStopApp］） の１つなら、 ［wrapper.app.parameter.1］ プロパティを使って、メイン・クラスが指定されます。 どちらのケースでも、もしメイン・クラスが変更されずに残っている場合、ライセンスがWrapperを唯一、承認されます。

wrapper.license.type=DEV
wrapper.license.id=200804010003
wrapper.license.licensee=Acme, Inc.
wrapper.license.dev_application=Acme Control Server
wrapper.license.features=pro, 64bit
wrapper.license.upgrade_term.begin_date=2008-04-01
wrapper.license.upgrade_term.end_date=2009-04-01
wrapper.license.key.1=a0a5-b478-ca71-8d59
wrapper.license.key.2=9296-6f2d-0e58-75e6
wrapper.license.key.3=0f5d-2cf2-ad36-54f9
wrapper.license.key.4=b859-dc75-61d7-b0ca

• ［.type（タイプ）］は、 開発ライセンスキーのため、常に「DEV」です。

• ［.id（ID）］は、ライセンスキーを固有に識別するために使われ、 ライセンス管理ページで、確認することができます。

• ［.licensee（ライセンス保有者）］や［.dev_application（開発アプリケーション）］の値は、Wrapperが起動するといつでも、 Wrapperログファイルやコンソールに表示されます。 上記のライセンスキーのケースでは、Wrapper出力は以下のようになります：

  Java Service Wrapper Professional Edition nn-bit n.n.n Copyright (C) 1999-2009 Tanuki Software, Ltd. All Rights Reserved. http://wrapper.tanukisoftware.org Licensed to Acme, Inc. for Acme Control Server

• ［.features（機能）］は、承認されたWrapperのエディションを表示するために利用されます。 この例では、「64ビットのプロフェッショナル版」の利用が承認されています。 これは同時に、その下位である「32ビットのスタンダード版」も利用が可能です。

• ［.upgrade_term.begin_date（アップグレード有効期間の開始日）］ ［.upgrade_term.end_date（アップグレード有効期間の終了日）］ は、ライセンスキーで承認されたWrapperのリリース日により決まります。 上記のライセンスの例では、2009-04-01より以前にリリースされたWrapperバージョンの利用が可能です。 指定されたアップグレード有効期間内にリリースされたバージョンへ、アップグレードすることが認められており、 そのアップグレード有効期間の最終日を過ぎても、継続的に利用することができます。

• トライアル ライセンスキーには、リース期間のオプションが表示される場合もあります。 Wrapperの運用が認められている期間を限定します。 一旦、リース期間が切れると、Wrapperは、もはや起動しません。

• ［.key.1-4（４つのキー）］は、ライセンス・プロパティの残りを有効化するために使われます

  Wrapperバージョン3.3.6から、５番目のキー値が追加され、 アップグレード期間を難読化することも可能になりました。 これは、Wrapperアップグレード期間の表示を隠すことで、 ソフトウェア・ベンダーの顧客への混乱を避けるために便利です。 同時に、ライセンスキーのアップグレード期間が難読化されるため、 顧客先の各自でWrapperをアップグレードしているユーザーのサポートも困難にもなりますのでご了承ください。 アップグレード期間よりも新しいWrapperバイナリを動作させると、 エラーメッセージにアップグレード期間の終了日が含まれますが、 これは小さな問題です。

  新しいライセンスキーを取得するとき、またはライセンスキーが存在しているとき、 難読化されたアップグレード期間情報にアクセスすることができます。

wrapper.license.type=DEV
wrapper.license.id=200804010003
wrapper.license.licensee=Acme, Inc.
wrapper.license.dev_application=Acme Control Server
wrapper.license.features=pro, 64bit
wrapper.license.key.0=ada5-ac8d-6f2d-54f9
wrapper.license.key.1=a0a5-b478-ca71-8d59
wrapper.license.key.2=5296-6d2d-0e58-79e6
wrapper.license.key.3=6f5d-acf2-3d36-64f9
wrapper.license.key.4=c859-dcf5-61d7-b8ca