Commande startServer

La commande startServer lit le fichier de configuration du processus serveur spécifié et démarre le processus serveur.

Utilisez la commande startServer pour :
  • Démarrer un serveur d'applications.
  • Démarrer un DMZ Secure Proxy Server for IBM® WebSphere Application Server.
  • Démarrer un agent d'administration.
  • Démarrer un gestionnaire de travaux.
Remarque : Cette rubrique fait référence à un ou plusieurs des fichiers journaux de serveur d'applications. Il est recommandé de configurer le serveur de telle sorte qu'il utilise l'infrastructure de journalisation et de trace HPEL (High Performance Extensible Logging) à la place des fichiers SystemOut.log, SystemErr.log, trace.log et activity.log sur les systèmes distribués et IBM i. Vous pouvez également utiliser HPEL conjointement avec vos fonctions de journalisation z/OS natives. Si vous utilisez l'infrastructure HPEL, vous pouvez accéder à toutes les informations de journalisation et de trace en utilisant l'outil de ligne de commande LogViewer à partir de votre répertoire bin de profil de serveur. Pour plus d'informations sur l'utilisation de HPEL, voir les informations sur l'utilisation de HPEL en vue du traitement des incidents liés aux applications.

[Windows]Si vous exécutez le produit sur un système d'exploitation Windows Windows et que votre serveur s'exécute comme un service Windows, la commande startServer démarrera le serveur et le service Windows associé.

La commande startServer ne nécessite pas l'emploi d'un nom d'utilisateur ni d'un mot de passe, car cette commande lance un processus serveur mais n'utilise pas de méthode MBean.

Eviter les incidents Eviter les incidents: Vous pouvez utiliser la console d'administration pour modifier le paramètre Classpath de la machine JVM (Java™ virtual machine) ou les paramètres d'entrées d'environnement d'un serveur. Mais, avant de procéder à ces modifications, il convient de bien comprendre leurs conséquences :
  • L'exécution de la commande startServer -script crée un script avec des valeurs statiques. Lorsque vous modifiez des paramètres JVM à partir de la console, un nouveau script doit être généré pour prendre en charge ces paramètres JVM modifiés.
  • Lorsque vous exécutez la commande startServer -script, un nouveau script comportant toutes les valeurs de paramètre lors de l'exécution de la commande est généré. Si vous modifiez les valeurs des paramètres (ou si vous ajoutez de nouveaux paramètres), le script généré ne comporte pas ces nouvelles valeurs de paramètre. Ces nouvelles valeurs sont transmises de manière statique au script nouvellement généré. Par conséquent, tout changement effectué après la création de ce script nécessitera un nouveau script startServer -script pour générer un nouveau script avec ces valeurs mises à jour.
  • Si vous modifiez la valeur du paramètre Classpath de la machine virtuelle Java, la nouvelle valeur remplacera celle affectée au paramètre Classpath dans la commande de lancement qui est définie par défaut dans le script généré lorsque vous émettez la commande startServer -script.
  • Si vous ajoutez une nouvelle entrée d'environnement dans la page des entrées d'environnement ou modifiez le paramétrage d'une entrée existante, alors la nouvelle valeur et/ou la valeur modifiée seront prises en compte comme paramètres du script généré lorsque vous émettez la commande startServer -script.
  • Si l'une des entrées d'environnement que vous ajoutez s'appelle PATH, la valeur spécifiée pour cette entrée se substituera à la variable PATH, laquelle, par défaut, a pour valeur WAS_PATH dans le fichier setUpCmdLine. Si la valeur de cette variable est remplacée, le message suivant est envoyé au fichier de consignation des messages d'erreur :
    WSVR0009E: Error occured during startup. com.ibm.ws.exception.RuntimeError: 
    java.lang.NoClassDefFoundError: com/ibm/ws/process/Win32ProcessGlue
gotcha

Pour plus d'informations sur l'emplacement où s'exécute cette commande, voir la rubrique Utilisation des outils de commande.

Syntaxe

La syntaxe de la commande peut se présenter sous l'une des formes ci-dessous :
startServer server_name [options]

nom_serveur est le nom du serveur d'applications ou du DMZ Secure Proxy Server for IBM WebSphere Application Server que vous souhaitez démarrer.

[AIX Solaris HP-UX Linux Windows][z/OS]Cet argument est obligatoire.

[IBM i]Cet argument est facultatif. Si cet argument n'est pas spécifié, un serveur est affecté en fonction de votre nom de profil. Si vous utilisez le profil nommé default, l'argument <serveur> prend la valeur server1. Si le nom de profil n'est pas default, l'argument <serveur> correspond au nom du profil.

startServer <adminagent_name>

nom_agent_admin représente le nom de l'agent d'administration que vous souhaitez démarrer..

startServer <job_manager>

gest_travaux représente le nom du gestionnaire de travaux que vous souhaitez démarrer.

