デルタパックの概要

デルタパックは、Wrapper がサポートされているすべてのプラットフォーム（注）で作動できるためのバイナリやライブラリをバンドルしています。 Wrapper を起動させる Windows bat ファイルと Unix シェルスクリプトも含みます。 そのスクリプトを使用することで自動的に現在のプラットフォームに最適なバイナリを選択するので、Wrapper を起動することが容易になります。 つまり、異なる UNIX プラットフォームで同じコマンドを使用して（Windows では個別の bat スクリプトファイルを使用）透過的な方法で Wrapper を起動できます。

1つの設定ファイルで、異なるオペレーティングシステムで Java アプリケーションをコンソールアプリケーションや Windows サービス／UNIX デーモンとして実行できるよう Wrapper を設定出来ます。 必要に応じて、いつでもプラットフォーム固有のコンフィギュレーションも設定可能です。

すべてのプラットフォームのバイナリを含む単一の大型配布パッケージを作成することで、 ユーザーが必要なものがわからない場合でも、簡単に起動して実行できるようになります。 生成されるファイルは明らかに大きくなりますが、ユーザーが必要とする可能性のあるものだけが 含まれるようにファイルを自由に切り詰めることができます。 ファイル抽出後にスクリプトを実行して、現在のプラットフォームに必要のないファイルを削除することもできます。

アプリケーションをプラットフォーム固有のバンドルで配布する場合でも、デルタパックの構造では、 32 ビットと 64 ビットの両方のネイティブファイルを 1つの配布に含める事が出来るので便利です。 これだけでも非常に有用であり、ユーザーが OS と Java のインストール環境の特定の組み合わせに応じて必要なものを個別に探る必要がなくなります。

デルタパックは、Wrapper ver. 3.2.0 以降の全てのエディションで提供しております。

注意

（注）z/OS プラットフォームでは、ASCII 互換でない、EBCDIC キャラクター（文字）セットを利用します。 そのため、もし z/OS 版をダウンロードして他のシステムで閲覧すると、全てのファイルが破損しているように見えますが、 これは正常なことです。この理由により、z/OS プラットフォームは、あえてデルタパック配布版に含めてありません。

デルタパックのダウンロード

デルタパックのダウンロードリンクは、ダウンロードページの全てのプラットフォームの下でにあります。

デルタパックは、Windows 用のインストーラーと、「.tar.gz」形式または「.zip」形式で提供されます。 内容は同じですが、ファイルを抽出する方法によっては、どちらかの形式が選べられます。

ご希望のエディションを選択してください：プロフェッショナル版、スタンダード版、コミュニティ版

パッケージをダウンロードした後、ファイルを抽出してください。

構造

バイナリ

全てのサポートされているプラットフォームのライブラリは、「lib」フォルダーに入っています。

各プラットフォームのバイナリと、Wrapper を起動するときに使用するスクリプトも「bin」フォルダーに入っています。

各プラットフォーム用に、提供している32 ビット 版と 64 ビット版のライブラリとバイナリが入っています。

設定

設定ファイルは、「conf」フォルダーに入っています。通常、ライセンスキーファイルもこのフォルダーにあります。

ライセンシング

スタンダード版とプロフェッショナル版では、Wrapper を作動するには有効なライセンスが必要です。 ライセンスキーファイルを別ファイルとして設定ファイルと同じフォルダーに 保存することをお勧めします（必須ではありません）。

開発ライセンスを購入した場合、 必要なライセンスキーは1つだけです。これは、アプリケーションに関連付けられており、任意のプラットフォームで実行できます。 この種類のライセンスは、本質的に、デルタパックと最もよく一致します。

サーバーライセンスキーは一つのマシンのみで利用が出来ますが、 ライセンスキープロパティ名にホスト名、或いはHostIdを含めると 複数のサーバー用のライセンスキーを一つのファイルでまとめることが出来ます。

設定例： 
# license for hostid 00123456789a
wrapper.00123456789a.license.type=NODE
wrapper.00123456789a.license.id=201804010006
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=2018-04-01
wrapper.00123456789a.license.upgrade_term.end_date=2019-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

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

注意

ライセンスキーを再生成せずに、ライセンスキープロパティのホスト名部分を変更することができます。 新しいプラットフォームに Wrapper を展開する必要があるときはいつでも、既存のキーを編集せずに、ライセンスキーファイルに新しいキーを追加するだけです。

