![[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.
![[Windows]](../images/windows.gif)

![[Windows]](../images/windows.gif)
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]
![[Linux]](../images/linux.gif)
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]

Syntaxe 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
- IBM WebSphere Application Server V9.x - nom_noeud_gestionnaire_déploiement
- IBM WebSphere Application Server V9.x - nom_noeud_server1
- Une fois le noeud fédéré et un serveur d'applications créé, un service dénommé IBM WebSphere Application Server V9.x - nom_noeud_géré peut être créé.
Après avoir créé un profil personnalisé, vous devez fédérer le noeud pour créer un serveur agent de noeud sur le noeud. Vous pouvez également utiliser la console d'administration du gestionnaire de déploiement pour créer les processus du serveur d'applications sur le noeud. Vous pouvez créer un service Windows pour le processus serveur de l'agent de noeud.
Un serveur agent de noeud (nodeagent) est également créé après l'ajout d'un noeud serveur d'applications à une cellule du gestionnaire de déploiement. Vous pouvez créer un service pour le processus serveur de l'agent de noeud (voir plus bas).
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 gestionnaire de déploiement
Cet exemple crée un service dénommé IBM® WebSphere Application Server V9.x - nom_service_gestionnaire_déploiement qui démarre le processus dmgr :
WASService -add nom_service_gestionnaire_de_déploiement
-servername nom_serveur_gestionnaire_de_déploiement
-profilePath racine_profil
-wasHome racine_serveur_applis
-logFile WS_startManager.log
-logRoot racine_profil\logs\nom_serveur_gestionnaire_de _déploiement
-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_gestionnaire_de_déploiement
Config Root: racine_profil\config
Server Name: nom_serveur_gestionnaire_de_déploiement
Profile Path: racine_profil
Was Home: racine_serveur_applis
Start Args:
Restart: 1
IBM WebSphere Application Server V9.x - ajout du service nom_service_gestionnaire_déploiement effectué avec succès.
Cliquez sur Démarrer > Paramètres > Panneau de configuration > Outils d'administration > Services pour utiliser ce nouveau service.
Création d'un service d'agent de noeud
Cet exemple crée un service dénommé IBM WebSphere Application Server V9.x - nom_service_agent_noeud qui démarre le processus du serveur d'agent de noeud :
WASService -add nom_service_agent_de_noeud
-servername nom_serveur_agent_de_noeud
-profilePath racine_profil
-wasHome racine_serveur_applis
-logFile WS_startNode.log
-logRoot racine_profil\logs\nom_serveur_agent_de_noeud
-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_agent_de_noeud
Config Root: racine_profil\config
Server Name: nom_serveur_agent_de_noeud
Profile Path: racine_profil
Was Home: racine_serveur_applis
Start Args:
Restart: 1
IBM WebSphere Application Server V9.x - ajout du service nom_service_agent_noeud effectué avec succès.
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é.
Si vous entrez la commande startNode ou la commande stopNode après avoir créé un service Windows pour le processus nodeagent, un message similaire à celui de l'exemple ci-après s'affiche :
Comme nodeagent est enregistré pour s'exécuter en tant que service Web, la
demande de démarrage ou d'arrêt du serveur aboutira lors du démarrage
ou de l'arrêt du service Windows associé. Consultez les
fichiers journaux pour voir les messages associés à cette commande.
Si vous entrez la commande startManager ou la commande stopManager après avoir créé un service Windows pour le gestionnaire de déploiement, un message similaire à celui de l'exemple ci-après s'affiche :
Comme dmgr est enregistré pour s'exécuter en tant que service Web, la
demande de démarrage ou d'arrêt du serveur aboutira lors du démarrage
ou de l'arrêt du service Windows associé. Consultez les
fichiers journaux pour voir les messages associés à cette commande.
