Package d'un serveur de profil Liberty depuis la ligne de commande

Depuis la ligne de commande, vous pouvez créer un fichier compressé contenant un environnement d'exécution de profil Liberty, les fichiers situés dans le répertoire de ressources partagées, un serveur spécifique et les applications imbriquées sur 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 ; par conséquent, vous pouvez facilement créer un package d'installation du serveur dans un fichier compressé. Vous pouvez stocker ce package, le distribuer à des collègues, et enfin 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.

Pour plateformes répartiesRemarque : 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

Pour packager un serveur de profil Liberty depuis la ligne de commande, procédez comme suit :

  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.

    [8.5.5.5 ou ultérieure]Vous pouvez packager le profil Liberty de serveur ou d'exécution.

    • Package du serveur de profil Liberty.

      [Mise à jour - Novembre 2013]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 une archive .jar. [Mise à jour - Novembre 2013]

      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.

      • Pour plateformes répartiesPour plateformes IBM i

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

        server package nom_serveur --archive=nom_fichier_package.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}.

      • Pour plateformes répartiesPour plateformes IBM i

        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 nom_serveur --archive=nom_fichier_package.jar --include=all
        nom_fichier_package.jar est un nom de fichier de votre choix.

        Pour plus d'informations sur les options d'extraction avec ce fichier archive, voir Options d'extraction de fichier d'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é.

      [Mise à jour - Novembre 2013]L'option --include=usr n'est pas valide avec le format d'archive .jar.[Mise à jour - Novembre 2013]

      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 nécessitez ultérieurement une ou plusieurs fonctions ayant été retirées, vous devez repartir d'un serveur de profil 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
    • [8.5.5.5 ou ultérieure]Package du profil Liberty d'exécution.

      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 package_name.zip ; par exemple, 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

      To specify a package file name and target location, add the --archive=package_path_name option; for example:

      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

Dispositions pour les centres de documentation | Commentaires


Icône d'horodatage Dernière mise à jour: Wednesday, 2 September 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=twlp_setup_package_server
Nom du fichier : twlp_setup_package_server.html