Delta-Pack-Übersicht

Das Delta Pack bündelt die Binärdateien und Bibliotheken, die der Wrapper benötigt, um auf allen unterstützten Plattformen* zu laufen. Es enthält außerdem die Windows-BAT-Dateien und das Unix-Shell-Skript, mit denen der Wrapper gestartet wird. Die Verwendung dieser Skripte erleichtert den Start des Wrappers, da sie automatisch die passenden Binärdateien für die aktuelle Plattform auswählen. Mit anderen Worten: Sie ermöglichen es, den Wrapper transparent zu starten, indem auf den verschiedenen UNIX-Plattformen dieselben Befehle verwendet werden (unter Windows mit separaten BAT-Skriptdateien).

Mit einer einzigen Konfigurationsdatei können Sie den Wrapper so konfigurieren, dass Ihre Java-Anwendung entweder als Konsolenanwendung oder als Windows-Dienst/Unix-Daemon auf den verschiedenen Betriebssystemen ausgeführt wird. Es ist auch möglich, bei Bedarf eine plattformspezifische Konfiguration zu verwenden.

Eine einzige große Distribution mit den Binärdateien aller Plattformen kann es Ihren Benutzern erheblich erleichtern, loszulegen, wenn sie unsicher sind, was sie benötigen. Die resultierende Datei ist natürlich groß, aber Sie können sie nach Belieben so zurechtschneiden, dass nur das enthalten ist, was Ihre Benutzer voraussichtlich benötigen. Es ist auch möglich, nach dem Entpacken ein Skript auszuführen, um alle Dateien zu löschen, die für die aktuelle Plattform nicht benötigt werden.

Auch wenn Sie Ihre Anwendung in plattformspezifischen Paketen verteilen möchten, kann die Delta-Pack-Struktur nützlich sein, um sowohl 32- als auch 64-Bit-Native-Dateien in einer einzigen Distribution unterzubringen. Allein dies ist sehr hilfreich, damit Ihre Benutzer nicht selbst herausfinden müssen, welche Bit-Version für ihre spezielle Kombination aus Betriebssystem und Java-Installation benötigt wird.

Das Delta Pack ist in allen Editionen ab Version 3.2.0 verfügbar.

NOTE

* Die z/OS-Plattform verwendet den EBCDIC-Zeichensatz, der nicht ASCII-kompatibel ist. Wenn Sie die z/OS-Distribution herunterladen und auf anderen Systemen anzeigen, erscheinen alle Dateien beschädigt. Das ist normal. Aus diesem Grund ist die z/OS-Plattform absichtlich nicht in den Delta-Pack-Distributionen enthalten.

Herunterladen des Delta Packs

Die Links zum Herunterladen des Delta Packs finden Sie auf der Download-Seite unter den Links für die verschiedenen Plattformen.

Das Delta Pack verfügt über ein .exe-Installationsprogramm für Windows und wird außerdem in den Formaten .tar.gz und .zip angeboten. Der Inhalt ist derselbe, aber je nach Ihrer Methode zum Entpacken der Dateien bevorzugen Sie möglicherweise das eine oder das andere Format.

Bitte wählen Sie die gewünschte Edition: Professional, Standard oder Community.

Sobald Ihr Paket heruntergeladen ist, entpacken Sie es bitte.

Struktur

Binärdateien

Die Bibliotheken aller unterstützten Plattformen finden Sie im lib-Ordner.

Die Binärdateien für die verschiedenen Plattformen und die Skripte zum Starten des Wrappers finden Sie im bin-Ordner.

Für jede Plattform sind sowohl die 32-Bit- als auch die 64-Bit-Versionen der angebotenen Bibliotheken und Binärdateien enthalten.

Konfiguration

Die Konfigurationsdatei finden Sie im conf-Ordner. In der Regel befindet sich auch die Lizenzschlüsseldatei in diesem Ordner.

Lizenzierung

Für die Standard- und Professional-Editionen benötigt der Wrapper eine gültige Lizenz, um ausgeführt zu werden. Es wird empfohlen (ist aber nicht erforderlich), den Lizenzschlüssel in einer separaten Datei im selben Ordner wie Ihre Konfigurationsdatei abzulegen.

Wenn Sie eine Development-Lizenz erwerben, benötigen Sie nur einen Lizenzschlüssel, der an Ihre Java-Anwendung gebunden ist und deren Ausführung auf beliebigen Plattformen erlaubt. Diese Art von Lizenz passt naturgemäß am besten zum Delta Pack.

Ein Server-Lizenzschlüssel kann nur auf einem einzelnen Rechner verwendet werden. Wenn Sie den Wrapper jedoch auf mehreren Servern mit unterschiedlichen Plattformen einsetzen möchten, können Sie die Lizenzschlüssel für die verschiedenen Server in einer einzigen Datei zusammenfassen, indem Sie die Hostnamen oder HostIds in die Eigenschaftsnamen der Lizenzschlüssel aufnehmen.

Beispiel:
# 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=2027-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=2027-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

NOTE

Es ist möglich, den Hostnamen-Anteil der Lizenzschlüssel-Eigenschaften zu ändern, ohne den Schlüssel neu zu generieren. Wenn Sie den Wrapper auf einem neuen Rechner bereitstellen müssen, können Sie einfach einen neuen Schlüssel zu Ihrer Lizenzschlüsseldatei hinzufügen, ohne die vorhandenen Schlüssel zu bearbeiten.

