HowTo : Comment mettre à niveau le Java Service Wrapper

Lors de la publication de nouvelles versions du Java Service Wrapper, Tanuki Software prend toujours grand soin de s'assurer que les fichiers de configuration existants et les appels d'API restent tous compatibles avec les versions plus récentes du Wrapper.

Dans les rares cas où une fonctionnalité doit être modifiée de manière incompatible, une note est toujours indiquée dans les Notes de version ainsi que dans la documentation individuelle de la fonctionnalité.

Les étapes de mise à niveau sont simples :

• Repérez la version du Java Service Wrapper que vous souhaitez utiliser et téléchargez la distribution pour la plateforme désirée.

• Arrêtez le Java Service Wrapper en cours d'exécution à mettre à niveau.

• Sous Windows : Copiez les fichiers bin\wrapper.exe, lib\wrapper.dll et lib\wrapper.jar par-dessus les anciens fichiers du même nom.

  Sous UNIX : Copiez les fichiers bin/wrapper, lib/libwrapper.so et lib/wrapper.jar par-dessus les anciens fichiers du même nom.

• Si vous effectuez une mise à niveau depuis une version du Wrapper antérieure à 3.5.0, veuillez ouvrir votre fichier conf\wrapper.conf et ajouter un encodage de fichier à la première ligne du fichier de configuration :

  @encoding=UTF-8

  Un exemple de fichier de configuration est disponible ici.

  Si votre configuration utilise des fichiers d'inclusion (style en cascade), alors chaque fichier de configuration doit commencer par une ligne d'encodage.

  L'ancien fichier de configuration devrait autrement fonctionner tel quel, mais il est recommandé de consulter le fichier modèle src\conf\wrapper.conf.in de la nouvelle version du Wrapper pour les ajouts susceptibles de vous intéresser.

• Dans la plupart des cas, les fichiers batch et les scripts shell fonctionneront avec les versions plus récentes du Wrapper, mais en particulier sur les plateformes UNIX, il est recommandé de mettre également ces fichiers à jour.

  Sous Windows : Les nouveaux fichiers batch se trouvent dans le répertoire src\bin\. Habituellement, ces fichiers peuvent être copiés et simplement renommés pour correspondre au nommage de votre application.

  Sous UNIX : Le nouveau script shell se trouve à src/bin/App.sh.in (dans les versions plus anciennes du Wrapper, ce fichier s'appelait 'sh.script.in'). S'il existe des personnalisations dans le script shell actuel, veuillez vous assurer de les ajouter dans le nouveau script shell. N'oubliez pas que tout ce qui se trouve en dessous de la section des paramètres ne doit pas être modifié.

  Depuis la version 3.5.37, le script Shell UNIX tente de charger un fichier source optionnel pouvant contenir toute votre configuration personnalisée. Cela permet de conserver le script shell dans son état d'origine et simplifie ainsi les mises à niveau futures. Ce fichier source personnalisé est exécuté après la définition des variables en haut du script, de sorte que toute variable définie dans celui-ci remplacera la configuration par défaut du script Shell. Pour que cela fonctionne, le fichier source doit avoir le même nom de base que le script et être suffixé d'une extension '.shconf'.

• (Éditions Standard et Professionnelle)

  Pour les Éditions Standard ou Professional du Wrapper, veuillez vous assurer que la Période de mise à niveau dans votre Fichier de licence wrapper-license.conf vous autorise à passer à la nouvelle version. Chaque version possède une date de publication et la licence du Wrapper autorisera l'exécution de toute version du Wrapper publiée avant la date de fin de votre Période de mise à niveau upgrade_term.end_date.

  Licence Serveur : Si la Période de mise à niveau ne vous autorise pas à utiliser une nouvelle version, vous pouvez renouveler la Période de mise à niveau. Lorsque la Période de mise à niveau a été renouvelée, vous devrez peut-être mettre à jour votre fichier wrapper-license.conf pour pouvoir exécuter une nouvelle version.

  Licence de développement : Si vous avez renouvelé votre Maintenance et Services Annuels (TSIMS), vous devrez peut-être mettre à jour votre fichier wrapper-license.conf pour pouvoir exécuter une nouvelle version.

  Il est possible de vérifier qu'une licence autorisera une version du Wrapper en comparant la Période de mise à niveau avec les dates de publication sur la page des versions du Wrapper.

• Vous pouvez consulter les notes de version pour voir quelles améliorations ont été apportées entre les versions du Wrapper.

• Une fois que la Clé de licence a été enregistrée/remplacée dans le fichier wrapper-license.conf, nous recommandons de redémarrer immédiatement le Wrapper afin de s'assurer qu'il n'y a aucun problème. Le Wrapper ne l'exige pas, mais si le fichier nouvellement enregistré présente des problèmes, le Wrapper ne parviendrait pas à démarrer lors du prochain redémarrage du système.