Utilisation du client léger d'administration

Avec le client léger d'administration, vous pouvez exécuter l'outil wsadmin ou un programme Java™ d'administration autonome avec seulement deux fichiers d'archive Java (JAR). Cela permet de réduire la durée nécessaire à l'outil wsadmin pour démarrer et d'augmenter les performances. Utilisez ces informations pour configurer les programmes client JMX.

Avant de commencer

Vérifiez que le kit IBM® SDK (Software Development Kit) est installé sur le client léger d'administration. Il est recommandé d'utiliser le même kit IBM SDK que celui exécuté sur le serveur auquel il se connectera dans l'environnement du client léger d'administration.
Important : Le client léger d'administration est pris en charge pour les kits IBM SDK. Il est également pris en charge pour le kit Oracle JDK dans la même version principale si les conditions suivantes sont remplies :
  • L'application d'administration client n'utilise que le connecteur SOAP.
  • L'application d'administration client emploie l'interface de programme d'application (API) com.ibm.websphere.management.AdminClientFactory pour obtenir le client JMX.
Avertissement : Il est impossible d'exécuter un client léger d'administration avec l'option -conntype NONE.

Pourquoi et quand exécuter cette tâche

Vous ne pouvez pas utiliser le client léger d'administration pour gérer des modules de fonctions ni pour déployer des artefacts d'application spécifiques aux modules de fonctions.

Le client léger d'administration ne prend pas en charge l'installation de fichiers SAR (SIP Application Archive), ni l'édition d'applications qui utilisent un fournisseur JACC (Java Authorization Contract for Containers) externe, par exemple Tivoli Access Manager.

Le client léger d'administration ne prend pas en charge la transmission du jeton Kerberos à un serveur. Il ne prend en charge que l'authentification de base qui transmet l'ID utilisateur et le mot de passe.

Le client léger d'administration ne prend pas en charge la coexistence avec d'autres clients légers.

Le client léger d'administration sur la plateforme z/OS n'utilise pas localcomm.

Pour des informations sur le traçage et la journalisation du client léger d'administration, voir Activation de la fonction de trace sur des applications client autonomes .