Wenn das Delta Pack unter Windows oder auf einem Unix-System gestartet wird, prüft der Wrapper zunächst, welche Architektur Ihre Lizenz anspricht (32-Bit oder 64-Bit). Dies geschieht, weil es möglich ist, den Wrapper mit einer 32-Bit-Lizenz auf einem 64-Bit-Betriebssystem auszuführen. In diesem Fall startet das Delta Pack die entsprechende 32-Bit-Binärdatei der aktuellen Plattform. Wenn Ihre Lizenz sowohl 32-Bit- als auch 64-Bit-Features aktiviert hat oder wenn Sie die Community-Edition verwenden, werden die Binärdateien verwendet, die der Bitzahl Ihres Betriebssystems entsprechen.

Verteilung

Auswahl der Binärdateien

Standardmäßig enthält das Delta Pack die Binärdateien und Bibliotheken für alle Plattformen, die der Wrapper unterstützt (außer z/OS).

Möglicherweise möchten Sie jedoch die nicht benötigten Binärdateien entfernen und die erforderlichen Dateien mit Ihrem bevorzugten Komprimierungstool neu packen. Dies kann in den folgenden Situationen nützlich sein:

- Wenn Sie Ihre Java-Anwendung mit dem Delta Pack getrennt für Windows- und UNIX-Systeme verteilen möchten.

- Wenn Sie wissen, dass Sie den Wrapper nicht auf bestimmten Plattformen oder Architekturen bereitstellen werden, kann dies sinnvoll sein, um Ihr Paket kleiner und damit schneller übertragbar zu machen.

- Wenn Sie eine 32-Bit-Lizenz besitzen, können Sie alle 64-Bit-Binärdateien entfernen, da sie nicht verwendet werden können. Seit Version 3.5.37 kann der Wrapper den Lizenztyp erkennen und die richtigen Binärdateien starten, aber das Löschen der unnötigen Dateien wird aus Gründen der Übersichtlichkeit dennoch empfohlen.

Wenn Sie mehr über die vom Java Service Wrapper unterstützten Plattformen erfahren möchten, besuchen Sie bitte Übersicht der unterstützten Plattformen.


Seit Version 3.5.46 wird die Auswahl der Binärdateien und Bibliotheken durch das Delta-Pack-Installationsprogramm auf Windows-Systemen erleichtert.

Plattformübergreifende Konfiguration

Die Konfigurationseigenschaften des Wrappers sind plattformübergreifend ausgelegt. Das bedeutet, dass Sie in den meisten Fällen nur eine einzige Konfigurationsdatei und einen einzigen Satz von Eigenschaften benötigen. Es gibt jedoch einige bewährte Vorgehensweisen, um dies reibungslos zu handhaben und für Fälle, in denen Sie eine plattformspezifische Konfiguration benötigen.

Wenn Sie Ihr Delta Pack sowohl unter Windows als auch unter Linux bereitstellen, stellen Sie zunächst sicher, dass alle in Ihrer Konfiguration enthaltenen Pfade Schrägstriche '/' und keine Backslashes '\' verwenden. Backslashes werden nur unter Windows unterstützt.

Wenn Sie Ihre Anwendung lokalisieren möchten, müssen Sie möglicherweise je nach Plattform unterschiedliche Locale-Notationen und Kodierungen verwenden. Für die Eigenschaft wrapper.lang wird empfohlen, die UNIX-Notationen (z. B. 'ja_JP' oder 'en_US') anstelle der Windows-Notationen (z. B. 'English_United States', 'Japanese_Japan') zu verwenden. UNIX-Notationen funktionieren auch unter Windows, Windows-Notationen funktionieren jedoch nicht auf UNIX-Systemen. Für die Kodierungen (gesteuert durch wrapper.lang.encoding) können Sie 'UTF-8' verwenden, das im Allgemeinen auf allen Plattformen einschließlich Windows unterstützt wird. Wenn Sie plattformabhängig unterschiedliche Kodierungen verwenden müssen, ziehen Sie bitte die Eigenschaften wrapper.lang.<platform>.encoding in Betracht.

Die folgenden Konfigurationseigenschaften ermöglichen es Ihnen ebenfalls, einen Wert pro Plattform festzulegen:

Eine weitere nützliche Technik besteht darin, die gesamte gemeinsame Konfiguration in der Stammkonfigurationsdatei zusammenzufassen und die plattformspezifische Konfiguration in separate Include-Dateien zu schreiben.

Sie können die folgenden Umgebungsvariablen verwenden, um Ihre Include-Dateien aus Ihrer Hauptkonfigurationsdatei zu referenzieren: WRAPPER_OS, WRAPPER_ARCH, WRAPPER_BITS.

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

Sie können Umgebungsvariablen entweder im Dateinamen oder im Namen eines übergeordneten Ordners verwenden.

Anschließend müssen Sie für jede Plattform, für die Sie eine spezifische Konfiguration benötigen, eine Konfigurationsdatei erstellen. Stellen Sie lediglich sicher, dass die Dateinamen mit den Werten aufgebaut sind, die die Umgebungsvariablen auf der Zielplattform annehmen. Wenn eine Include-Konfigurationsdatei nicht gefunden wird, wird sie stillschweigend übersprungen.

Wenn Ihre Anwendung andere native Bibliotheken verwendet, müssen Sie die Konfiguration so einrichten, dass die richtigen Bibliotheken für die aktuelle Plattform einbezogen werden. Dies wird auf der Eigenschaftsseite wrapper.java.library.path.<n> erläutert.

Support

Wenn Sie Fragen haben, kontaktieren Sie uns gerne mit einer Support-Anfrage unter support@tanukisoftware.com. Wir helfen Ihnen gerne weiter. Wir sind auch an Ihrem Feedback und Ihren Kommentaren zu diesem und/oder anderen Features interessiert.