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 :

  • La ressource de projet se trouve dans un répertoire racine facultatif de niveau supérieur dans le fichier compressé. Les sous-répertoires de ce répertoire constituent la racine d'autres ressources. Vous pouvez utiliser la ressource de projet pour regrouper les ressources connexes et éviter des conflits de nom.
  • La ressource d'environnement d'exécution contient le chemin de fichier nom_environnement_exéc/bin/server ou nom_environnement_exéc/bin/server.bat. Tous les éléments contenus dans le répertoire nom_environnement_exéc sont considérés comme faisant partie de la ressource d'environnement d'exécution.
  • La ressource de serveur Liberty est conforme à l'une des règles suivantes :
    • Si elle est embarquée dans la ressource d'environnement d'exécution, la ressource de serveur Liberty contient le chemin de fichier nom_environnement_exéc/usr/servers/nom_serveur/server.xml.
    • Si elle est isolée de la ressource d'environnement d'exécution, la ressource de serveur Liberty contient le chemin de fichier servers/nom_serveur/server.xml.
  • La ressource de fichier binaire d'application est conforme à l'une des règles suivantes :
    • Si elle est intégrée dans la ressource de serveur Liberty, la ressource de fichier binaire d'application contient le chemin de fichier nom_serveur/dropins/nom_application ou nom_serveur/apps/nom_application, où nom_application se termine par .ear, .war ou .eba.
    • Si elle est intégrée dans la ressource d'environnement d'exécution, la ressource de fichier binaire d'application contient le chemin de fichier nom_environnement_exéc/usr/shared/apps/nom_application, où nom_application se termine par .ear, .war ou .eba.
    • Si elle est isolée des ressources de serveur et d'environnement d'exécution, la ressource de fichier binaire d'application contient le fichier nom_application dans n'importe quel chemin de répertoire, où nom_application se termine pare .ear, .war ou .eba.
  • La ressource de kit de développement de logiciels (SDK) contient le chemin de répertoire nom_JRE/jre/bin/java ou nom_JRE/bin/java, où nom_JRE est le nom de l'environnement d'exécution Java.
Le gestionnaire de travaux utilise le nom de répertoire d'une ressource dans le fichier compressé comme nom de ressource. Par exemple, si le nom de répertoire de l'environnement d'exécution Liberty est 08.05.00.00, le nom de la ressource correspondante est 08.05.00.00 et son ID est runtime/08.05.00.00. Lorsque vous affectez un nom aux ressources, prenez en compte les éléments suivants :
  • Si vous déployez un package sur plusieurs systèmes d'exploitation, utilisez des noms de répertoire et de fichier transférable d'un système d'exploitation à un autre. Par exemple, n'affectez pas aux ressources des noms qui se différencient uniquement par la casse afin de pouvoir les déployer sur le système d'exploitation Windows ; par exemple, ne mélangez pas jre-01.06.00 et Jre-01.06.00.
  • Lorsque vous utilisez des numéros de version combinant des numéros mineurs et majeurs dans les noms des ressources, comme 8.5.0.1, veillez à allouer un nombre de chiffres suffisant afin que la comparaison de chaîne lexicale simple puisse être utilisée pour comparer les versions. Utilisez 08.05.00.01 au lieu de 8.5.0.1. Ce schéma fonctionne même si vous utilisez des préfixes comme runtime-08.05.00.01 ou jre-01.06.00_32.

    L'utilisation de cette convention autorise la comparaison des versions lors de la demande de ressources dans le gestionnaire de travaux. Par exemple, dans le gestionnaire de travaux, vous pouvez lancer une requête sur name > 08.05.00.11 pour rechercher toutes les ressources dont le nom et la version sont supérieurs à 8.5.0.11. Pour une requête efficace, allouez au moins deux chiffres à chaque numéro de version majeur et mineur dans le nom. Sinon, les résultats risquent d'être faussés. Par exemple, utilisez 08.05.00.02 > 08.05.00.11 pour une requête au lieu de 8.5.0.2 > 8.5.0.11.

  • Utilisez des noms de projet pour regrouper les ressources connexes et éviter les conflits de nom.

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

Example 1: Self-contained Liberty installation
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
Les hypothèses s'appliquant à cet exemple d'installation sont les suivantes :
  • L'installation comprend deux serveurs.
  • Chaque serveur inclut un fichier bootstrap.properties, un fichier server.xml et une application.
  • Chaque serveur utilise un kit de développement de logiciels (environnement d'exécution Java) préalablement installé qui respecte les conditions minimales requises pour le Liberty. Si vous envisagez d'utiliser le gestionnaire de travaux pour installer un kit de développement de logiciels (SDK), voir l'Exemple 2 pour obtenir les informations de conditionnement et de configuration de serveur correspondantes.
  • L'installation du Liberty est déployée dans des exemples de répertoire de projet situés dans le répertoire de travail /liberty/working (par exemple, /liberty/working/samples).
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
Example 2: Host-level sharing of SDK and Liberty runtime
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
Les hypothèses s'appliquant à cet exemple d'installation sont les suivantes :
  • Le kit de développement de logiciels (environnement d'exécution Java) et l'environnement d'exécution du Liberty sont déployés dans le répertoire partagé /liberty/shared.
  • Les deux serveurs de travail isolés sont déployés dans des exemples de répertoire de projet situés dans le répertoire de travail /liberty/working (par exemple, /liberty/working/samples). L'inclusion d'un répertoire de projet est facultative.
  • Chaque serveur inclut un fichier bootstrap.properties, un fichier server.env, un fichier server.xml et une application.
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 :
JAVA_HOME=${WLP_SHARED_DIR}/jre-06.00.31
WLP_RUNTIME_DIR=${WLP_SHARED_DIR}/wlp-08.05.00.00
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).
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
Exemple 3 : Partage de niveau réseau du kit de développement de logiciels (SDK), de l'environnement d'exécution et des applications
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
  • Hôtes de serveur
    • Ressources de travail
      • Projet
        • Serveur 1 du Liberty
        • Serveur 2 du Liberty
Les hypothèses s'appliquant à cet exemple d'installation sont les suivantes :
  • Le kit de développement de logiciels (environnement d'exécution Java), l'environnement d'exécution du Liberty et les applications sont installés sur un disque partagé dans le chemin /liberty/shared.
  • Sur chaque hôte de serveur, le répertoire des ressources partagées (sur le disque partagé) est monté dans le même chemin, /liberty/shared.
  • Sur chaque hôte de serveur, les deux serveurs de travail isolés sont déployés dans des exemples de répertoire de projet situés dans le répertoire de travail /liberty/working (par exemple, /liberty/working/samples). L'inclusion d'un répertoire de projet est facultative.
  • Chaque serveur inclut un fichier bootstrap.properties, un fichier server.env et un fichier server.xml.
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 :
JAVA_HOME=${WLP_SHARED_DIR}/jre-06.00.31
WLP_RUNTIME_DIR=${WLP_SHARED_DIR}/wlp-08.05.00.00
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.
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"/>

Que faire ensuite

Définissez les variables qui permettent au gestionnaire de travaux d'installer et de rechercher les ressources du Liberty.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tagt_jobmgr_pkg_cs_res
Nom du fichier : tagt_jobmgr_pkg_cs_res.html