Présentation du Delta Pack

Le Delta Pack regroupe les binaires et bibliothèques nécessaires au Wrapper pour fonctionner sur toutes les plateformes prises en charge*. Il contient également les fichiers bat Windows et le script shell Unix utilisés pour lancer le Wrapper. L'utilisation de ces scripts facilite le lancement du Wrapper, car ils sélectionnent automatiquement les binaires appropriés pour la plateforme actuelle. En d'autres termes, ils vous permettent de lancer le Wrapper de manière transparente, en utilisant les mêmes commandes sur les différentes plateformes UNIX (Windows utilisant des fichiers de script bat distincts).

Avec un seul fichier de configuration, vous pourrez configurer le Wrapper pour exécuter votre application Java soit en tant qu'application console, soit en tant que service Windows/démon Unix sur les différents systèmes d'exploitation. Il est également possible d'avoir une configuration spécifique à une plateforme lorsque le besoin s'en fait sentir.

Créer une distribution unique volumineuse contenant les binaires de toutes les plateformes peut grandement faciliter la mise en route pour vos utilisateurs lorsqu'ils ne savent pas exactement ce dont ils ont besoin. Le fichier résultant est évidemment volumineux, mais vous êtes libre de le réduire pour n'inclure que ce dont vos utilisateurs sont susceptibles d'avoir besoin. Il est également possible d'exécuter un script après l'extraction pour supprimer tous les fichiers non nécessaires à la plateforme actuelle.

Même si vous souhaitez distribuer votre application dans des packages spécifiques à chaque plateforme, la structure du Delta Pack peut être utile pour inclure à la fois les fichiers natifs 32 bits et 64 bits dans une seule distribution. Cela est déjà très utile afin que vos utilisateurs n'aient pas à déterminer quels binaires sont nécessaires pour leur combinaison spécifique de système d'exploitation et d'installation Java.

Le Delta Pack est disponible dans toutes les éditions à partir de la version 3.2.0.

NOTE

* La plateforme z/OS utilise le jeu de caractères EBCDIC, qui n'est pas compatible ASCII. Si vous téléchargez la distribution z/OS et la consultez sur d'autres systèmes, tous ses fichiers sembleront corrompus. Ceci est normal. Pour cette raison, la plateforme z/OS n'est volontairement pas incluse dans les distributions du Delta Pack.

Téléchargement du Delta Pack

Les liens de téléchargement du Delta Pack se trouvent sur la page de téléchargement, sous les liens des différentes plateformes.

Le Delta Pack dispose d'un installeur .exe pour Windows et est également proposé aux formats .tar.gz et .zip. Le contenu est identique, mais vous pouvez préférer un format à l'autre, selon votre méthode d'extraction des fichiers.

Veuillez choisir l'édition souhaitée : Professional, Standard ou Community.

Une fois votre package téléchargé, veuillez l'extraire.

Structure

Binaires

Vous trouverez les bibliothèques de toutes les plateformes prises en charge dans le dossier lib.

Vous trouverez également les binaires des différentes plateformes ainsi que les scripts utilisés pour lancer le Wrapper dans le dossier bin.

Pour chaque plateforme, les versions 32 bits et 64 bits des bibliothèques et binaires proposés sont incluses.

Configuration

Vous trouverez le fichier de configuration dans le dossier conf. En général, le fichier de clé de licence se trouve également dans ce dossier.

Licence

Pour les éditions Standard et Professional, le Wrapper nécessite une licence valide pour fonctionner. Il est recommandé (mais pas obligatoire) de placer la clé de licence dans un fichier distinct situé dans le même dossier que votre fichier de configuration.

Si vous achetez une licence Development, vous n'aurez besoin que d'une seule clé de licence, liée à votre application Java et permettant de l'exécuter sur n'importe quelle plateforme. Ce type de licence, de par sa nature, correspond le mieux au Delta Pack.

Une clé de licence Server ne peut être utilisée que sur une seule machine, mais si vous souhaitez utiliser le Wrapper sur plusieurs serveurs avec différentes plateformes, il est possible de regrouper les clés de licence des différents serveurs dans un seul fichier en incluant les noms d'hôte ou HostIds dans les noms des propriétés de clé de licence.

Exemple : 
# 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

Il est possible de modifier la partie nom d'hôte des propriétés de clé de licence sans régénérer la clé. Chaque fois que vous devez déployer le Wrapper sur une nouvelle machine, vous pouvez simplement ajouter une nouvelle clé à votre fichier de clés de licence sans modifier les clés existantes.

