Vous pouvez créer un client d'application Liberty depuis l'invite de commande.
Pourquoi et quand exécuter cette tâche
Vous devez activer la fonction
Java™
EE
Application Client 7.0 dans le fichier
client.xml
uniquement.
Procédure
- Ouvrez une ligne de commande et placez-vous dans le répertoire wlp/bin. Dans les exemples ci-après,
path_to_liberty indique l'emplacement où vous avez
installé Liberty sur votre système d'exploitation.
Exemple sous Windows : C:\Users\mo>
cd path_to_liberty\wlp\bin
Exemple sous Linux :
mo@machine01:~>
cd path_to_liberty/wlp/bin
- Exécutez la commande suivante pour créer un client, où
client_name est le nom que vous voulez donner à
votre client. Si vous n'indiquez pas de nom de client,
defaultClient est utilisé.
Exemple sous
Windows :
C:\wlp\bin> client create
client_name
Exemple sous Linux : mo@machine01:~>
client create client_name
client create client_name
Si le client est créée avec succès, vous recevrez le
message suivant :
Client client_name created.
Vous
pouvez trouver le fichier client.xml dans le répertoire
wlp/usr/clients/client_name.
Le fichier contient la fonction javaeeClient-7.0
.
Avertissement : S'il existe un client par défaut, vous
obtenez une erreur. Dans le cas contraire,
defaultClient est crée.
- Exécutez une application client en préparant un fichier
application (.ear) contenant un module client
(.jar). Indiquez une classe principale dans le fichier
MANIFEST.MF
du module client, par exemple :
Manifest-Version: 1.0
Main-Class: com.ibm.ws.addressbook.ContactServiceClient_XMLInject
- Placez le
fichier EAR sous le répertoire
wlp/usr/clients/client_name/apps.
- Mettez à jour le fichier client.xml afin de
configurer votre application, par exemple :
<client>
<featureManager>
<feature>javaeeClient-7.0</feature>
<featureManager>
<application id="CLIENT_APP" name="CLIENT_APP" type="ear" location="clientApp.ear"/>
</client>
Si le client spécifié existe déjà, aucun client n'est créé et un
message d'exception est renvoyé :
CWWKE0005E: L'environnement d'exécution n'a pas pu être lancé.
Impossible de créer le client nommé {0} car le répertoire de client
client_name existe déjà.
Le répertoire client
C:\wlp\usr\clients\client_name existe déjà.
Que faire ensuite
Vos pouvez activer
la sécurité (SSL, CSIv2,
JAAS) pour votre client d'application en ajoutant la fonction
appSecurityClient-1.0
dans votre fichier
client.xml :
<featureManager>
<feature>javaeeClient-7.0</feature>
<feature>appSecurityClient-1.0</feature>
</featureManager>
Pour plus d'informations
sur la configuration de la sécurité dans le client d'application,
voir Configuration de la sécurité pour le conteneur du client d'application Liberty et ses applications.