Wrapper は非常に柔軟性に富んでおり、いかなるディレクトリー構造においても動作するように設定することができます。 この例のように、やや複雑なアプリケーションにおいても、 再利用できるようなシンプルなディレクトリー構造にすることをおススメします。 自分で選択した任意のディレクトリー下に、次のディレクトリー構造を再形成してください。 これをルートディレクトリーを「$(EXAMPLE_HOME) と呼びます。 これは、HelloWorldServer 概要で説明しているディレクトリー構造の拡大版です。

$(EXAMPLE_HOME)/
$(EXAMPLE_HOME)/bin/
$(EXAMPLE_HOME)/conf/
$(EXAMPLE_HOME)/lang/
$(EXAMPLE_HOME)/lib/
$(EXAMPLE_HOME)/lib/classes/
$(EXAMPLE_HOME)/logs/

ダウンロードページから、 ご自分の利用しているOSに対応する Java Service Wrapper の最新版をダウンロードし、ダウンロードした圧縮ファイルを任意のディレクトリーに解凍してください。ここでは、解凍先ディレクトリーを $(WRAPPER_HOME)と呼びます。

Java Service Wrapper は UNIX 上で４つの主要なコンポーネントで成り立っています： Wrapper バイナリ、jar ファイル、jarファイルで使われるネイティブライブラリー、および Wrapper を起動し、デーモンとして制御するなどのアクションを実行するために使用されるシェルスクリプトです。 以下のように、そのファイルをコピーしてください：

cp $(WRAPPER_HOME)/bin/wrapper $(EXAMPLE_HOME)/bin/wrapper
cp $(WRAPPER_HOME)/lib/wrapper.jar $(EXAMPLE_HOME)/lib/wrapper.jar
cp $(WRAPPER_HOME)/lib/libwrapper.so $(EXAMPLE_HOME)/lib/libwrapper.so
cp $(WRAPPER_HOME)/src/bin/App.sh.in $(EXAMPLE_HOME)/bin/helloworldserver

その後、スクリプトファイルを実行可能にする必要があります：

chmod +x helloworldserver

ライセンスキー：

Java Service Wrapper のスタンダード版やプロフェッショナル版を動作させるためにライセンスキーが必要です。 Wrapper には、トライアルライセンス（15分間）のライセンスキーを同梱しています。 今、それもコピーしてください。 ページ上部にある「FREE TRIAL」ボタンをクリックして、長期間トライアルライセンスの申請をすることもできます。

cp $(WRAPPER_HOME)/src/conf/wrapper-license-time.conf $(EXAMPLE_HOME)/conf/wrapper-license.conf

Wrapper コンフィギュレーションファイル：

最後に、デフォルトの Wrapper コンフィギュレーションファイルをコピーします。 その設定ファイルの編集方法については、次のセクションで説明します。

cp $(WRAPPER_HOME)/src/conf/wrapper.conf.in $(EXAMPLE_HOME)/conf/wrapper.conf

「$(EXAMPLE_HOME)/conf/wrapper.conf」ファイルを「メモ帳」などのテキストエディタで開いてください。

以下の各プロパティを探して値を設定してください。

wrapper.java.command=java
wrapper.java.command.loglevel=INFO

wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperSimpleApp
wrapper.app.parameter.1=HelloWorldServer

wrapper.java.classpath.1=../lib/wrapper.jar
wrapper.java.classpath.2=../lib/classes

wrapper.java.library.path.1=../lib

wrapper.logfile=../logs/wrapper.log

• ［wrapper.java.command］プロパティで、利用する Java コマンドの配置場所を指定します。 ここで指定した値は、システムパス上に検索されます。 また、絶対パスを指定することも可能です。

• ［wrapper.java.command.loglevel］プロパティは任意設定ですが、Wrapper が生成する Java コマンドラインのデバッグに便利です。 最初の利用開始時には、何か問題が起きたときを考え、最短の解決に向けて、情報ログを含めることを推奨しますが、 一旦、アプリケーションが正しく動作するようになったら、このプロパティをコメントアウト（コメント記号で無効化）にすると良いでしょう。

• ［wrapper.java.mainclass］プロパティで、起動したときに Java へ引き渡すメインクラスを指定します。 これが、新しいユーザーにとって、混乱する点の１つですが、 ほとんどの場合、これは Java アプリケーションのメインクラスではなく、Wrapper のヘルパークラスの１つになるでしょう。 Wrapper では、いくつかのインテグレーション方法をサポートしていますが、 この例にあるように、ここでは一番シンプルな方法 「インテグレーション方法１「WrapperSimpleApp」ヘルパークラス」を利用します。 このヘルパークラス［org.tanukisoftware.wrapper.WrapperSimpleApp］で JVM ライフサイクルや Wrapper とのバックエンド通信を管理します。 現時点では、この点について心配する必要はありません。

• アプリケーション「HelloWorldServer」の実際のメインクラスは、［wrapper.app.parameter.1］プロパティを使って、最初のパラメータとして引き渡されます。 そのプロパティのナンバリングインデックスを使って、追加のパラメータとして「HelloWorldServer 」へ引き渡すことが可能です。 例えば、「wrapper.app.parameter.2=P1」です。

  ここでは示しませんが、［wrapper.java.additional.<n>］プロパティを使って、Java パラメータを追加することも可能です。

• 次のステップは クラスパスの指定です。 ［wrapper.java.classpath.<n>］プロパティを使って、クラスパスを指定します。 弊社のサンプルアプリケーションに２つのクラスパス指定が必要です。 １つ目は、Wrapper のヘルパークラスを含んでいる「wrapper.jar」ファイルで、 ２つ目は、HelloWorldServer クラスが配置されている「lib/classes ディレクトリ」を含んでいるファイルです。

• Wrapper では、いくつかの機能を実装するために、ネイティブライブラリー「libwrapper.so」を活用します。 多くのJavaアプリケーションでは、ネイティブライブラリーを利用しませんので、慣れていないかもしれませんが、［wrapper.java.library.path.<n>］プロパティでこれらのライブラリーが配置されている場所を指定します。 現時点では、この点について心配する必要はありません。

• ［wrapper.logfile］プロパティで、ログファイルを書き出す場所を指定します。

以上で、Java アプリケーションをどのように動作させるのか、Wrapper に指示を出しました。

全てのプロパティ値を設定する際に、１つ注意しなければならない大切なことは、 常に、「wrapper.exe」バイナリの配置場所へ 相対参照のパスで指定してください。

「$(EXAMPLE_HOME)/bin/helloworldserver」シェルスクリプトファイルを「メモ帳」などのテキストエディターで開いてください。

ファイルの先頭辺りに２つの変数があります：「APP_NAME」と「APP_LONG_NAME」です。値をアプリケーション名前に置き換えてください。

# Application
APP_NAME="helloworldserver"
APP_LONG_NAME="Hello World Server"

Wrapper をデーモンとして設定するのに便利な変数は他にもいくつかありますが、このチュートリアルでは後で説明します。