Lorsque le Delta Pack est lancé sous Windows ou sur un système Unix, le Wrapper vérifie d'abord quelle architecture cible votre licence (32 bits ou 64 bits). Cela est dû au fait qu'il est possible d'exécuter le Wrapper avec une licence 32 bits sur un système d'exploitation 64 bits. Dans ce cas, le Delta Pack lancera le binaire 32 bits approprié de la plateforme actuelle. Si votre licence a les fonctionnalités 32 bits et 64 bits activées, ou si vous utilisez l'édition Community, les binaires correspondant à l'architecture de votre système d'exploitation seront utilisés.

Distribution

Choix des binaires

Par défaut, le Delta Pack rassemble les binaires et bibliothèques de toutes les plateformes prises en charge par le Wrapper (sauf z/OS).

Cependant, vous pouvez souhaiter supprimer les binaires dont vous n'avez pas besoin et recompresser les fichiers nécessaires à l'aide de votre outil de compression préféré. Cela peut être utile dans les situations suivantes :

- Si vous choisissez de distribuer votre application Java avec le Delta Pack séparément pour les systèmes Windows et UNIX.

- Si vous savez que vous ne déploierez pas le Wrapper sur certaines plateformes ou architectures, cela peut permettre d'alléger votre package et ainsi d'accélérer son transfert.

- Si vous possédez une licence 32 bits, vous pouvez supprimer tous les binaires 64 bits puisqu'ils ne peuvent pas être utilisés. Depuis la version 3.5.37, le Wrapper peut détecter le type de licence et lancer les binaires corrects, mais il est toujours conseillé de supprimer ceux qui sont inutiles pour plus de clarté.

Si vous souhaitez en savoir plus sur les plateformes prises en charge par le Java Service Wrapper, veuillez consulter la page Présentation des plateformes prises en charge.


Depuis la version 3.5.46, la sélection des binaires et bibliothèques est facilitée grâce à l'installeur du Delta Pack sur les systèmes Windows.

Configuration multiplateforme

Les propriétés de configuration du Wrapper sont conçues pour être multiplateformes, ce qui signifie que vous n'aurez besoin que d'un seul fichier de configuration et d'un seul ensemble de propriétés dans la plupart des cas. Il existe toutefois quelques bonnes pratiques pour gérer cela facilement et pour les cas où vous avez besoin d'une configuration spécifique à une plateforme.

Tout d'abord, si vous avez choisi de déployer votre Delta Pack à la fois sous Windows et Linux, assurez-vous que tous vos chemins inclus dans votre configuration utilisent des barres obliques '/' et non des barres obliques inverses '\'. Les barres obliques inverses ne sont prises en charge que sous Windows.

Si vous souhaitez localiser votre application, vous pourriez avoir besoin d'utiliser différentes notations de locale et encodages selon la plateforme. Pour la propriété wrapper.lang, il est conseillé d'utiliser les notations UNIX (par ex. 'ja_JP' ou 'en_US') plutôt que les notations Windows (par ex. 'English_United States', 'Japanese_Japan'). Les notations UNIX fonctionnent également sous Windows, mais les notations Windows ne fonctionneront pas sur les systèmes UNIX. Pour les encodages (contrôlés par wrapper.lang.encoding), vous pouvez utiliser 'UTF-8' qui est généralement pris en charge sur toutes les plateformes, y compris Windows. Si vous devez utiliser des encodages différents par plateforme, veuillez envisager d'utiliser les propriétés wrapper.lang.<platform>.encoding.

Les propriétés de configuration suivantes vous permettent également de définir une valeur par plateforme :

Une autre technique utile consiste à rassembler toute la configuration commune dans le fichier de configuration racine et à écrire la configuration spécifique à chaque plateforme dans des fichiers d'inclusion distincts.

Vous pouvez utiliser les variables d'environnement suivantes pour référencer vos fichiers d'inclusion depuis votre fichier de configuration principal : WRAPPER_OS, WRAPPER_ARCH, WRAPPER_BITS. 

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

Vous pouvez utiliser les variables d'environnement dans le nom du fichier ou dans le nom d'un dossier parent.

Ensuite, vous devrez créer un fichier de configuration pour chaque plateforme où vous avez besoin d'une configuration spécifique. Assurez-vous simplement que les noms de fichiers sont construits avec les valeurs que les variables d'environnement prendront sur la plateforme ciblée. Si un fichier de configuration d'inclusion n'est pas trouvé, il sera ignoré silencieusement.

Si votre application utilise d'autres bibliothèques natives, vous devrez alors configurer le Wrapper pour inclure les bibliothèques correctes pour la plateforme actuelle. Ceci est expliqué sur la page de la propriété wrapper.java.library.path.<n>.

Support

Si vous avez des questions, n'hésitez pas à nous contacter en envoyant une demande de support à support@tanukisoftware.com et nous serons heureux de vous aider. Nous sommes également intéressés par vos retours et commentaires concernant cette fonctionnalité et/ou d'autres.