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.

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.

      Dans z/OS, utilisez .pax au lieu de .zip dans les exemples ci-dessous.

      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.

      • Utilisez cette commande pour générer une archive .pax.

        server package server_name --archive=package_file_name.pax --include=all
        nom_fichier_package.pax est un nom de fichier de votre choix. Ce nom de fichier peut aussi inclure un chemin d'accès complet. Si le chemin d'accès complet est omis, un fichier compressé appelé nom_fichier_package.pax est créé dans le répertoire ${server.output.dir}.

        Le format d'archive pax enregistre les attributs étendus requis pour que Liberty fonctionne comme prévu sous tous les scénarios pris en charge. Si un fichier compressé au format ZIP est requis, spécifiez le nom de l'archive cible et ajoutez l'extension .zip.

        Les formats d'archive .jar et .zip ne sont pas valides sur z/OS.

      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
      Remarque : Pour décompresser un fichier pax sous z/OS, accédez à l'emplacement dans lequel décompresser le fichier et exécutez la commande ci-dessous. L'option -ppx permet de conserver les attributs étendus.
      pax -ppx -rf location filename.pax
      emplacement est le chemin d'accès au fichier et nomfichier.pax est le nom du fichier.
    • Packagez l'environnement d'exécution Liberty.

      Dans z/OS, utilisez .pax au lieu de .zip pour les exemples suivants.

      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