Packaging Liberty resources
Liberty resources can be packaged into one or more compressed (.zip) files for deployment by the WebSphere Application Server, Network Deployment Version 9.0 job manager. Le groupement des ressources au sein des fichiers compressés affecte la portée et le partage des ressources. Pour que les ressources contenues dans les fichiers compressés se déploient correctement, les noms de chemin des ressources doivent être conformes aux règles du gestionnaire de travaux.
Avant de commencer
"Packaging a Liberty server from the command prompt" describes how to run the package command to create a compressed file that contains a Liberty runtime, files in the shared resources directory, one embedded server, and any applications embedded in the server. Si vous souhaitez déployer une installation du Liberty de ce type et que vous n'avez pas besoin de placer cette installation dans un répertoire de projet, vous pouvez utiliser la commande package pour créer le fichier compressé. Pour les autres types d'installations du Liberty, vous devez créer manuellement un ou plusieurs fichiers compressés.
Pourquoi et quand exécuter cette tâche
Les types de ressource du Liberty pris en charge incluent un projet, un environnement d'exécution, un serveur Liberty, des fichiers binaires d'application et un kit de développement de logiciels (SDK). For more information, read "Liberty resources."
Le gestionnaire de travaux établit une distinction entre les différents types de ressource du Liberty dans un fichier compressé en se basant sur les règles suivantes :
Procédure
Déterminez le type d'installation du Liberty dont vous avez besoin, puis créez un ou plusieurs fichiers compressés (.zip) contenant les ressources du Liberty.
Exemple
- Cet exemple illustre d'abord comment conditionner une installation autonome du Liberty en vue du déploiement sur un ou plusieurs hôtes de serveur. Il illustre ensuite comment conditionner une nouvelle version d'un serveur et l'application qu'il prend en charge.La structure de base des ressources du Liberty est la suivante :
- Hôte serveur
- Ressources de travail
- Projet
- exécution Liberty
- Serveur 1 du Liberty
- Fichiers binaires 1 de l'application
- Serveur 2 du Liberty
- Fichiers binaires 2 de l'application
- Serveur 1 du Liberty
- exécution Liberty
- Projet
- Ressources de travail
Les hypothèses s'appliquant à cet exemple d'installation sont les suivantes :- Structure une fois le déploiement effectué
- Cet exemple d'installation du Liberty possède la structure de répertoire suivante sur les hôtes de serveur :
[-] liberty [-] working [-] samples [-] wlp-08.05.00.00 [+] bin [ ] clients [+] dev [ ] lafiles [+] lib [+] templates [-] usr [-] servers [-] SecuritySample-01.00-01 o bootstrap.properties o server.env o server.xml [ ] apps o SecuritySample-01.00.war [-] ServletSample-01.00-01 o bootstrap.properties o server.env o server.xml [ ] apps o ServletSample-01.00.war
- Structure du package pour le déploiement initial
- Les répertoires et fichiers suivants sont inclus dans le fichier compressé (.zip) du déploiement initial de l'installation du Liberty.
Le répertoire de projet, samples, se situe à la racine du fichier compressé.
[-] samples [-] wlp-08.05.00.00 [+] bin [ ] clients [+] dev [ ] lafiles [+] lib [+] templates [-] usr [-] servers [-] SecuritySample-01.00-01 o bootstrap.properties o server.env o server.xml [ ] apps o SecuritySample-01.00.war [-] ServletSample-01.00-01 o bootstrap.properties o server.env o server.xml [ ] apps o ServletSample-01.00.war
Si un serveur doit utiliser un kit de développement de logiciels (environnement d'exploitation Java - JRE) qui n'est pas le kit par défaut (JRE de niveau système d'exploitation), vous devez indiquer l'emplacement du JRE approprié dans un fichier server.env au niveau de l'environnement d'exploitation ou du serveur ; par exemple :JAVA_HOME=/opt/jre-06.00.31
- Structure de package contenant une nouvelle version de serveur et d'application
- Les répertoires et fichiers suivants sont inclus dans un fichier compressé (.zip) pour la nouvelle version d'un serveur et l'application qu'il prend en charge. Le répertoire de projet, samples, se situe à la racine du fichier compressé.
[-] samples [-] wlp-08.05.00.00 [-] usr [-] servers [-] SecuritySample-01.01-01 o bootstrap.properties o server.env o server.xml [ ] apps o SecuritySample-01.01.war
- Hôte serveur
- Cet exemple illustre tout d'abord comment conditionner les ressources du Liberty pour un environnement dans lequel chaque hôte de serveur inclut une instance partagée unique d'un kit de développement de logiciels (environnement d'exploitation java), une instance partagée unique de l'environnement d'exécution du Liberty et deux serveurs de travail isolés dont l'activité repose sur le kit de développement de logiciels partagé et sur l'environnement d'exécution partagé du Liberty. Il illustre ensuite comment conditionner une nouvelle version d'un serveur et l'application qu'il prend en charge. L'utilisation du gestionnaire de travaux est obligatoire pour les environnements qui incluent des serveurs isolés à Liberty ; vous ne pouvez pas utiliser le script du serveur Liberty pour gérer les serveurs.
For information about sharing server configuration settings at the host and network levels, see Liberty documentation about using includes in the configuration.
La structure de base des ressources du Liberty est présentée ci-après. L'utilisation de cette approche permet de simplifier la maintenance et de conserver de l'espace disque pour les serveurs supplémentaires déployés dans le futur.- Hôtes de serveur
- Ressources partagées
- Kit de développement de logiciels (environnement d'exploitation Java)
- Liberty runtime
- Ressources de travail
- Projet
- Serveur 1 du Liberty
- Fichiers binaires 1 de l'application
- Serveur 2 du Liberty
- Fichiers binaires 2 de l'application
- Serveur 1 du Liberty
- Projet
- Ressources partagées
Les hypothèses s'appliquant à cet exemple d'installation sont les suivantes :- Structure une fois le déploiement effectué
- Cet exemple d'environnement de Liberty possède la structure de répertoire suivante sur chaque hôte de serveur :
[-] liberty [-] shared [-] jre-06.00.31 [+] bin [+] lib [-] wlp-08.05.00.00 [+] bin [ ] clients [+] dev [ ] lafiles [+] lib [+] templates [-] working [-] samples [-] servers [-] SecuritySample-01.00-01 o bootstrap.properties o server.env o server.xml [ ] apps o SecuritySample-01.00.war [-] ServletSample-01.00-01 o bootstrap.properties o server.env o server.xml [ ] apps o ServletSample-01.00.war
Chaque serveur isolé est configuré pour utiliser le kit de développement de logiciels partagé (environnement d'exécution Java) et l'environnement d'exécution partagé du Liberty. Les emplacements des ressources partagées sont stockés dans chaque fichier server.env ; par exemple :
Les chemins incluent la variable WebSphere WLP_SHARED_DIR au lieu d'un chemin codé en dur. Lorsque les serveurs isolés sont déployés sur les hôtes de serveur, le gestionnaire de travaux remplace ${WLP_SHARED_DIR} par le chemin de répertoire partagé en cours (dans le cas présent, /liberty/shared).JAVA_HOME=${WLP_SHARED_DIR}/jre-06.00.31 WLP_RUNTIME_DIR=${WLP_SHARED_DIR}/wlp-08.05.00.00
- Structure des packages pour le déploiement initial
- Les répertoires et fichiers suivants sont inclus dans le fichier compressé (.zip) du déploiement initial du kit de développement de logiciels (environnement d'exécution Java) et de l'environnement d'exécution du Liberty dans le répertoire de ressources partagées défini par la variable WebSphere WLP_SHARED_DIR. Etant donné que le kit de développement de logiciels et l'environnement d'exécution du Liberty ont toutes les chances d'être utilisés dans les projets, ces ressources ne sont pas incluses dans un répertoire de projet. Dans l'exemple présent, le kit de développement de logiciels et l'environnement d'exécution du Liberty sont conditionnés dans un fichier compressé unique.
Toutefois, vous pouvez les conditionner dans deux fichiers compressés distincts et soumettre deux travaux d'installation distincts.
[-] jre-06.00.31 [+] bin [+] lib [-] wlp-08.05.00.00 [+] bin [ ] clients [+] dev [ ] lafiles [+] lib [+] templates
Les répertoires et fichiers suivants sont inclus dans le fichier compressé (.zip) du déploiement initial des serveurs à Liberty et de leurs applications dans le répertoire de ressources de travail défini par la variable WebSphere WLP_WORKING_DIR. Le répertoire de projet, samples, se situe à la racine du fichier compressé.
[-] samples [-] servers [-] SecuritySample-01.00-01 o bootstrap.properties o server.env o server.xml [ ] apps o SecuritySample-01.00.war [-] ServletSample-01.00-01 o bootstrap.properties o server.env o server.xml [ ] apps o ServletSample-01.00.war
- Structure du package de mise à jour du serveur et de l'application
- Les répertoires et fichiers suivants sont inclus dans un fichier compressé (.zip) en vue du déploiement ultérieur d'une nouvelle version d'un serveur et de son application dans le répertoire de ressources de travail défini par la variable WebSphere WLP_WORKING_DIR. Le répertoire de projet, samples, se situe à la racine du fichier compressé.
[-] samples [-] servers [-] SecuritySample-01.01-01 o bootstrap.properties o server.env o server.xml [ ] apps o SecuritySample-01.01.war
- Hôtes de serveur
- Restriction : L'exemple 3 ne fonctionne pas sur le système d'exploitation Windows.
This example first illustrates how to package the Liberty resources for an environment where the SDK (JRE), the Liberty runtime, and several applications are stored on shared disk, and two isolated (working) servers are stored on each server host. Il illustre ensuite comment conditionner une nouvelle version d'un serveur et l'application qu'il prend en charge. L'utilisation du gestionnaire de travaux est obligatoire pour les environnements qui incluent des serveurs isolés à Liberty. Vous ne pouvez pas utiliser le script du serveur Liberty pour gérer les serveurs. For information about sharing server configuration settings at the host and network levels, see Liberty documentation about using includes in the configuration.
La structure de base des ressources du Liberty est présentée ci-après. L'utilisation de cette approche permet de simplifier la maintenance et de conserver de l'espace disque pour les serveurs supplémentaires déployés dans le futur.- Disque partagé
- Ressources partagées
- Kit de développement de logiciels (environnement d'exploitation Java)
- Liberty runtime
- Fichiers binaires 1 de l'application
- Fichiers binaires 2 de l'application
- Ressources partagées
- Hôtes de serveur
- Ressources de travail
- Projet
- Serveur 1 du Liberty
- Serveur 2 du Liberty
- Projet
- Ressources de travail
Les hypothèses s'appliquant à cet exemple d'installation sont les suivantes :- Structure une fois le déploiement effectué
- Cet exemple d'environnement du Liberty possède les structures de répertoire suivantes sur le disque partagé et sur les hôtes de serveur :
Shared disk [-] liberty [-] shared [-] jre-06.00.31 [+] bin [+] lib [-] wlp-08.05.00.00 [+] bin [ ] clients [+] dev [ ] lafiles [+] lib [+] templates [-] samples [ ] apps o SecuritySample-01.00.war o ServletSample-01.00-01.war
Hôtes de serveur [-] liberty [-] working [-] samples [-] servers [-] SecuritySample-01.00-01 o bootstrap.properties o server.env o server.xml [-] ServletSample-01.00-01 o bootstrap.properties o server.env o server.xml
Chaque serveur isolé est configuré pour utiliser le kit de développement de logiciels partagé (environnement d'exécution Java) et l'environnement d'exécution partagé du Liberty. Les emplacements des ressources partagées sont stockés dans chaque fichier server.env ; par exemple :
Les chemins incluent la variable WebSphere WLP_SHARED_DIR au lieu d'un chemin codé en dur. Lorsque les serveurs isolés sont déployés sur les hôtes de serveur, le gestionnaire de travaux remplace ${WLP_SHARED_DIR} par le chemin de répertoire partagé en cours (dans le cas présent, /liberty/shared). Sur chaque hôte de serveur, le répertoire des ressources partagées distantes est monté dans /liberty/shared.JAVA_HOME=${WLP_SHARED_DIR}/jre-06.00.31 WLP_RUNTIME_DIR=${WLP_SHARED_DIR}/wlp-08.05.00.00
Etant donné que les applications sont dans une mémoire partagée distincte des serveurs, l'élément application dans chaque fichier server.xml doit inclure le chemin complet du fichier WAR correspondant ; par exemple :<application id="SecuritySample" location="/liberty/shared/apps/SecuritySample-01.00.war" name="SecuritySample" type="war"/>
Pour réduire les modifications apportées au fichier server.xml, il est possible de stocker les informations de répertoire et de version d'application dans deux propriétés dans chaque fichier de serveur bootstrap.properties ; par exemple :apps.dir=${WLP_SHARED_DIR}/${CURRENT_PROJECT}/apps security.sample.version=1.00
Vous pouvez ensuite inclure la variable WebSphere WLP_SHARED_DIR et la variable de gestionnaire de travaux intégrée CURRENT_PROJECT dans l'élément application dans chaque fichier server.xml ; par exemple :<application id="SecuritySample" location="${apps.dir}/SecuritySample-${security.sample.version}.war" name="SecuritySample" type="war"/>
- Structure des packages pour le déploiement initial
- Les répertoires et fichiers suivants sont inclus dans le fichier compressé (.zip) du déploiement initial du kit de développement de logiciels (environnement d'exécution Java), de l'environnement d'exécution du Liberty et des applications dans l'emplacement de disque partagé défini par la variable WebSphere WLP_SHARED_DIR. Because it is likely that the SDK and the Liberty runtime will be shared across
projects, these resources are not included in a project directory. Les applications sont incluses dans le répertoire de projet samples. Dans l'exemple présent, vous conditionnez toutes les ressources partagées dans un fichier compressé unique. Toutefois, vous pouvez les conditionner dans trois fichiers compressés distincts et soumettre trois travaux d'installation distincts.
[-] jre-06.00.31 [+] bin [+] lib [-] wlp-08.05.00.00 [+] bin [ ] clients [+] dev [ ] lafiles [+] lib [+] templates [-] samples [ ] apps o SecuritySample-01.00.war o ServletSample-01.00.war
Les répertoires et fichiers suivants sont inclus dans le fichier compressé (.zip) du déploiement initial des serveurs à Liberty dans le répertoire de ressources de travail défini par la variable WebSphere WLP_WORKING_DIR :
[-] samples [-] servers [-] SecuritySample-01.01-01 o bootstrap.properties o server.env o server.xml [ ] ServletSample-01.00-01 o bootstrap.properties o server.env o server.xml
- Structure des packages de mise à jour du serveur et de l'application
- Les répertoires et fichiers suivants sont inclus dans un fichier compressé (.zip) en vue du déploiement ultérieur d'une nouvelle version d'une application dans l'emplacement de disque partagé défini par la variable WebSphere WLP_SHARED_DIR. Le répertoire de projet, samples, se situe à la racine du fichier :
[-] samples [ ] apps o SecuritySample-01.01.war
Les répertoires et fichiers suivants sont inclus dans un fichier compressé (.zip) en vue du déploiement ultérieur d'une nouvelle version d'un serveur dans le répertoire de ressources de travail défini par la variable WebSphere WLP_WORKING_DIR. Le répertoire de projet, samples, se situe à la racine du fichier compressé.
[-] samples [-] servers [-] SecuritySample-01.01-01 o bootstrap.properties o server.env o server.xml
Vous devez modifier l'élément application dans le fichier server.xml en incluant la version 1.01 du fichier WAR ; par exemple :
<application id="SecuritySample" location="/liberty/shared/apps/SecuritySample-01.01.war" name="SecuritySample" type="war"/>
Sinon, si le fichier bootstrap.properties contient les informations de version d'application, vous devez modifier le fichier en conséquence ; par exemple :
security.sample.version=1.01
Vous utilisez ensuite les informations de versions mises à jour dans l'élément application du fichier server.xml ; par exemple :
<application id="SecuritySample" location="${apps.dir}/SecuritySample-${security.sample.version}.war" name="SecuritySample" type="war"/>
- Disque partagé
Que faire ensuite
Définissez les variables qui permettent au gestionnaire de travaux d'installer et de rechercher les ressources du Liberty.