Package d'un serveur Liberty depuis la ligne de commande

Depuis la ligne de commande, vous pouvez créer un fichier compressé contenant un environnement d'exécution Liberty, les fichiers du répertoire de ressources partagées, un serveur spécifique et les applications qui sont intégrées dans le serveur. Vous pouvez aussi choisir d'exclure du fichier compressé les fichiers binaires d'exécution.

Pourquoi et quand exécuter cette tâche

Le serveur Liberty est léger et vous pouvez facilement packager une installation de serveur dans un fichier compressé. Vous pouvez ensuite stocker ce package, le distribuer à des collègues, puis l'utiliser pour déployer l'installation à un autre endroit ou sur une autre machine, ou même imbriquer l'installation dans une distribution de produit.

L'installation de serveur à packager ne peut pas être déjà associée à une collectivité. Vous pouvez uniquement packager un serveur autonome.

For distributed platformsRemarque : Le fichier qui en résulte est créé avec le codage UTF-8 pour les noms d'entrée ; par conséquent, l'outil que vous utilisez pour ouvrir le fichier doit être capable d'utiliser le codage UTF-8 pour les noms d'entrée. La commande jar fournie dans les SDK Java™ utilise ce format.

Procédure

  1. Ouvrez une ligne de commande et placez-vous dans le répertoire wlp/bin.
  2. Arrêtez le serveur.
  3. Exécutez la commande package pour créer un package.

    Vous pouvez packager Liberty server ou runtime.

    • Packagez le serveur Liberty.

      Le format d'archive par défaut est .zip sur toutes les plateformes excepté z/OS où le format utilisé est .pax. Vous pouvez également générer un fichier .jar.

      Si vous n'indiquez pas de nom de serveur, defaultServer est utilisé. Si vous ne spécifiez pas le paramètre --archive, la valeur de nom_serveur est utilisée pour nom_fichier_package, et le fichier compressé est créé dans le répertoire ${server.output.dir}.

      Sélectionnez la commande appropriée à votre environnement.

      • For distributed platformsFor IBM i platforms

        Utilisez cette commande pour générer une archive .zip.

        server package server_name --archive=package_file_name.zip --include=all

        nom_fichier_package.zip est un nom de fichier de votre choix. Ce nom de fichier peut inclure un chemin d'accès complet. Si le chemin d'accès complet est omis, un fichier compressé appelé nom_fichier_package.zip est créé dans le répertoire ${server.output.dir}.

      • For distributed platformsFor IBM i platforms

        Utilisez cette commande pour générer une archive .jar. L'avantage d'une archive .jar est que les scripts du répertoire bin conservent leurs permissions et sont donc exécutables quand le package est installé.

        server package server_name --archive=package_file_name.jar --include=all
        nom_fichier_package.jar est un nom de fichier de votre choix.

        Pour en savoir plus sur les options d'extraction avec ce fichier archive, voir Options d'extraction des fichiers archive Java.

      Vous pouvez aussi utiliser l'option --include avec cette commande. Par exemple, l'option --include=all permet de conditionner les fichiers binaires d'exécution et les fichiers pertinents dans le répertoire ${WLP_USER_DIR} ; l'option --include=usr permet de ne conditionner que les fichiers pertinents dans le répertoire ${WLP_USER_DIR} et exclut les fichiers binaires d'exécution du fichier compressé.

      L'option --include=usr n'est pas valide avec le format d'archive .jar.

      Si vous utilisez l'option --include=minify, la commande server conditionne uniquement les composants de l'environnement d'exécution et les fichiers qui se trouvent dans le répertoire ${WLP_USER_DIR}, nécessaires à l'exécution du serveur. Cette option réduit considérablement la taille de l'archive générée.

      Les composants de l'environnement d'exécution qui sont conservés par l'opération minify dépendent des fonctions qui sont configurées sur le serveur que vous conditionnez. Seules les fonctions nécessaires à l'exécution du serveur sont conservées ; les autres fonctions sont retirées. Par conséquent, vous ne pouvez pas activer plus tard une fonction qui a été retirée. Par exemple, si seule la fonction servlet-3.0 est conservée, vous ne pouvez pas activer plus tard la fonction jpa-2.0.

      Vous pouvez répéter l'opération minify pour réduire encore la taille de l'archive si la configuration est modifiée. Toutefois, il n'est pas possible d'inverser l'opération minify ; ainsi, si vous avez besoin ultérieurement d'une ou de plusieurs fonctions ayant été retirées, vous devez repartir d'un serveur Liberty complet.

      Pendant l'exécution de l'opération minify, le serveur est démarré temporairement et les messages associés s'affichent. Pour cette raison, vous ne pouvez pas utiliser l'option --include=minify avec un serveur qui ne peut pas être démarré. Vous pouvez toutefois créer un package de ce serveur avec l'option --include=all ou --include=usr.

      Vous pouvez spécifier les systèmes d'exploitation que le serveur conditionné doit prendre en charge en associant l'option --os à l'option --include=minify.

      Par exemple, pour conditionner un serveur sans la prise en charge de z/OS, utilisez la commande suivante :
      server package --archive="nozos.zip" --include=minify --os=-z/OS
      Pour conditionner un serveur en conservant la prise en charge d'OS/400, mais sans la prise en charge de z/OS, utilisez la commande suivante :
      server package --archive="small.zip" --include=minify --os=OS/400,-z/OS
      Pour conditionner un serveur qui ne prend en charge que Linux, utilisez la commande suivante :
      server package --archive="linux.zip" --include=minify --os=Linux
    • Packagez l'environnement d'exécution Liberty.

      Créez une archive d'exécution contenant le répertoire wlp, mais ne contenant pas le répertoire usr. La convention de dénomination d'un package serveur est nom_package.zip, comme dans l'exemple suivant : CustomerPortalApp.zip. Pour créer une archive d'exécution, exécutez la commande package sans nom de serveur et avec l'option --include=wlp.

      server package --include=wlp

      Pour spécifier un nom de fichier de package et un emplacement cible, ajoutez l'option --archive=nom_chemin_package, comme indiqué dans l'exemple suivant.

      server package --include=wlp --archive=c:\temp\myPackage.zip

      Si vous n'indiquez pas un nom de package ou un emplacement cible valide avec l'option --archive, la commande crée l'archive d'exécution wlp.zip dans l'emplacement $WLP_OUTPUT_DIR, qui est le répertoire ${wlp.install.dir}/usr/servers par défaut. L'emplacement cible doit exister préalablement à l'exécution de la commande. Par conséquent, si l'emplacement cible est c:\temp, le répertoire C:\temp doit exister et disposer de droits d'écriture pour que la commande puisse écrire l'archive dans le répertoire C:\temp.


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

Nom du fichier : twlp_setup_package_server.html