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

Après avoir déployé un Java EE application client sur une machine avec une installation Application Client ou dans un WebSphere® Application Server nœud, vous pouvez démarrer l'application en utilisant lelaunchClient commande sur cette machine.

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 s'applique uniquement à Java™ EE applications clientes.

A propos de cette tâche

Le Java Platform, Enterprise Edition ( Java EE ) nécessite la prise en charge d'un conteneur client qui exécute des applications Java (appelé Java EE applications client) et fournit Java EE services aux applications. Java EE les services incluent la dénomination, la sécurité et les connexions de ressources.

Procédure

Démarrez l'environnement Qshell.
Sur la ligne de commande CL, entrez la commande :
```
STRQSH
```
Entrez la commande suivante pour lancer Java EE Clients d'applications :
```
app_client_root/bin/launchClient
```
où racine_client_app est/QIBM/ProdData/WebSphere/AppServer/V85/Base ou/QIBM/ProdData/WebSphere/AppServer/V85/ND .
Transmettre les paramètres aulaunchClient commande ou au programme client de votre application également. LelaunchClient La commande vous permet de faire les deux.
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]
```
où
- 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.
  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.
- -aide, -? imprime les informations d'utilisation.
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.
Indiquez le nom du serveur.
Par défaut, le launchClient la commande utilise le localhost pour leBootstrapHost valeur de la propriété.

Par défaut, le launchClient utilisations de la commande votre_nom_serveur pour leBootstrapHost valeur de la propriété.
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 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. Par exemple :

 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

 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