Pour plateformes z/OS

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

Vérifiez que les profils de sécurité suivants sont configurés comme décrit dans Activation des services autorisés z/OS sur Liberty for z/OS.
  • Profils STARTED pour les processus ange et serveur
  • Profils SERVER pour permettre l'accès aux services z/OS autorisés
Avertissement : Chaque LPAR possède un processus ange. Un ange démarré au niveau de service 8.5.5.2 ou ultérieur peut coexister avec d'autres serveurs Liberty for z/OS qui utilisent également un ange de niveau de service 8.5.5.2 ou supérieur. En cas de serveurs Liberty for z/OS multiples s'exécutant sur la même partition logique avec des niveaux de service antérieurs ou postérieurs à 8.5.5.2 qui nécessitent un processus ange, un ange au niveau 8.5.5.2 ou ultérieur devra d'abord être démarré afin de garantir le bon fonctionnement du processus ange.

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

Une tâche démarrée est une procédure JCL exécutée immédiatement en réponse à une commande d'opérateur START. Deux modèles de procédure (PROC) JCL sont disponibles dans le répertoire wlp/templates/zos/procs. Un modèle est destiné au processus serveur et l'autre, au processus ange :
  • 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.
Les administrateurs peuvent copier les modèles dans un emplacement utilisateur, puis les personnaliser pour démarrer les serveurs Liberty depuis la console MVS.
Remarque : Les fichiers qui se trouvent dans les répertoires /templates peuvent être modifiés suite à l'application de mises à jour de produit.
La section Exemple fournit davantage d'informations sur les deux modèles de PROC.

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
Notes :
  • 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.
L'exemple suivant montre la commande que vous utiliseriez pour démarrer Liberty en utilisant la PROC bbgzsrv pour un processus configuré appelé "defaultServer" :
start bbgzsrv,parms='defaultServer' 
L'exemple suivant illustre le modèle de procédure correspondant au processus ange (bbgzangl) :
//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=*

Icône indiquant le type de rubrique Rubrique Tâche



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