Paramètres

Les options ci-après sont disponibles pour la commande startServer :

-?
Imprime une syntaxe.
[IBM i]-curlib <bibliothèque_logiciel>
[IBM i]Indique la bibliothèque en cours à utiliser pour la commande CL Submit Job (SBMJOB) sous-jacente.
[IBM i]-cpyenvvar
[IBM i]Indique à la commande startServer de définir les variables d'environnement qui sont actuellement définies pour le processus serveur. Par défaut, les variables d'environnement ne sont pas définies.
-help
Imprime une syntaxe.
[IBM i]-inllibl <liste_bibliothèques>
[IBM i]Indique la liste des bibliothèques initiale à utiliser pour la commande CL Submit Job (SBMJOB) sous-jacente.
[IBM i]-inlaspgrp <groupe_ASP>
[IBM i]Indique le groupe ASP initial à utiliser pour la commande CL Submit Job (SBMJOB) sous-jacente.
[AIX Solaris HP-UX Linux Windows][z/OS]-J <option_java>
[AIX Solaris HP-UX Linux Windows][z/OS]Spécifie les options à transmettre à l'interpréteur Java.
[IBM i]-jobd <bibliothèque_logiciel/description_travail>
[IBM i]Indique la description de travail pour la commande CL Submit Job (SBMJOB) sous-jacente.
[IBM i]-jobq <bibliothèque_logiciel/file_attente_travaux>
[IBM i]Indique la file d'attente des travaux pour la commande CL Submit Job (SBMJOB) sous-jacente.
[AIX Solaris HP-UX Linux Windows][z/OS]-logfile <fileName>
[AIX Solaris HP-UX Linux Windows][z/OS]Spécifie l'emplacement du fichier journal dans lequel sont consignées les informations de trace. Par défaut, le fichier journal est appelé startServer.log et est créé dans le répertoire logs.
[AIX Solaris HP-UX Linux Windows][IBM i]-nowait
[AIX Solaris HP-UX Linux Windows][IBM i]Indique à la commande startServer de ne pas attendre que l'initialisation du processus serveur lancé aboutisse.
[IBM i]-outq <bibliothèque_logiciel/file_attente_sortie>
[IBM i]Indique la file d'attente de sortie pour la commande CL Submit Job (SBMJOB) sous-jacente.
-profileName
Définit le profil d'un processus serveur dans une installation comportant plusieurs profils. L'option -profileName n'est pas nécessaire à l'exécution dans un environnement de profil unique. La valeur par défaut pour cette option correspond au profil par défaut.
[AIX Solaris HP-UX Linux Windows][z/OS]-quiet
[AIX Solaris HP-UX Linux Windows][z/OS]Supprime les informations de progression imprimées par la commande startServer en mode normal.
[AIX Solaris HP-UX Linux Windows][z/OS]-replacelog
[AIX Solaris HP-UX Linux Windows][z/OS]Remplace le fichier journal au lieu d'ajouter les données à celui en cours.
-recovery
Indique que le serveur démarrera en mode reprise, effectuera une reprise transactionnelle et s'arrêtera. Le serveur n'acceptera pas de nouvelles transactions alors qu'il sera en mode reprise. Lorsque vous redémarrerez le serveur, les ressources qui étaient indisponibles en raison de transactions douteuses seront disponibles.

Utilisez cette option si vous souhaitez pas qu'un serveur défaillant accepte de nouvelles transactions lors du processus de reprise.

transition : En cas de migration d'une version précédente du produit, assurez-vous que le paramètre ENV inclus dans l'instruction de procédure JCL du contrôleur contient l'élément REC=N ou REC=Y. Si le paramètre ENV n'inclut pas l'élément REC=N ou REC=Y, le serveur ne redémarre pas en mode reprise, même si vous spécifiez l'option -recovery.

[z/OS]Si le paramètre ENV inclut l'élément REC=N, la configuration est automatiquement modifiée à REC=Y si vous définissez -recovery lors du redémarrage du serveur. L'élément REC=N est automatiquement inclus dans le paramètre ENV si la migration n'a pas été effectuée à partir d'une version précédente du produit. Voici un exemple d'instruction PROC mise à jour :