Procédure

  1. Mettez les fichiers JAR du client partiel d'administration à disposition en copiant com.ibm.ws.admin.clientXXX.jar d'un environnement WebSphere Application Server vers un environnement externe à WebSphere Application Server, par exemple, c:\MyThinClient. Les fichiers JAR com.ibm.ws.admin.client_9.0.jar et com.ibm.ws.admin.client.forJython21_9.0.jar du client léger d'administration se trouvent dans l'un des emplacements suivants :
    • le répertoire AppServer/runtimes ;
    • le répertoire AppClient/runtimes, si vous avez sélectionné en option le client léger d'administration lorsque vous avez installé le client d'application.

    Le fichier com.ibm.ws.admin.client_9.0.jar doit être utilisé pour jython27 et le fichier com.ibm.ws.admin.client.forJython21_9.0.jar doit être utilisé pour jython21.

    Remarque : Dans la version 9, wsadmin utilisera jython27 par défaut. Jython21 est toujours pris en charge et pour utiliser jython21, vous devez soit utiliser l'argument wsadmin -usejython21 true soit mettre à jour com.ibm.ws.scripting.usejython21=true dans le fichier wsadmin.properties.
    Eviter les incidents Eviter les incidents: Si un message d'erreur s'affiche et que jython ne se charge pas, cela signifie que vous avez commis une erreur de configuration, par exemple, vous utilisez jython21 mais vous avez affecté com.ibm.ws.admin.client_9.0.jar au chemin de classe ou vous utilisez jython27 mais vous avez affecté com.ibm.ws.admin.client.forJython21_9.0.jar au chemin de classe Java. Prenez soin d'affecter le fichier JAR approprié au chemin de classe Java. Jython27 ne prend pas en charge Java version 7 ou antérieure. Vous devez utiliser le même niveau Java que le serveur WebSphere auquel vous tentez de vous connecter.gotcha
  2. Utilisez les fichiers JAR du client léger d'administration pour compiler et tester des programmes de client d'administration. Pour les applications Java, vous pouvez compiler et exécuter les fichiers JAR dans un environnement standard J2SE (Java 2 Platform, Standard Edition). Pour plus d'informations, voir la rubrique Compilation d'une application d'administration en utilisant le client d'administration léger.
  3. Copiez le répertoire des messages du répertoire racine_serveur_app/properties dans le répertoire C:\MyThinClient\properties.
  4. Si la sécurité est activée, les fichiers suivants seront également nécessaires :
    • Copiez le fichier com.ibm.ws.security.crypto.jar du répertoire AppServer/plugins ou du répertoire AppClient/plugins vers le répertoire C:\MyThinClient.
    • Si vous utilisez le connecteur IPC, vous pouvez éventuellement copier le fichier ipc.client.props du répertoire AppServer\profiles\profileName/properties ou AppClient\properties dans le répertoire C:\MyThinClient\properties. Vous pouvez également définir les propriétés par programme dans le fichier ipc.client.props, dans votre code Java.
    • Si vous utilisez le connecteur SOAP, vous pouvez éventuellement copier le fichier soap.client.props du répertoire AppServer\profiles\profileName\properties dans le répertoire C:\MyThinClient\properties. Ensuite, activez la sécurité du client en affectant la valeur true à la propriété com.ibm.CORBA.securityEnabled. Vous pouvez également définir les propriétés par programme dans le fichier soap.client.props, dans votre code Java.
    • Si vous utilisez des connecteurs RMI ou JSR160RMI, copiez le fichier sas.client.props du répertoire AppServer/profiles/profileName/properties dans le répertoire C:\MyThinClient\properties.

      S'il existe un pare-feu dans votre installation et que votre client d'application utilise RMI pour recevoir des notifications, vous pouvez obtenir une erreur RemoteException après avoir essayé de déployer une application. Un programme d'écoute de notifications avec RMI ne fonctionne pas à travers un pare-feu car il nécessite un port de programme d'écoute sur le client écoutant les notifications. Ce port de programme d'écoute n'est pas directement accessible lorsque le serveur essaie de renvoyer des notifications au port client. A la place de RMI, utilisez un connecteur SOAP, qui interroge les notifications.

    • Copiez les fichiers wsjaas_client.conf du répertoire AppServer\profiles\profileName/properties ou AppClient/properties dans le répertoire C:\MyThinClient\properties.
    • Copiez ou générez le fichier ssl.client.props à partir du répertoire AppServer\profiles\profileName/properties ou AppClient/properties dans le répertoire C:\MyThinClient\properties.
      Avertissement : Ce fichier contient la propriété user.root. Vous devez modifier la valeur de votre répertoire client léger, par exemple, C:\MyThinClient.
    • Si vous utilisez le kit SDK IBM, copiez les fichiers key.p12 et trust.p12 du répertoire AppServer\profiles\nomProfil\etc vers le répertoire C:\MyThinClient\etc. Pour ce faire, copiez le fichier dans le répertoire de votre client léger ou exécutez un script pour générer le fichier. Pour plus d'informations, voir les rubriques suivantes :
      • Fichier de configuration client ssl.client.props
      • Interopérabilité avec les versions précédentes du produit
      • Commande retrieveSigners
      • Installation sécurisée pour l'extraction des signataires client dans SSL
    • Si vous utilisez le kit Sun JDK, modifiez les propriétés suivantes dans le fichier ssl.client.props pour employer la clé et les fichiers de clés certifiées JKS ainsi que les implémentations de Sun Microsystems relatives à la clé et aux gestionnaires d'accréditation.
      com.ibm.ssl.alias=DefaultSSLSettings
      com.ibm.ssl.protocol=SSL
      com.ibm.ssl.securityLevel=HIGH
      com.ibm.ssl.trustManager=SunX509
      com.ibm.ssl.keyManager=SunX509
      com.ibm.ssl.contextProvider=SunJSSE
      com.ibm.ssl.enableSignerExchangePrompt=gui
      
      # Keystore information
      com.ibm.ssl.keyStoreName=ClientDefaultKeyStore
      com.ibm.ssl.keyStore=${user.root}/etc/keystore.jks
      com.ibm.ssl.keyStorePassword=keystore_password
      com.ibm.ssl.keyStoreType=JKS
      com.ibm.ssl.keyStoreProvider=SUN
      com.ibm.ssl.keyStoreFileBased=true
      
      # Truststore information
      com.ibm.ssl.trustStoreName=ClientDefaultTrustStore
      com.ibm.ssl.trustStore=${user.root}/etc/truststore.jks
      com.ibm.ssl.trustStorePassword=truststore_password
      com.ibm.ssl.trustStoreType=JKS
      com.ibm.ssl.trustStoreProvider=SUN
      com.ibm.ssl.trustStoreFileBased=true
  5. Lancez le client léger d'administration ou exécutez l'outil wsadmin à distance dans un environnement J2SE (Java 2 Platform, Standard Edition). Pour lancer votre application d'administration, utilisez les exemples de scripts de lancement suivants :
    Remarque : Si vous utilisez le kit JDK Oracle, affectez la valeur true à la propriété JVM com.ibm.websphere.thinclient.
    [Windows]
    set WAS_HOME=c:\MyThinClient 
    set USER_INSTALL_ROOT=%WAS_HOME% 
    set JAVA_HOME=location_of_the_JRE_file 
    
    REM C_PATH is the class path. Add to it as needed. 
    REM Classpath to use for jython27 (comment this out if using jython21)
    set C_PATH=%WAS_HOME%\com.ibm.ws.admin.client_9.0.jar;%WAS_HOME%\com.ibm.ws.security.crypto.jar 
    
    REM Classpath to use for jython21 (uncomment this to use jython21)
    REM set C_PATH=%WAS_HOME%\com.ibm.ws.admin.client.forJython21_9.0.jar;%WAS_HOME%\com.ibm.ws.security.crypto.jar 
    
    set SOAPURL=-Dcom.ibm.SOAP.ConfigURL=%WAS_HOME%\properties\soap.client.props 
    set TC=-Dcom.ibm.websphere.thinclient=true 
    
    if exist %JAVA_HOME%\bin\java.exe ( 
           set JAVA_EXE=%JAVA_HOME%\bin\java 
    ) else ( 
           set JAVA_EXE=%JAVA_HOME%\jre\bin\java 
    ) 
    
    %JAVA_EXE% -classpath "%C_PATH%" %TC% -Duser.install.root=%USER_INSTALL_ROOT% -Dcom.ibm.SSL.ConfigURL=file %WAS_HOME%/properties/ssl.client.props %SOAPURL% your_class_file#
    [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
    !/bin/bash 
    WAS_HOME=/MyThinClient 
    USER_INSTALL_ROOT=${WAS_HOME} 
    JAVA_HOME=location_of_the_JRE_file 
    
    # C_PATH is the class path. Add to it as needed. 
    # Classpath to use for jython27 (comment this out if using jython21)
    C_PATH=${WAS_HOME}/com.ibm.ws.admin.client_9.0.jar:${WAS_HOME}/com.ibm.ws.security.crypto.jar 
    
    # Classpath to use for jython27 (comment this out if using jython27)
    C_PATH=${WAS_HOME}/com.ibm.ws.admin.client.forJython21_9.0.jar:${WAS_HOME}/com.ibm.ws.security.crypto.jar 
    
    SOAPURL=-Dcom.ibm.SOAP.ConfigURL=${WAS_HOME}/properties/soap.client.props 
    TC=-Dcom.ibm.websphere.thinclient=true 
    
    if [[ -f ${JAVA_HOME}/bin/java ]]; then 
           JAVA_EXE="${JAVA_HOME}/bin/java" 
    else 
           JAVA_EXE="${JAVA_HOME}/jre/bin/java" 
    fi 
    
    ${JAVA_EXE} -classpath "${C_PATH}" $TC -Duser.install.root=${USER_INSTALL_ROOT} -Dcom.ibm.SSL.ConfigURL=file:${WAS_HOME}/properties/ssl.client.props ${SOAPURL} your_class_file

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