[Windows][Linux]

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.

Vous pouvez créer des services pour les processus WebSphere Application Server Java. Les services potentiels comprennent les processus serveur suivants :
  • Le processus server1 par défaut sur un noeud serveur d'applications
  • Les processus de serveur d'applications que vous créez sur un noeud serveur d'applications

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 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
[Windows]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 :
  • Se comporter comme partie intégrante du système d'exploitation
  • Se connecter en tant que service

Emplacement du fichier de commandes

[Linux]Le fichier de commandes wasservice.sh se trouve dans le répertoire racine_serveur_applis\bin.

[Windows]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]
wasservice.sh -start nom_service [facultatif : paramètres startServer.bat] 
[Windows]
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]
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]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]
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 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.gotcha

Syntaxe de commande pour la suppression d'un service

La syntaxe de la commande est la suivante :

[Linux]
wasservice.sh
-remove nom_service
[Windows]
WASService.exe -remove nom_service

Syntaxe de commande pour la suppression d'un service

La syntaxe de la commande est la suivante :

[Linux]
wasservice.sh -stop nom_service [facultatif : paramètres stopServer.bat]
[Windows]
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]
wasservice.sh
-status nom_service
[Windows]
WASService.exe -status nom_service

Paramètres requis

Les paramètres suivants sont requis avec cette commande :

-profilePath répertoire_profil_serveur
Utilisez cette option pour spécifier le chemin d'accès au répertoire du profil définissant le processus du serveur.
-serverName nom_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.
[Windows]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 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.
Note: Les paramètres suivants sont des paramètres "Windows uniquement" :
  • -configRoot
  • -encodeParams
  • -logFile
  • -logRoot
  • -restart
  • -startType
Une alternative pour la consignation et l'émission d'erreurs dans Linux consiste à utiliser la valeur sysvinit standard du système pour exécuter le script startServer.sh.
CAUTION:
Les paramètres non reconnus sont ignorés.

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]

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ù
  • nom_service_serveur_d'applications désigne le nom que vous voulez attribuer au service
  • nom_serveur_d'applications désigne le nom de votre serveur

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]

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 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

Icône indiquant le type de rubrique Rubrique de référence



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=rins_wasservice
Nom du fichier : rins_wasservice.html