Exécution d'une application client Java EE avec launchClient

Après avoir déployé une application client Java EE sur un ordinateur où réside une installation d'Application Client, ou sur un noeud WebSphere Application Server, vous pouvez démarrer cette application en exécutant la commande launchClient sur cet ordinateur.

Avant de commencer

Pour utiliser la commande launchclient afin d'exécuter une application client Java EE, vous devez avoir déployé l'application préalablement.

Cette tâche ne s'applique qu'aux applications client Java™ EE.

Pourquoi et quand exécuter cette tâche

La spécification Java Platform, Enterprise Edition (Java EE) requiert la prise en charge d'un conteneur de clients qui exécute les applications Java autonomes (Java EE) et fournit des services Java EE à ces applications. Les services Java EE comprennent l'affectation de noms, la sécurité et les connexions aux ressources.

Procédure

  1. [IBM i]Démarrez l'environnement Qshell.
    Sur la ligne de commande CL, entrez la commande :
    STRQSH
  2. Entrez la commande suivante pour lancer les clients d'application Java EE :
    app_client_root/bin/launchClient

    [IBM i]racine_client_app correspond à /QIBM/ProdData/WebSphere/AppServer/V85/Base ou à /QIBM/ProdData/WebSphere/AppServer/V85/ND.

  3. Transmettez des paramètres à la commande launchClient et/ou à votre programme client d'application. La commande launchClient permet d'effectuer ces deux opérations. La commande launchClient requiert comme premier paramètre :
    • Soit un fichier EAR spécifiant le client d'application à lancer.
    • Soit une demande d'informations d'utilisation de launchClient.

    L'exemple suivant illustre la syntaxe de lancement de l'outil launchClient à partir d'une ligne de commande :

    launchClient [-profileName pName | -JVMOptions options | -help | -?] userapp [-CCname=value] [app args]
    • apputilisateur correspond au chemin et au nom du fichier EAR que contient le client d'application.
    • -CCname=valeur correspond au paramètre de paire nom-valeur conteneur du client. Pour connaître les arguments pris en charge pour les paires nom-valeur, reportez-vous à la rubrique sur les paramètres du conteneur client.
    • args app sont les arguments à passer au client d'application ;
    • -profileName définit le profil du processus du serveur d'applications dans une installation à plusieurs profils. L'option -profileName n'est pas requise pour une exécution dans un environnement à un profil ou dans une installation de clients d'application.

      [AIX][Linux][HP-UX][Solaris][Windows][z/OS]La valeur par défaut est default_profile.

    • -JVMOptions correspond à une chaîne d'options Java valide, standard ou non. Placez la chaîne entre guillemets.
    • -help, -? Affiche l'aide sur la syntaxe.
    Tous les autres paramètres destinés à la commande launchClient doivent commencer par le préfixe -CC.

    Les paramètres qui ne sont pas des fichiers EAR ou des demandes de syntaxe ou qui ne commencent pas par le préfixe -CC, sont ignorés par le contexte d'exécution du client d'application et sont transmis directement au programme du client d'application.

    launchClient récupère les paramètres de trois emplacements :
    • La ligne de commande
    • Un fichier de propriétés
    • Propriétés système
    Les paramètres sont résolus dans l'ordre indiqué, la plus haute priorité étant celle des valeurs de la ligne de commande et la plus faible celle des propriétés système. Cet ordre de priorités vous permet de définir et de remplacer les valeurs par défaut.
  4. Indiquez le nom du serveur.

    [AIX][Linux][HP-UX][Solaris][Windows][z/OS]Par défaut, la commande launchClient utilise la valeur localhost pour la propriété BootstrapHost.

    [IBM i]Par défaut, la commande launchClient utilise nom_votre_serveur comme valeur de la propriété BootstrapHost.

    Ce paramètre est efficace pour tester votre client d'application lorsqu'elle est installée sur le même ordinateur que le serveur. Toutefois, dans d'autres cas, vous devez remplacer cette valeur par le nom de votre serveur. Vous pouvez remplacer la valeur BootstrapHost en appelant la commande launchClient avec les paramètres suivants :
    launchClient myapp.ear -CCBootstrapHost=abc.midwest.mycompany.com
    Vous pouvez également remplacer la valeur par défaut en spécifiant la valeur dans un fichier de propriétés et en transmettant le nom du fichier au shell launchClient.

    La sécurité est contrôlée par le serveur. Vous n'avez pas à configurer la sécurité sur le client, car celui-ci présuppose que la sécurité est activée. Si la sécurité du serveur n'est pas activée, le serveur ignore la demande de sécurité et le client d'application fonctionne normalement.

Exemple

Vous pouvez stocker les valeurs de launchClient dans un fichier de propriétés, ce qui est une bonne méthode pour distribuer les valeurs par défaut. Vous pourrez par la suite remplacer une ou plusieurs valeurs sur la ligne de commande. Le format du fichier consiste en un paramètre launchClient -CC par ligne sans le préfixe -CC. Exemple :

[Windows]
 verbose=true classpath=c:\mydir\util.jar;c:\mydir\harness.jar;c:\production\G19
\global.jar BootstrapHost=abc.westcoast.mycompany.com tracefile=c:\WebSphere\mylog.txt 
[AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
 verbose=true classpath=/usr/lpp/mydir/util.jar;/usr/lpp/mydir/harness.jar;/usr/lpp
/production/G19/global.jar BootstrapHost=abc.westcoast.mycompany.com tracefile=/usr
/lpp/WebSphere/mylog.txt 

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=tcli_launchclient
Nom du fichier : tcli_launchclient.html