![[Windows]](../images/windows.gif)
![[Linux]](../images/linux.gif)
Commande WASService
L'outil de ligne de commande WASService permet de créer un service pour un processus Java™ du produit sur les systèmes d'exploitation Linux et Windows.
Si l'assistant d'installation crée un service Windows, le programme de désinstallation a la possibilité de supprimer ce service. Si vous utilisez la commande WASService pour créer vous-même le service, vous devrez également le supprimer lorsqu'il cessera d'être valide. Le programme de désinstallation ne supprime pas les services que vous avez créés avec la commande WASService.
Eviter les incidents: En solution alternative à la commande WASService, vous pouvez vous servir de l'utilitaire WASServiceHelper, qui complète la commande WASService et réduit les éventuelles erreurs de configuration. Pour plus d'informations, voir la documentation sur l'utilisation de WASServiceHelper pour créer des services Windows.gotcha
Pour configurer et exécuter cette fonction sous un système d'exploitation Microsoft Windows, l'utilisateur doit appartenir au groupe des administrateurs et disposer des droits avancés suivants :Emplacement du fichier de commandes
Le fichier de commandes wasservice.sh se trouve dans le répertoire racine_serveur_applis\bin.
Le fichier de commandes WASService.exe se trouve dans le répertoire racine_serveur_applis\bin.
Syntaxe de la commande
Syntaxe de la commande pour le démarrage d'un service existant
La syntaxe de la commande est la suivante :
![[Linux]](../images/linux.gif)
wasservice.sh -start nom_service [facultatif : paramètres startServer.bat]
![[Windows]](../images/windows.gif)
WASService.exe -start nom_service [facultatif : paramètres startServer.bat]
Syntaxe de la commande pour la création d'un service ou la mise à jour d'un service existant
La syntaxe de la commande est la suivante :
![[Linux]](../images/linux.gif)
wasservice.sh -add nom_service
-serverName nom_serveur
-profilePath répertoire_profil_serveur
[-wasHome racine_serveur_applis]
[-startArgs arguments_démarrage_supplémentaires]
[-stopArgs arguments_arrêt_supplémentaires]
[-userid id_utilisateur -password mot_passe]
Note: Pour WebSphere Application Server versions 7.0 et ultérieures, n'utilisez pas le signe "@" comme préfixe dans l'ID utilisateur lors de la spécification de wasservice.sh. L'utilisation du signe "@" comme préfixe dans l'ID utilisateur de wasservice.sh s'applique uniquement à WebSphere Application Server version 6.1.La spécification de wasservice.sh avec -userid @myuser ne doit pas être utilisée dans les versions 7.0 et ultérieures.
![[Windows]](../images/windows.gif)
WASService.exe -add nom_service
-serverName nom_serveur
-profilePath répertoire_profil_serveur
[-wasHome racine_serveur_applis]
[-configRoot répertoire_référentiel_configuration]
[-startArgs arguments_démarrage_supplémentaires]
[-stopArgs arguments_arrêt_supplémentaires]
[-userid id_utilisateur -password mot_passe]
[-logFile fichier_journal_service]
[-logRoot répertoire_journal_serveur]
[-restart true | false]
[-startType automatic | manual | disabled]
Eviter les incidents: Bien que le paramètre -logroot soit facultatif, il est conseillé de l'inclure. Dans certains cas, lorsque vous ne spécifiez pas ce paramètre facultatif, une erreur peut se produire dans le journal des événements indiquant que le serveur d'applications tente de créer un service avec le paramètre -logroot.gotchaSyntaxe de commande pour la suppression d'un service
La syntaxe de la commande est la suivante :
![[Linux]](../images/linux.gif)
wasservice.sh
-remove nom_service
![[Windows]](../images/windows.gif)
WASService.exe -remove nom_service
Syntaxe de commande pour la suppression d'un service
La syntaxe de la commande est la suivante :
![[Linux]](../images/linux.gif)
wasservice.sh -stop nom_service [facultatif : paramètres stopServer.bat]
![[Windows]](../images/windows.gif)
WASService.exe -stop nom_service [facultatif : paramètres stopServer.bat]
Syntaxe de la commande pour l'extraction du statut d'un service
La syntaxe de la commande est la suivante :
![[Linux]](../images/linux.gif)
wasservice.sh
-status nom_service
![[Windows]](../images/windows.gif)
WASService.exe -status nom_service
Paramètres requis
Les paramètres suivants sont requis avec cette commande :
- Utilisez cette option pour spécifier le chemin d'accès au répertoire du profil définissant le processus du serveur.
- Utilisez cette option pour identifier le serveur contrôlé par le service.
Paramètres optionnels
Les paramètres suivants sont facultatifs avec cette commande :
- -add nom_service
- Utilisez cette option pour créer un service nommé nom_service ou mettre à jour un service existant. La syntaxe est la même dans les deux cas.
- -configRoot répertoire_référentiel_configuration (Windows uniquement)
- Utilisez cette option pour identifier le répertoire de configuration du répertoire racine de l'installation d'un produit WebSphere Application Server.
- -encodeParams nom_service (Windows uniquement)
- Utilisez cette option pour forcer le service à encoder -startArgs et -stopArgs de sorte que les arguments ne puissent pas être déterminés en modifiant le registre. Utilisez ce paramètre lors de la création d'un service avec le paramètre -add, en ajoutant
-encodeParams à la ligne de commande, sans arguments.
Ou, pour encoder les paramètres d'un service existant : WASService -encodeParams nom_service - -logFile fichier_journal_service (Windows uniquement)
- Utilisez cette option pour
identifier un fichier journal que la commande WASService utilise pour enregistrer son activité.
Eviter les incidents: Veillez à indiquer le fichier du journal des services avec un
nom qualifié complet avec un chemin unique. Si votre système a plusieurs
instances, sans cette qualification, les résultats seront imprévisibles et
WASService ne pourra pas déterminer si l'initialisation est terminée.gotcha - -logRoot répertoire_journal_serveur (Windows uniquement)
- Utilisez cette option pour identifier le répertoire du journal serveur pour le profil. La commande WASService recherche un fichier nommé nom_serveur.pid afin de déterminer si le serveur est en cours de fonctionnement.
- -remove nom_service
- Utilisez cette option pour supprimer le service spécifié.
- -restart true | false (Windows uniquement)
- Ce paramètre permet de spécifier si le service existant redémarre automatiquement si le service échoue. Le service existant ne redémarre pas automatiquement si vous définissez la valeur par false. Par défaut, le comportement de redémarrage est défini par true, ce qui permet au service existant de redémarrer automatiquement s'il échoue.
- -start nom_service [facultatif : paramètres startServer.bat]
- Cette option permet de démarrer le service existant.
- -startArgs arguments_démarrage_supplémentaires
- Utilisez cette option pour identifier les paramètres supplémentaires.
- -startType automatic | manual | disabled (Windows uniquement)
- Utilisez cette option pour définir le type de démarrage du nouveau service. Un type de démarrage automatique lance automatiquement le service au démarrage du système ou lorsque le service est appelé pour la première fois. Vous devez démarrer un service manuellement (manual) pour que le système d'exploitation puisse le charger et le rendre disponible. Vous ne pouvez pas démarrer un service désactivé (disabled) tant que vous n'avez pas modifié le type de démarrage. Par défaut, la valeur de ce paramètre est manual.
- -status nom_service
- Utilisez cette option pour renvoyer l'état courant du service, qui indique si le service est lancé ou arrêté.
- -stop nom_service [paramètres stopServer.bat facultatifs]
- Utilisez cette option pour arrêter le service spécifié.
- -stopArgs arguments_arrêt_supplémentaires
- Cette option permet de spécifier des paramètres supplémentaires.
- -userid ID_utilisateur -password mot_de_passe
- Utilisez cette option pour identifier un ID utilisateur privilégié et le mot de passe sous lequel le service Windows sera exécuté.
- -wasHome racine_serveur_applis
- Utilisez cette option pour identifier le répertoire principal d'installation du produit.
- -configRoot
- -encodeParams
- -logFile
- -logRoot
- -restart
- -startType
Noms par défaut des services créés par l'assistant
Le nom du service qui est créé par l'assistant d'installation est IBM® WebSphere Application Server V9.x - DefaultNode.
Affichage du panneau des services
Pour afficher les services, ouvrez le panneau de configuration et cliquez sur Outils d'administration > Services. Sélectionnez le service sur lequel vous voulez obtenir des informations. Cliquez avec le bouton droit sur le service et cliquez sur Propriétés. Quatre onglets fournissent des informations et des fonctionnalités. Par exemple, sélectionnez le champ Type d'installation dans l'onglet Général pour modifier le type d'installation.
![[Windows]](../images/windows.gif)
Exemples
Création d'un service de serveur d'applications
Cet exemple crée un service dénommé IBM WebSphere Application Server V9.x - nom_service_serveur_applications qui démarre un processus de serveur d'applications :
WASService -add nom_service_serveur_d'applications
-servername nom_serveur_d'applications
-profilePath racine_profil
-wasHome racine_serveur_applis
-logFile WS_startServer.log
-logRoot racine_profil\logs\nom_serveur_d'applications
-restart true
oùUne fois la commande entrée, des messages similaires à ceux de l'exemple suivant s'affichent dans la fenêtre de commande :
Adding Service: nom_service_serveur_d'applications
Config Root: racine_profil\config
Server Name: nom_serveur_d'applications
Profile Path: racine_profil
Was Home: racine_serveur_applis
Start Args:
Restart: 1
IBM WebSphere Application Server V9.x - ajout du service nom_service_serveur_applications effectué avec succès.
Mise à jour d'un service de serveur d'applications existant
Cet exemple destiné au système d'exploitation Windows met à jour un service existant dénommé IBM WebSphere Application Server V9.x - Server2 Service vec des arguments d'arrêt supplémentaires et le nom et le mot de passe de l'utilisateur. Les paramètres sont automatiquement transmis au script que le service Windows utilise pour arrêter le système.
WASService -add "Server2 Service"
-servername server2
-profilePath racine_profil
-logRoot racine_profil\logs\server2
-stopArgs "-username nom_utilisateur -password mot_de_passe"
-encodeParams
![[Windows]](../images/windows.gif)
Démarrage et arrêt d'un processus serveur après la création d'un service Windows
Dans cet exemple pour le système d'exploitation Windows, si vous entrez la commande startServer server1 ou la commande stopServer server1 après la création d'un service Windows pour server1, un message similaire à ceci s'affiche :
Comme server1 est enregistré pour s'exécuter en tant que service Web, la
demande de démarrage du serveur aboutira lors du démarrage
du service Windows associé.
Eviter les incidents: La création et le retrait d'un service WebSphere dans Windows peut prêter à confusion et être source d'erreur. Pour obtenir de l'aide sur les erreurs de diagnostic, consultez les informations relatives à l'utilisation de WASServiceCmd pour créer des services Windows pour WebSphere Application
Server.gotcha
Rubrique de référence