[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
  • Le processus nodeagent présent sur un noeud serveur d'applications faisant partie d'une cellule du gestionnaire de déploiement
  • Le processus du gestionnaire de déploiement, dmgr
[Windows]Remarque : N'ajoutez pas de serveur d'applications faisant partie d'un noeud fédéré ou géré comme un serviceWindows. Utilisez l'agent de noeud pour gérer les noeuds fédérés.
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

Les noms des services que Outil de gestion de profil peut créer sont :
Gestionnaire de déploiement
IBM WebSphere Application Server V9.x - nom_noeud_gestionnaire_déploiement
Serveur d'applications
IBM WebSphere Application Server V9.x - nom_noeud_server1
profil personnalisé
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]

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
  • nom_service_gestionnaire_de_déploiement désigne le nom que vous voulez attribuer au service
  • nom_serveur_gestionnaire_de_déploiement 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_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
  • nom_service_agent_de_noeud désigne le nom que vous voulez attribuer au service
  • racine_profil est l'emplacement où se trouve l'agent de noeud sur le système de fichiers
  • nom_serveur_agent_de_noeud désigne le nom de votre agent de noeud

    En principe, il s'agit simplement de nodeagent.

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
  • 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é.

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.
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-nd-mp&topic=rins_wasservice
Nom du fichier : rins_wasservice.html