Windows または Unix システムでデルタパックを起動すると、Wrapper はまず、ライセンスが対象とするアーキテクチャ（32 ビットまたは 64 ビット）を確認します。 これは、64 ビット OS で 32 ビットライセンスを使用して Wrapper を実行できるためです。 この場合、デルタパックは現在のプラットフォームの適切な 32 ビットバイナリを起動します。 もし、ご利用中のライセンスは 32 ビットと 64 ビットの両方の機能が有効になっている場合、 またはコミュニティエディション使用の場合は、OS ビットに一致するバイナリが使用されます。

配布

バイナリを選択する

デフォルトでは、デルタパックは、z/OS を除き、Wrapper がサポートするすべてのプラットフォームのバイナリとライブラリを揃えています。

ただし、不要なバイナリを削除し、お好みの圧縮ツールを使用して必要なファイルを再圧縮することも可能です。 これは、次の場合に役立ちます。

・　Java アプリケーションをデルタパックとともに Windows システムと UNIX システムに別々に配布することを選択した場合。

・　特定のプラットフォームまたはアーキテクチャに Wrapper をデプロイしないことがわかっている場合は、 パッケージを軽量化して転送を高速化できます。

・　32 ビットライセンスをお持ちの場合、全ての 64 ビットのバイナリは使用できないので削除できます。 Ver. 3.5.37 以降、Wrapper はライセンスの種類を検出し、正しいバイナリを起動できますが、 わかりやすくするために不要なバイナリを削除することをおすすめします。

Java Service Wrapper のサポートしているプラットフォームの詳細については、 サポートされているプラットフォームの概要.


バージョン 3.5.46 より、Windows システム上でデルタパック インストーラーでバイナリとライブラリの選択が簡単になりました。

クロスプラットフォーム構成

Wrapper の設定プロパティはクロスプラットフォーム仕様にデザインされていますので、ほとんどの場合には一つの設定ファイルとプロパティの単一のセットだけが必要です。 ただし、これをスムーズに処理し、プラットフォーム固有の構成が必要な場合には、いくつかの優れた方法があります。

まず、デルタパックを Windows と Linux の両方展開する場合は、コンフィギュレーションに含まれるすべてのパスがバックスラッシュ「\」ではなく スラッシュ「/」を使用していることを確認してください。 バックスラッシュは Windows でのみサポートされています。

アプリケーションを多言語化（ローカライズ）する場合は、プラットフォームに応じて異なるロケール表記と エンコーディングを使用する必要がある場合があります。 ［wrapper.lang］プロパティの場合、Windows 表記（「English_United States」、「Japanese_Japan」など）の代わりに UNIX 表記（「ja_JP」や「en_US」など）を使用することをお勧めします。 UNIX 表記は Windows でも機能しますが、Windows 表記は UNIX システムでは機能しません。 （wrapper.lang.encoding によって制御される）エンコーディングには、Windows を含むすべてのプラットフォームで一般的にサポートされている「UTF-8」を使用できます。 プラットフォームごとに異なるエンコーディングを使用する必要がある場合は、［wrapper.lang.<platform>.encoding］プロパティの使用を検討してください。

次のコンフィギュレーションプロパティでは、プラットフォームごとに値を設定することもできます。

もう１つの便利な手法は、ルート設定ファイルにすべての一般的な構成を収集し、プラットフォーム固有の 構成を個別のインクルードファイルに書き込むことです。

［WRAPPER_OS］、［WRAPPER_ARCH］、［WRAPPER_BITS］の環境変数を使用して、 メイン設定ファイルからインクルードファイルを参照できます。 

@include ../conf/wrapper-%WRAPPER_OS%-%WRAPPER_ARCH%.conf

ファイル名または親フォルダー名で環境変数を使用できます。

次に、特定の構成が必要なプラットフォームごとに設定ファイルを作成する必要があります。 ファイル名が、ターゲットとするプラットフォームで環境変数が取る値で作成されていることを確認してください。 インクルード設定ファイルが見つからない場合は、サイレントにスキップされます。

アプリケーションで他のネイティブライブラリを使用する場合は、現在のプラットフォームに適したライブラリを含めるように コンフィギュレーションを設定する必要があります。 これは、［wrapper.java.library.path.<n>］プロパティページで説明されています。

サポート

その他ご質問があれば、遠慮なく support@tanukisoftware.com までご連絡ください。喜んで対応させていただきます。 こちらの機能や別機能についてのフィードバックを是非聞かせてください。