//BBO6ACR  PROC ENV=,PARMS=' ',REC=N,Z=BBO6ACRZ
[IBM i]Lorsque vous appelez la commande startServer avec le paramètre -recovery et que le processus de reprise échoue, le message d'erreur suivant apparaît dans les fichiers SystemErr.log et SystemOut.log :
CWNATV03I: Application server xxxxxx in profile xxxxxx has completed recovery. Server stopped.
Le message n'indique pas que le processus de reprise a échoué. Si vous utilisez le paramètre -recovery, consultez les fichiers SystemErr.log et SystemOut.log du serveur que vous démarrez afin de déterminer si le processus de reprise a abouti.
[IBM i]-sbs <bibliothèque_logiciel/description_soussystème>
[IBM i]Indique le sous-système à utiliser pour la commande CL Submit Job (SBMJOB) sous-jacente.
[AIX Solaris HP-UX Linux Windows][z/OS]-statusport <portNumber>
[AIX Solaris HP-UX Linux Windows][z/OS]Paramètre facultatif permettant à un administrateur de définir le numéro de port pour le rappel de l'état du serveur. Cet outil ouvre le port et attend le rappel de l'état du serveur, indiquant que celui-ci a démarré. Si ce paramètre n'est pas défini, un port non utilisé est automatiquement affecté.
[AIX Solaris HP-UX Linux Windows][z/OS]-script [<script fileName>] -background
[AIX Solaris HP-UX Linux Windows][z/OS]Génère un script de lancement avec la commande startServer au lieu de lancer directement le processus serveur. Le nom du script de lancement est un argument facultatif. Si vous ne fournissez pas le nom du script de lancement, le nom de fichier par défaut est start_serveur en fonction du nom du serveur transmis comme premier argument à la commande startServer. Le paramètre -background est un paramètre facultatif qui indique que le script généré sera exécuté en arrière-plan.
-trace
[AIX Solaris HP-UX Linux Windows][z/OS]Génère des informations de trace dans le fichier journal à des fins de débogage.
[IBM i]Active le traçage du code de processus natif qui démarre le serveur. Le résultat de trace est écrit dans le fichier was_nom_tâche-utilisateur_tâche-numéro_tâche.log qui est situé dans le répertoire racine_profil/logs.
-timeout <seconds>
Indique le temps d'attente avant que l'initialisation du serveur n'arrive à expiration et renvoie une erreur.
[IBM i]-usejobd
[IBM i]Indique que la description de travail doit être utilisée à partir du processus Submit Job (SBMJOB) pour le serveur, lors de l'accès à l'ID utilisateur d'exécution.
Remarque : Cette commande n'a pas d'incidence sur la zone USER de la description de travail en cours.

Scénario d'utilisation

Les exemples qui suivent donnent la syntaxe appropriée. Les informations entre parenthèses décrivent la sortie qui est générée lorsque vous émettez la commande qui précède.

[AIX Solaris HP-UX Linux Windows]
startServer server1

startServer server1 -script (produces the start_server1.sh or .bat files)

startServer server1 -trace (produces the startserver.log file)

startServer adminagent

startServer.sh server1 -trace -username MyUserName -password MyUserPassword
 -profileName MyProfileName     (starts the server1 server using the 
         MyProfileName profile. The server runs under the user name MyUserName,
         and produces trace files under the profile_root/logs directory)
startServer jobmgr

startServer proxy1 (for the secure proxy profile)
[z/OS]
startServer server1

startServer server1 -script (produces the start_server1.sh file)

startServer server1 -trace (produces the startserver.log file)

startServer adminagent

startServer jobmgr

startServer proxy1 (for the secure proxy profile)

startServer.sh server1 -trace -username MyUserName -password MyUserPassword
 -profileName MyProfileName     (starts the server1 server using the 
         MyProfileName profile. The server runs under the user name MyUserName,
         and produces trace files under the profile_root/logs directory)
[IBM i]
startServer server1 (starts the server1 server for the default profile)

startServer server1 -trace (starts the server1 server for
the default profile and produces trace files under the
profile_root/logs directory)

startServer -profileName mytest (starts server mytest 
configured under profile mytest)

startServer AdminAgent01
startServer JobMgr01

startServer proxy1 (default server name for the SecureProxySrv01 profile)
startServer.sh server1 -trace -username MyUserName -password MyUserPassword
 -profileName MyProfileName     (starts the server1 server using the 
         MyProfileName profile. The server runs under the user name MyUserName,
         and produces trace files under the profile_root/logs directory)

Codes de sortie

Comment capturez-vous le code retour de startServer et stopServer pour déterminer si ce dernier a abouti ou non ? Ce tableau indique les codes retour d'un serveur en fonction d'une commande de démarrage ou d'arrêt.

L'exemple suivante est un script qui exécute et capture le code retour de server1 :
#!/bin/sh
exitCode=`./startServer.sh server1`
La valeur exitCode peut être comparée à la liste suivante de codes retour pour déterminer les résultats de la commande :
Etat de serveur Code retour
Echec de l'initialisation du serveur -1
Dépassement du délai d'initialisation du serveur -2
Démarrage du serveur en cours 1
Le serveur initialise les applications présentes 2
Initialisation du serveur terminée (réussie) 0
Echec de l'arrêt du serveur -10
Dépassement du délai d'arrêt du serveur -11
Arrêt du serveur commencé 1000
Arrêt du serveur réussi 0

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=rxml_startserver
Nom du fichier : rxml_startserver.html