
Administration de Liberty sous z/OS
Sur la plateforme z/OS, vous pouvez démarrer, arrêter ou modifier Liberty à l'aide des commandes de l'opérateur MVS.
Avant de commencer
- Profils STARTED pour les processus ange et serveur
- Profils SERVER pour permettre l'accès aux services z/OS autorisés
Pourquoi et quand exécuter cette tâche
Cette rubrique explique comment démarrer,, modifier et arrêter Liberty à l'aide de la console MVS. Vous pouvez aussi démarrer et arrêter le serveur à partir d'un shell, ou utiliser un shell pour démarrer le serveur en tant que tâche démarrée (voir Démarrage et arrêt d'un serveur à partir de la ligne de commande).
- bbgzsrv pour Liberty.
- bbgzangl pour le processus ange nécessaire au contrôle d'accès aux services autorisés du système sur la plateforme z/OS.
La cible d'une commande d'opérateur STOP est un travail ou une tâche démarrée.
Une fois les modèles de procédure JCL personnalisés, ils doivent être placés dans la concaténation de bibliothèque de procédures (PROCLIB) du système. Le nom de la procédure membre devient l'argument passé à la commande START.
Procédure
Exemple
L'exemple suivant illustre le modèle de procédure correspondant au processus serveur (bbgzsrv). Cette PROC est située dans un ensemble de données, lui-même situé dans la concaténation PROCLIB z/OS.
//BBGZSRV PROC PARMS='defaultServer'
//*------------------------------------------------------------------
//* INSTDIR - Chemin de l'installation WebSphere Liberty.
//* Il est utilisé pour trouver le code du produit et est
//* équivalent à la variable d'environnement WLP_INSTALL_DIR
//* dans le shell Unix.
//* USERDIR - Chemin de la zone utilisateur de WebSphere Liberty.
//* Il est utilisé pour stocker les informations de configuration
//* partagées et spécifiques de chaque serveur et est équivalent
//* à la variable d'environnement WLP_USER_DIR dans le shell Unix.
//*------------------------------------------------------------------
// SET INSTDIR='/u/MSTONE1/wlp'
// SET USERDIR='/u/MSTONE1/wlp/usr'
//*------------------------------------------------------------------
//* Démarrer le serveur Liberty
//*
//* WLPUDIR - DD PATH pointant sur le répertoire "utilisateur"
//* de Liberty. Si la DD n'est pas allouée, l'emplacement
//* utilisé par défaut est le répertoire wlp/usr dans
//* l'arborescence d'installation.
//* STDOUT - Destination de stdout (System.out)
//* STDERR - Destination de stderr (System.err)
//* MSGLOG - Destination de messages.log (facultatif)
//* STDENV - Environnement Unix initial - Il est lu par le système. L'environnement
//* fichiers d'environnement par défaut de l'installation et
//* spécifique du serveur seront fusionnés dans cet environnement
//* avant le lancement de la JVM.
//*------------------------------------------------------------------
//STEP1 EXEC PGM=BPXBATSL,REGION=0M,
// PARM='PGM &INSTDIR./lib/native/zos/s390x/bbgzsrv &PARMS'
//WLPUDIR DD PATH='&USERDIR.'
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
//*MSGLOG DD SYSOUT=*
//*STDENV DD PATH='/etc/system.env',PATHOPTS=(ORDONLY)
//*STDOUT DD PATH='&ROOT/std.out',
//* PATHOPTS=(OWRONLY,OCREAT,OTRUNC),
//* PATHMODE=SIRWXU
//*STDERR DD PATH='&ROOT/std.err',
//* PATHOPTS=(OWRONLY,OCREAT,OTRUNC),
//* PATHMODE=SIRWXU
- Le lanceur utilise la DD STDENV comme environnement initial, mais cette DD est optionnelle. L'environnement initial du processus est défini dans la PROC. Il peut pointer sur tout type d'ensemble de données pris en charge par l'environnement LE, mais le format doit être compatible avec ce qui est attendu. Par exemple, EBCDIC, paire clé=valeur sans expansion.
- Une DD PATH pointant sur un répertoire existant (et non un fichier) est autorisée. Si cette DD est ouverte, le flux FILE renvoyé est valide pour la fonction fldata, de sorte que le chemin HFS associé à la DD peut être utilisé. Le modèle de PROC définit une DD PATH WLPUDIR qui représente l'équivalent de WLP_USER_DIR.
- L'emplacement WLP_USER_DIR est déterminé selon la logique suivante :
- Si la DD WLPUDIR est définie, le chemin associé est utilisé comme WLP_USER_DIR
- Si WLPUDIR n'est pas défini mais WLP_USER_DIR est défini dans l'environnement initial (de STDENV), il est utilisé
- Si WLPUDIR n'est pas défini et WLP_USER_DIR n'est pas défini dans l'environnement initial, la valeur par défaut de $WLP_INSTALL_DIR/usr est utilisée
- L'environnement est déterminé par la logique suivante :
- Si la DD STDENV est définie, elle est lue par le LE en tant qu'environnement initial. Si vous souhaitez définir la variable d'environnement _BPX_BATCH_UMASK, elle doit être définie ici dans la DD STDENV.
- Si $WLP_INSTALL_DIR/etc/server.env existe et est lisible, son contenu key=value est lu et appliqué à l'environnement. Ce fichier peut être en ASCII ou en EBCDIC. Les commentaires commencent par un caractère '#' et doivent être situés en fin de ligne. Les valeurs contenant des espaces peuvent être placées entre guillemets. Toutes les entrées spécifiées dans ce fichier remplacent les entrées correspondantes de l'environnement initial.
- Si $WLP_USER_DIR/servers/{serverName}/server.env existe et est lisible, son contenu clé=valeur est lu et appliqué à l'environnement. Ce fichier peut aussi être en ASCII ou en EBCDIC et peut contenir des commentaires. Toutes les entrées spécifiées ici remplacent les entrées provenant de l'environnement initial et du fichier etc/server.env.
- Quel que soit l'environnement spécifié par l'utilisateur, les entrées suivantes seront explicitement définies : _BPXK_WLM_PROPAGATE=NO, JAVA_THREAD_MODEL=HEAVY et JAVA_PROPAGATE=NO. Si _EDC_PTHREAD_YIELD n'est pas définie, elle est réglée à -2.
- Une fois l'environnement défini, JAVA_HOME est déterminé par la logique suivante :
- Si JAVA_HOME est défini dans l'environnement, son emplacement est utilisé comme JAVA_HOME
- Si JAVA_HOME n'est pas défini dans l'environnement, mais que $WLP_INSTALL_DIR/../java64 existe, $WLP_INSTALL_DIR/../java64 est utilisé comme JAVA_HOME
- Si JAVA_HOME n'est pas défini dans l'environnement et $WLP_INSTALL_DIR/../java64 n'existe pas, $WLP_INSTALL_DIR/../java est utilisé comme JAVA_HOME
- Une fois JAVA_HOME déterminé, les options de ligne de commande JVM sont déterminées par la logique suivante :
- Si $WLP_USER_DIR/servers/{serverName}/jvm.options existe et est lisible, son contenu est lu. Le fichier peut être en ASCII ou en EBCDIC et chaque ligne du fichier doit être un seul argument de ligne de commande java. Les commentaires commencent au caractère '#' et doivent être situés en fin de ligne.
- Si $WLP_USER_DIR/servers/{serverName}/jvm.options n'existe pas mais que $WLP_INSTALL_DIR/etc/jvm.options existe et est lisible, son contenu est lu. Il peut être en ASCII ou en EBCDIC et chaque ligne doit comporter un seul argument de ligne de commande java. Les commentaires sont admis.
- Quel que soit le contenu des éventuels fichiers jvm.options, les arguments -Dfile.encoding=iso8859-1, -javaagent:$WLP_INSTALL_DIR/lib/bootstrap-agent.jar et -classpath $WLP_INSTALL_DIR/lib/server-launcher.jar figurent sur la ligne de commande.
- Si vous voulez passer des arguments à la JVM, définissez l'instruction
DD JAVAOPTS de sorte que les arguments de ligne de commande Java™ soient
lus à partir de cette DD. Voici un exemple de fichier d'entrée :
-Xmx512m -Xms256m -Daaa.bbb.ccc=something.forsomeone - Lorsqu'un serveur Liberty est démarré à partir d'une PROC, il vérifie qu'il n'est pas exécuté avec un umask 000. S'il détermine que le umask est 000, il le remplace par la valeur 022.
start bbgzsrv,parms='defaultServer'
//BBGZANGL PROC PARMS='',COLD=N
//*------------------------------------------------------------------
// SET ROOT='/u/MSTONE1/wlp'
//*------------------------------------------------------------------
//* Démarrer le processus ange Liberty
//*------------------------------------------------------------------
//STEP1 EXEC PGM=BPXBATA2,REGION=0M,
// PARM='PGM &ROOT./lib/native/zos/s390x/bbgzangl COLD=&COLD &PARMS'
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*

Rubrique Tâche