Outil launchClient
Vous pouvez utiliser la syntaxe de ligne de commande de Java™ Platform, Enterprise Edition (Java EE) pour l'outil launchClient de WebSphere Application Server.
Vous pouvez utiliser la commande launchClient à partir d'un noeud au sein d'un environnement WebSphere Application Server, Network Deployment. Cependant, n'essayez pas d'utiliser la commande launchClient à partir du gestionnaire de déploiement.
Utilisez des profils spécifiques pour des droits utilisateurs distincts
Utilisez une installation distincte pour des droits utilisateurs distincts.
- Passez toujours par le même utilisateur pour la totalité des commandes qui sont exécutées dans un profil donné.
- Vérifiez que tous les utilisateurs d'un profil spécifique appartiennent au même groupe. En outre, faites en sorte que chaque utilisateur d'un groupe dispose des droits de lecture et d'écriture sur les fichiers qui sont créés par d'autres membres du même profil.
L'exemple suivant illustre la syntaxe de lancement de l'outil launchClient à partir d'une ligne de commande :
launchClient [-profileName pName | -JVMOptions options | -help | -?] application_utilisateur [-CCnom=valeur] [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.
La valeur par défaut est default_profile.
- -JVMOptions correspond à une chaîne d'options Java standard ou non, à l'exception de -cp ou -classpath. Placez la chaîne entre guillemets.
- -help, -? Affiche l'aide sur la syntaxe.
Le premier paramètre, s'il en existe un, doit être -help, -?. Les options -profileName pName et -JVMOptions sont facultatives. Si elles sont utilisées, elles doivent apparaître avant le paramètre <apputilisateur>. Les autres paramètres sont facultatifs et peuvent apparaître dans n'importe quel ordre, après le paramètre apputilisateur. L'environnement d'exécution du client d'application Java EE ignore les paramètres facultatifs qui ne commencent pas par un préfixe -CC et les transmet au client d'application.
Paramètres du conteneur client
Les arguments pris en charge sont les suivants :
- -CCadminConnectorHost
- Nom d'hôte du serveur à partir duquel les informations de configuration sont extraites.
La valeur par défaut correspond à la valeur du paramètre -CCBootstrapHost ou à la valeur localhost si le paramètre -CCBootstrapHost n'est pas indiqué.
La valeur par défaut correspond à celle du paramètre -CCBootstrapHost ou la valeur votre.nom.serveur si le paramètre -CCBootstrapHost n'est pas spécifié.
- -CCadminConnectorPort
- Indique le numéro de port que doit utiliser la fonction du client d'administration. La valeur par défaut est 8880 pour les connexions SOAP et 2809 pour les connexions RMI.
- -CCadminConnectorType
- Indique comment le client d'administration doit se connecter au serveur. Indiquez RMI pour utiliser un type de connexion RMI ou SOAP pour utiliser un type de connexion SOAP. La valeur par défaut est SOAP.
- -CCadminConnectorUser
- Les clients d'administration utilise ce nom d'utilisateur lorsqu'un serveur requiert une authentification. Si le type de connexion choisi est SOAP et que la sécurité est activée sur le serveur, ce paramètre est obligatoire.
- -CCadminConnectorPassword
- Mot de passe associé au nom d'utilisateur défini par le paramètre -CCadminConnectorUser.
- -CCaltDD
- Nom d'un descripteur de déploiement de remplacement. Ce paramètre est utilisé en conjonction avec -CCjar pour spécifier le descripteur de déploiement à utiliser. Utilisez cet argument lorsqu'un fichier JAR client est configuré avec plusieurs descripteurs de déploiement. Indiquez la valeur null pour utiliser le descripteur de déploiement standard du fichier JAR.
- -CCBootstrapHost
- Le nom du serveur hôte auquel vous souhaitez vous connecter en premier. Le format est votre_serveur_préféré.com
- -CCBootstrapPort
- Le numéro de port du serveur. Si vous ne spécifiez pas cet argument, la valeur par défaut de WebSphere Application Server est appliquée.
- -CCclassLoaderMode
- Spécifie le mode du chargeur de classes. Si PARENT_LAST est spécifié, le chargeur de
classes charge les classes du chemin d'accès aux classes local avant de déléguer le
chargement des classes à son parent. Les classes chargées pour les éléments suivants
sont concernées :
- Classes définies pour le client d'application Java EE
- Ressources définies dans l'application Java EE
- Classes spécifiées dans le manifeste du fichier JAR du client Java EE
- Classes spécifiées à l'aide de l'option -CCclasspath
- -CCclasspath
- Une valeur de classe. Lorsque vous lancez une application, le chemin des classes système est utilisé. Si vous souhaitez accéder à des classes qui ne figurent pas dans le fichier EAR ou à une partie des chemins de classe système, spécifiez le paramètre approprié ici. Plusieurs chemins peuvent être concaténés.
- -CCD
- Cette option permet à WebSphere Application Server de définir la propriété système spécifiée lors de l'initialisation. N'utilisez pas le signe égal (=) après l'option -CCD. Par exemple : -CCDcom.ibm.test.property=testvalue. Vous pouvez spécifier plusieurs paramètres -CCD. Le format général de ce paramètre est -CCD<property key>=<property value>. Par exemple, -CCDI18NService.enable=true.
- -CCdumpJavaNameSpace
- Contrôle la génération d'un vidage mémoire java : espace de nom associé à l'application lancée, qui peut être utilisé pour des besoins de débogages. La valeur true génère un vidage mémoire en format abrégé en incluant le nom et le type d'objet de chacune des liaisons. Une valeur long génère un vidage mémoire en format long et inclut des informations supplémentaires pour chacune des liaisons en format abrégé, comme le type d'objet local et une représentation de chaîne de l'objet local. La valeur par défaut est false et ne génère pas de vidage mémoire.
- -CCexitVM
- Utilisez cette option pour que WebSphere Application Server appelle la méthode System.exit() au terme de l'exécution de l'application client. La valeur par défaut est false.
- -CCinitonly
- Utilisez cette option pour initialiser le contexte d'exécution du client d'application pour les clients d'application ActiveX sans exécuter l'application client. La valeur par défaut est false.
- -CCjar
- Le nom du fichier JAR (Java Archive) client qui réside dans le fichier EAR pour l'application que vous souhaitez lancer. Utilisez cet argument lorsque vous disposez de plusieurs fichiers JAR client dans le fichier EAR.
- -CCpropfile
- Indique le nom d'un fichier contenant les propriétés de launchClient. Spécifiez les propriétés sans le préfixe -CC dans le fichier, à l'exception des propriétés securityManager, securityMgrClass et securityMgrPolicy. Voir l'exemple suivant : verbose=true.
- -CCproviderURL
- Fournit des
informations sur le serveur d'amorçage que la fabrique de
contexte initial peut utiliser pour obtenir un contexte initial. La fabrique de contexte initial de
WebSphere
Application Server
peut utiliser une URL d'objet CORBA
ou une URL IIOP. Les URL objet CORBA
sont plus flexibles que les URL IIOP et l'utilisation de ce format d'URL
est recommandé. Cette valeur peut contenir plusieurs adresses de
serveur d'amorçage. Cette fonctionnalité peut être utilisée pour
tenter d'obtenir un contexte initial d'un cluster de serveurs. Vous
pouvez spécifier des adresses de serveur d'amorçage pour tous
les serveurs du cluster, dans l'URL. L'opération réussit si au moins un des serveurs est actif, ce qui limite
le nombre d'échecs. La liste d'adresse n'est pas traitée
selon un ordre spécifique. Pour les opérations d'affectation de nom, cette valeur
remplace les paramètres -CCBootstrapHost et
-CCBootstrapPort.
L'exemple suivant illustre une URL d'objet CORBA spécifiant plusieurs systèmes :
Cette valeur est mappée à la propriété système java.naming.provider.url.-CCproviderURL=corbaloc:iiop:myserver.mycompany.com:9810,:mybackupserver.mycompany.com:2809
- -CCsecurityManager
- Active et exécute WebSphere Application Server avec un gestionnaire de sécurité. La valeur par défaut est disable.
- -CCsecurityMgrClass
- Indique le nom qualifié complet d'une classe qui implémente un gestionnaire de sécurité. Utilisez uniquement cet argument lorsque le paramètre -CCsecurityManager a la valeur enable. La valeur par défaut est java.lang.SecurityManager.
- -CCsecurityMgrPolicy
- Indique le nom du fichier de stratégie d'un gestionnaire de sécurité. Utilisez uniquement cet argument lorsque le paramètre -CCsecurityManager a la valeur enable. Lorsque vous activez ce paramètre, la propriété système java.security.policy est définie. La valeur par défaut est racine_serveur_app/properties/client.policy.
- -CCsoapConnectorPort
- Port du connecteur SOAP (Simple Object Access Protocol). Si vous ne spécifiez pas cet argument, la valeur par défaut de WebSphere Application Server est appliquée.
- -CCtrace
- Utilisez cette option pour suivre le débogage de l'application. Vous devrez peut-être fournir ces informations si vous signalez un problème au service d'assistance IBM®. La valeur par défaut est false. Pour plus d'informations, reportez-vous à la rubrique Activation de la trace.
- -CCtracefile
- Indique le nom du fichier dans lequel sont écrites les informations de trace. Par défaut, les sorties sont dirigées vers la console.
- -CCtraceMode
- Spécifie le format de trace à utiliser pour le traçage. Si la valeur
admise, basic, n'est pas spécifiée, la valeur par défaut est
advanced. Le format de traçage de base est un format de traçage plus
compact.
Pour plus d'informations sur le formatage de trace de base ou avancé, voir la rubrique Interprétation de la sortie de trace.
- -CCverbose
- Cette option affiche des messages informatifs supplémentaires. La valeur par défaut est false.
Si vous utilisez une application client EJB avec sécurité activée, éditez le fichier sas.client.props, situé dans le répertoire racine_profil/properties. Dans le fichier, modifiez la valeur com.ibm.CORBA.loginSource pour faire apparaître none.
Pour plus d'informations sur l'utilitaire sas.client.props, voir les rubriques Codage manuel des mots de passe dans les fichiers de propriétés et Référence de la commande PropFilePasswordEncoder.
- Connexion RMI avec sécurité. Utilisée avec l'EJB et une application client d'administration.
- A l'aide de Jacl :
wsadmin -conntype RMI -port rmiportnumber -user userid -password mot_de_passe
wsadmin.sh -conntype RMI -port rmiportnumber -user userid -password mot_de_passe
Avec Jython :
wsadmin -lang jython -conntype RMI -port rmiportnumber -user userid -password mot_de_passe
wsadmin.sh -lang jython -conntype RMI -port rmiportnumber -user userid -password mot_de_passe
rmiportnumber de votre connexion s'affiche dans la console d'administration en tant que BOOTSTRAP_ADDRESS.
Avertissement : Sur les systèmes d'exploitation AIX, HP-UX, Linux, IBM i, Solaris et z/OS, l'utilisation de l'option -password peut entraîner des risques liés à la sécurité car les informations de mot de passe deviennent visibles pour le programme d'état du système. C'est le cas de la commande ps qui peut être appelée par un autre utilisateur pour afficher tous les processus en cours d'exécution. N'utilisez pas cette option si ce genre d'exposition pose un problème. Au lieu de cela, indiquez des informations d'utilisateur et de mot de passe dans le fichier soap.client.props pour le connecteur SOAP ou dans le fichier sas.client.props pour le connecteur RMI. Les fichiers soap.client.props et sas.client.props se trouvent dans le répertoire des propriétés de votre profil WebSphere Application Server.Si Kerberos (KRB5) est activé pour une authentification administrative, la cible d'authentification prend en charge BasicAuth et KRB5. Pour utiliser KRB5, effectuez une mise à jour des fichiers sas.client.props, soap.client.props, et ipc.client.props,en fonction du type de connecteur.
Avertissement : Lors de l'utilisation de l'authentification Kerberos, le mot de passe de l'utilisateur ne passe pas par la connexion. Un hachage unidirectionnel du mot de passe est utilisé pour identifier le client.
Les exemples ci-après indiquent la syntaxe appropriée.
![[Windows]](../images/windows.gif)
launchClient c:\earfiles\myapp.ear -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2
![[AIX HP-UX Solaris]](../images/unix.gif)
![[z/OS]](../images/ngzos.gif)
./launchClient.sh /usr/earfiles/myapp.ear -CCBootstrapHost=myWASServer
-CCverbose=true app_parm1 app_parm2
![[IBM i]](../images/iseries.gif)
/QIBM/ProdData/WebSphere/AppServer/V61/Base/bin/launchClient /home/earfiles/myapp.ear
-profileName myprofile -CCBootstrapHost=myWASServer -CCverbose=true app_parm1 app_parm2