Wrapperにシェルスクリプト（sh）を同梱して提供しており、 それを使うことで、JavaアプリケーションをJava Service Wrapperでコントロールし、 確実に開始したり停止したりすることができます。

まず始めに、以下のファイルをHudsonの「bin」ディレクトリーにコピーしてください：

{WRAPPER_HOME}/bin/wrapper
{WRAPPER_HOME}/src/bin/sh.script.in

アプリケーション名を反映してスクリプト・ファイル名を変更します。

{HUDSON_HOME}/bin/hudson

次に、エディターで、そのスクリプトを開きます。 Hudsonを起動する際のスクリプトで表示が反映されるように、 ロング名やショート名を設定が必要です。スクリプトのヘッダーの直後に、 ２つの変数［APP_NAME］と［APP_LONG_NAME］が見えるでしょう。 この変数の推奨された値は次のとおりです。

APP_NAME="hudson"
APP_LONG_NAME="Hudson Integration Engine"

このスクリプトは、何も設定変更を必要としませんが、コンフィギュレーション・ファイル 「wrapper.conf」が 「conf」ディレクトリーにあるという前提で進めていきます。 もし、その「wrapper.conf」ファイルを他の場所に設置したい場合には、 そのスクリプト内の［WRAPPER_CONF］変数を変更する必要があります。

以下の２つのファイルをHudsonの「lib」ディレクトリーにコピーしてください：

{WRAPPER_HOME}/lib/libwrapper.so
{WRAPPER_HOME}/lib/wrapper.jar

「libwrapper.so」ファイルは、 ネイティブ・ライブラリー・ファイルであり、 JVM内で動作するWrapperの一部として必要なものです。 「wrapper.jar」ファイルには、全てのWrapperクラスが含まれています。

Wrapperでは各アプリケーション用の設定ファイル（コンフィギュレーション・ファイル 「wrapper.conf」）が必要です。 その設定ファイルの標準配置ディレクトリーは、 アプリケーション・ホーム・ディレクトリー下の「conf」ディレクトリーです。 以下の設定ファイル・テンプレート「wrapper.conf.in」を Hudsonの「conf」ディレクトリーにコピーしてください：

{WRAPPER_HOME}/src/conf/wrapper.conf.in

次のようにファイル名を変更します。 拡張子「.in」を外して、 ファイル名を「wrapper.conf」へ変更します。

以下のようになるはずです：

{HUDSON_HOME}/conf/wrapper.conf

もしコンフィギュレーション・ファイル「wrapper.conf」 の配置場所を変更したい場合には、自由に変更して構いませんが、新しい場所が反映されるように、 上記の「bin」ディレクトリーの中に コピーしたスクリプトを変更する必要があります。

コンフィギュレーション・ファイル 「wrapper.conf」 のデフォルトでは、アプリケーション・ホーム・ディレクトリー下にある 「logs」ディレクトリーの中に 「wrapper.log」ファイルを配置します。

以下のようになるはずです：

{HUDSON_HOME}/logs

もし「wrapper.log」ファイルを他の場所に配置したい場合には、 「wrapper.conf」ファイルを編集して、新しい場所が反映されるように ［wrapper.logfile］ プロパティを変更する必要があります。

まず、Java実行ファイルを解凍して、その配置場所のパスを ［wrapper.java.command］ プロパティにへ割り当てます：

wrapper.java.command=java

次にクラスパスです。 ［wrapper.java.classpath.<n>］ プロパティを使って設定を変更します。 本来Javaでは、［-jar］パラメータを使って動作する際に、クラスパスを指定することは認められませんが、 このWrapperインテグレーションでは少し異なった手法になります。 Wrapperでは、その「wrapper.jar」ファイルをクラスパスの中に指定する必要があります：

wrapper.java.classpath.1=/usr/lib/hudson/lib/wrapper.jar

Wrapper や ［WrapperJarApp］ヘルパークラスを使う際に、 Javaは「jar」ファイルを直接的に実行しません。 アプリケーションのメイン・クラスとして、ヘルパークラスを指定する必要があります。 起動時にJavaによって実行されるこのメイン・クラスは、 ［wrapper.java.mainclass］ プロパティを使って指定します。

wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperJarApp

アプリケーション・パラメータは、 ［wrapper.app-parameter.<n>］ プロパティを使って設定します。 ここでのケースでは、 Hudsonを起動させるコマンドラインは、 アプリケーション・パラメータを何も指定していませんが、 ［WrapperJarApp］ヘルパークラスに、どの「jar」ファイルを実行させるのか伝える必要があります。 下記のように設定します：

wrapper.app.parameter.1=/usr/lib/hudson/lib/hudson.war

Wrapperを使うために、設定しなければならないプロパティがもう一つあります。 システムとの対話をコントロールするため、Wrapperは、ネイティブ・ライブラリーを利用します。 このライブラリー・ファイル 「libwrapper.so」は、 JVMへ供給されるライブラリーパスで指定しておく必要があります。

Hudson では、ネイティブ・ライブラリーを一切持ちません、 仮にあったとしても、 それがどこに位置するのかライブラリーの 配置場所（ディレクトリー）を指定しておく必要があるでしょう。 ライブラリーパスは、 ［wrapper.java-library-path.<n>］ プロパティを使って設定します。

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

全部をまとめると、下記のようになります：

wrapper.java.command=java

wrapper.java.classpath.1=/usr/lib/hudson/lib/wrapper.jar

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

wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperJarApp

wrapper.app.parameter.1=/usr/lib/hudson/lib/hudson.war

これらの設定をしたマシンが正常に動作していることからも分かるように、 ディレクトリー構造やプラットフォームに非常に高く依存しています。 Wrapperのスクリプトにより常にそのスクリプトの位置を カレント・ディレクトリーとして設定するという仕組みの利点を生かし、 また、一つの環境変数を利用することで、上記のプロパティを変更することができるので、 完全にプラットフォームやマシンが依存しない独立型の状態となりえるのです：

wrapper.java.command=%JAVA_HOME%/bin/java

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

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

wrapper.java.mainclass=org.tanukisoftware.wrapper.WrapperJarApp

wrapper.app.parameter.1=../lib/hudson.war