Commande startServer
La commande startServer lit le fichier de configuration du processus serveur spécifié et démarre le processus serveur.
- 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.
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.

- 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
Pour plus d'informations sur l'emplacement où s'exécute cette commande, voir la rubrique Utilisation des outils de commande.
Syntaxe
startServer server_name [options]
où 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.
Cet argument est obligatoire.
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>
où nom_agent_admin représente le nom de l'agent d'administration que vous souhaitez démarrer..
startServer <job_manager>
où 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.
-curlib <bibliothèque_logiciel>
Indique la bibliothèque en cours à utiliser pour la commande CL Submit Job (SBMJOB) sous-jacente.
-cpyenvvar
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.
-inllibl <liste_bibliothèques>
Indique la liste des bibliothèques initiale à utiliser pour la commande CL Submit Job (SBMJOB) sous-jacente.
-inlaspgrp <groupe_ASP>
Indique le groupe ASP initial à utiliser pour la commande CL Submit Job (SBMJOB) sous-jacente.
-J <option_java>
Spécifie les options à transmettre à l'interpréteur Java.
-jobd <bibliothèque_logiciel/description_travail>
Indique la description de travail pour la commande CL Submit Job (SBMJOB) sous-jacente.
-jobq <bibliothèque_logiciel/file_attente_travaux>
Indique la file d'attente des travaux pour la commande CL Submit Job (SBMJOB) sous-jacente.
-logfile <fileName>
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.
-nowait
Indique à la commande startServer de ne pas attendre que l'initialisation du processus serveur lancé aboutisse.
-outq <bibliothèque_logiciel/file_attente_sortie>
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.
-quiet
Supprime les informations de progression imprimées par la commande startServer en mode normal.
-replacelog
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.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
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 :
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.CWNATV03I: Application server xxxxxx in profile xxxxxx has completed recovery. Server stopped.
-sbs <bibliothèque_logiciel/description_soussystème>
Indique le sous-système à utiliser pour la commande CL Submit Job (SBMJOB) sous-jacente.
-statusport <portNumber>
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é.
-script [<script fileName>] -background
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
Génère des informations de trace dans le fichier journal à des fins de débogage.
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.
-usejobd
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]](../images/dist.gif)
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]](../images/ngzos.gif)
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]](../images/iseries.gif)
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.
#!/bin/sh
exitCode=`./startServer.sh server1`
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 |