Commande wparexec

Editer en ligne

Objectif

Crée une partition de charge de travail d'application ou un fichier de spécifications.

Syntaxe

wparexec [ -a ] [ -c] [ -1 ][ -F ] [ -h nom d'hôte ] [-H l'architecture] [-i] [-I attribut=valeur ...] ... [ -M attribut=valeur... ] ... [ -N attribut=valeur... ] ... [ -R attribut=valeur... ] [ -u userscript ] [ -v] [ -x] { -n wparname [ -e existantwpar | -f fichier d'entrée ] [ -o fichier de sortie [ -w ] ] | -f fichier d'entrée [ -n wparname ] [ -o fichier de sortie [ -w ] ] | -w -o fichier de sortie [ -n wparname] [ -e existantwpar | -f fichier d'entrée ] } [ [--] [ var=valeur ...] /chemin/vers/commande [ arg ... ] ]

Remarque :

Quel que soit l'environnement local, seuls les caractères ASCII sont autorisés comme arguments de la commande wparexec .

En outre, il existe d'autres restrictions pour un nom de WPAR:
  • Ne doit pas dépasser 25 octets.
  • Ne peut pas contenir d'espace ou l'un des symboles suivants:

    =: / ! ; `'" < > ~ & () * + [ ],. ^ 0 { } | \

  • Ne peut pas commencer par'-'ou'0'.

Descriptif

La commande wparexec génère et démarre une partition de charge de travaild'application ou crée un fichier de spécifications pour simplifier la création de futures partitions de charge de travaild'application.

Une partition de charge de travail d'application est un environnement d'exécution isolé qui peut avoir sa propre configuration réseau et son propre profil de contrôle des ressources. Bien que la partition partage l'espace du système de fichiers global, les processus qui s'y exécutent ne sont visibles que par les autres processus de la même partition. Cet environnement isolé permet la surveillance des processus, la collecte des données de ressource, de comptabilité et d'audit pour un cluster prédéterminé d'applications.

La commande wparexec démarre et surveille une application unique dans cet environnement isolé. La commande wparexec est renvoyée de manière synchrone avec le code retour de ce processus suivi uniquement lorsque tous les processus de la partition de charge de travail s'arrêtent. Par exemple, si le processus suivi crée un démon et se ferme avec le 0code retour, la commande wparexec se bloque jusqu'à ce que le démon et tous ses enfants s'arrêtent, puis se ferme avec le0code retour, quel que soit le code retour du démon ou de ses enfants.

Indicateurs

Article Descriptif
-1 Crée la configuration uniquement. Provoque l'arrêt de la commande wparexec après la création de la configuration de la WPARde l'application. La commande startwpar doit ensuite être utilisée pour démarrer la WPAR. Seuls les utilisateurs avancés peuvent utiliser l'option -1 .
-a

Résout automatiquement les paramètres statiques en conflit si nécessaire. Les paramètres pouvant être résolus sont le nom, le nom d'hôte et la configuration réseau.
-c Permet à cette partition de charge de travail de faire l'objet d'un point de contrôle. Cette option est valide uniquement lorsque des logiciels supplémentaires de redémarrage de point de contrôle sont installés et configurés. Lorsque cette option est utilisée, tous les systèmes de fichiers associés à cette partition de charge de travail (par exemple, avec l'option -M ) doivent être distants (par exemple, vfs=nfs).
-e wpar existant Utilise une partition de charge de travail d'application existante comme source des données de spécification. N'utilisez pas l'indicateur -e avec l'indicateur -f . Les valeurs spécifiées par d'autres indicateurs wparexec remplacent celles de la partition de charge de travailexistante.
-f fichier d'entrée Indique le fichier de spécifications à partir duquel les valeurs par défaut doivent être lues. Ne l'utilisez pas avec l'indicateur -e . Toutes les valeurs spécifiées par d'autres indicateurs wparexec remplacent celles du fichier de spécifications chargé.
-F Supprime ou remplace la plupart des conditions d'erreur. Avec l'indicateur -F , la commande wparexec continue avec un avertissement.
-h nom_hôte Indique un nom d'hôte pour cette partition de charge de travail. S'il n'est pas spécifié, la commande wparexec utilise le nom de la partition de charge de travail comme nom d'hôte.
-H l'architecture Crée une partition de charge de travail compatible avec l'architecture. Les valeurs d'architecture valides sont pwr4, ppc970, pwr5, pwr6, et pwr7. La valeur de l'architecture doit être antérieure ou égale à la version du matériel système. Les applications de la partition de charge de travail sont présentées avec le plus petit dénominateur commun de l'architecture spécifiée. Si la partition de charge de travail peut créer un point de contrôle, elle peut migrer entre des systèmes dont les niveaux de matériel sont supérieurs ou égaux à l'architecture de la partition de charge de travail.
Remarque: les systèmes à processeur POWER5 et les systèmes BladeCenter JS21 Express ne sont pas compatibles entre eux. Vous ne pouvez pas créer une partition de charge de travail JS21-compatible (ppc970) sur un système à processeur POWER5 même si le système JS21 utilise un processeur antérieur à un système à processeur POWER5 .
-i Active le routage spécifique à la partition de charge de travailpour la partition de charge de travail. Par défaut, le trafic réseau sortant d'une partition de charge de travail est acheminé comme s'il était envoyé à partir de l'environnement global, notamment de la manière suivante:
  • Le trafic entre les adresses hébergées sur le même système global est envoyé via l'interface de bouclage.
  • Les entrées de table de routage configurées dans le système global, y compris la route par défaut, sont utilisées pour transmettre le trafic de la partition de charge de travail .
Si vous activez le routage spécifique à WPAR en spécifiant l' indicateur -i , la partition de charge de travail crée et utilise sa propre table de routage pour le trafic sortant. Les entrées de routage sont créées automatiquement pour chacune des adresses réseau de la partition de charge de travail afin de prendre en charge les routes de diffusion, de bouclage et de sous-réseau. Pour plus d'informations sur les attributs de réseau, voir l'indicateur -N . Vous pouvez créer des ajouts explicites à la table de routage de la partition de charge de travail à l'aide de l'indicateur -I . En particulier, vous pouvez utiliser l'indicateur -I pour configurer la route par défaut, car aucune route par défaut n'est créée automatiquement.
-I attribute=valeur ... Ajoute des entrées de table de routage aux entrées qui sont automatiquement créées lorsque le routage spécifique à la WPARest appliqué. Vous pouvez spécifier plusieurs indicateurs -I pour configurer plusieurs routes. L'utilisation de l'indicateur -I active automatiquement le routage spécifique à la WPAR, comme décrit sous l'indicateur -i .

Vous pouvez spécifier les attributs suivants avec l'indicateur -I . L'attribut rtdest et l'attribut rtgateway doivent être spécifiés.
rtdest = destination Identifie l'hôte ou le réseau vers lequel vous dirigez la route. Vous pouvez spécifier la valeur à l'aide d'un nom symbolique ou d'une adresse numérique. Vous pouvez utiliser le mot clé default pour spécifier une route par défaut. Pour plus d'informations sur l'attribut rtdest de route, voir le paramètre Destination de la commande route .
rtgateway=passerelle Identifie la passerelle à laquelle sont adressés les paquets. Vous pouvez spécifier la valeur à l'aide d'un nom symbolique ou d'une adresse numérique.
rtnetmask = A. B. C. D Indique le masque de réseau à l'adresse de destination.
rtprefixlen = n Indique la longueur d'un préfixe de destination, qui correspond au nombre de bits dans le masque de réseau. La valeur doit être un entier positif.
rttype= {réseau|hôte} Force l'attribut rtdest à être interprété comme le type spécifié.
rtinterface=si Indique l'interface, par exemple, en0, à associer à la route pour que les paquets soient envoyés à l'aide de l'interface lorsque la route est choisie.

61Vrtfamily = {inet|inet6}

 Indique la famille d'adresses. Pour plus d'informations sur les paramètres de l'indicateur rtfamily , voir la section des paramètres de la commande route .
-M directory=dir [ vfs=type ] [ dev=devicepath ] [ host=remotehost ] [ mountopts=mountopts ] Indique uniquement les dépendances du système de fichiers. Les attributs doivent être séparés par des espaces. Par défaut, une partition de charge de travail d'application a le même niveau d'accès à tous les systèmes de fichiers globaux et à tous les montages que l'utilisateur qui a créé la partition de charge de travail. Utilisez l'indicateur -M avec l'attribut de répertoire qui est défini sur le nom du système de fichiers pour spécifier des systèmes de fichiers supplémentaires. Plusieurs indicateurs -M peuvent être spécifiés.
Remarque: tous les montages et tous les répertoires sont créés et disponibles au niveau global. Les systèmes de fichiers basés sur le disque, tels que vfs=jfs et vfs=jfs2, ne seront pas créés pour les partitions de charge de travailde l'application.

Une dépendance de système de fichiers local peut être ajoutée en définissant uniquement l'attribut de répertoire. Toutefois, le répertoire spécifié doit exister dans /etc/filesystems.

Si une erreur se produit lors du processus de création de la partition de charge de travail, tous les systèmes de fichiers montés par la commande wparexec sont démontés. Une fois la création réussie, les systèmes de fichiers ne sont pas démontés, quel que soit le statut de retour de l'application utilisateur.

Les valeurs valides de l'attribut vfs pour les partitions de charge de travailde l'application sont les suivantes:

N °
Le répertoire spécifié par l'attribut dev sur le système spécifié par l'attribut host est monté à l'emplacement spécifié par l'attribut directory. Si le point de montage n'existe pas, il est créé. Les seuls autres attributs applicables à un montage nfs sont les attributs mountopt , qui correspondent à l'option -o de la commande mount ou à l'attribut options dans une section /etc/filesystems . S'il n'est pas spécifié, aucune option de montage n'est utilisée par défaut. Les valeurs d'option acceptables correspondent aux options -o de la commande mount .
namefs
Le répertoire global spécifié par l'attribut dev est monté sur le répertoire spécifié par l'attribut directory .

Les seuls autres attributs applicables à un montage namefs sont les attributs mountopt .

annuaire
Le répertoire global spécifié par l'attribut directory est créé s'il n'existe pas. Aucun montage n'est effectué.
-n nom_wpar Indique le nom de la partition de charge de travail à créer. Si aucun nom n'est fourni, un nom est généré.
-N attribut=valeur Permet de spécifier les attributs de configuration de réseau suivants:
  • interface= si ou interface=namemappedif
  • adresse = A. B. C. D
  • masque de réseau = A. B. C. D
  • diffusion = A. B. C. D
  • adresse6 = S : T : U : V : W : X : Y : Z
  • préfixelen = n
L'interface mappée par nom est définie dans le fichier /etc/wpars/devmap . Vous pouvez spécifier le mappage entre l'interface mappée par nom et l'interface système comme suit:
# The comments start with '#'
# Each line contains a pair of name-mapped interface
# and real interface separated by tab or blank spaces.
foo en0
goo en1
soo en2

Les paires attribut=valeur doivent être séparées par des espaces. Plusieurs indicateurs -N peuvent être utilisés pour configurer plusieurs adresses IP. Au minimum, l'attribut address ou l'attribut address6 doit être spécifié. La commande wparexec collecte toutes les autres valeurs qui ne sont pas spécifiées à partir des paramètres système globaux. Si aucun indicateur -N n'est spécifié, la commande wparexec tente de découvrir une adresse IP appropriée pour la partition de charge de travail en exécutant la sous-routine gethostbyname sur le nom de partition de charge de travail spécifié avec l'indicateur -n . Si une adresse est trouvée sur le même sous-réseau qu'une interface globale, les paramètres de cette interface seront utilisés avec l'adresse IP résolue pour créer l'entrée de réseau par défaut.

Pour définir une configuration de réseau IPv6 , spécifiez l'indicateur -N avec l'attribut address6 , l'attribut prefixlen , et l'attribut interface :
  • L'attribut address6 est une adresse 128 bits. L'adresse est représentée par huit entiers de 16 bits séparés par des deux-points. Chaque entier est représenté par quatre chiffres hexadécimaux. Les zéros non significatifs peuvent être ignorés et les entiers nuls consécutifs de 16 bits peuvent être remplacés par deux signes deux-points (une fois par adresse).
  • L'attribut prefixlen correspond au nombre de bits de poids fort utilisés pour masquer l'adresse IPv6 et pour inclure le préfixe. La valeur de l'attribut prefixlen est comprise entre 0 et 128. Chaque indicateur -N peut accepter des attributs IPv4 ou IPv6 , mais pas les deux.
-o fichier de sortie Indique un chemin de sortie et un nom de fichier dans lequel écrire les données de spécification. Ce fichier de spécifications peut être utilisé pour créer une partition de charge de travail d'application ultérieurement avec l'indicateur -f .
-R attribut=valeur Permet la spécification d'attributs de contrôle de ressources. Un seul indicateur -R peut être spécifié. La plupart des contrôles de ressources sont similaires à ceux pris en charge par Workload Manager (WLM). Consultez les pages WLM répertoriées pour obtenir la description de ces attributs. Les attributs valides sont les suivants:
actif
Permet de conserver les définitions de contrôle des ressources, mais de les rendre inactives. Cet attribut peut prendre les valeurs yes ou no .
rset
Configure cette partition de charge de travail pour utiliser un ensemble de ressources créé par la commande mkrset .
parts_CPU
Nombre de partages de processeur disponibles pour cette partition de charge de travail. Pour plus d'informations sur les partages de processeur, voir Workload Manage shares File dans le document Files Reference.
UC
Pourcentage de limites de processeur pour les processus de cette partition de charge de travail. Cet attribut utilise le format suivant pour définir les valeurs limites:
CPU=<m>%-<SM>%,<HM>%

La valeur m représente la limite minimale. La valeur SM représente la limite maximale souple. La valeur HM représente la limite maximale absolue. Pour plus d'informations sur les valeurs limitées, voir Workload Manager limits File dans dans le document Files Reference.

mémoire_shares_
Nombre de partages de mémoire disponibles pour cette partition de charge de travail. Pour plus d'informations sur les partages de mémoire, voir Workload Manager shares File dans dans le document Files Reference.
Mémoire
Pourcentage de limites de mémoire pour les processus de cette partition de charge de travail. Pour plus d'informations sur la limite de mémoire, voir Workload Manager limits File dans dans le document Files Reference.
procVirtMem
Quantité maximale de mémoire virtuelle qu'un seul processus peut utiliser. Les processus qui dépassent la limite spécifiée sont arrêtés. Les unités valides sont les mégaoctets (M ou Mo), les gigaoctets (G ou Go) et les téraoctets (T ou To). La limite minimale autorisée est 1M. La limite maximale pouvant être spécifiée est 8796093022207M, 8589934591Gou 8388607T. Si la valeur est définie sur -1 (aucune unité), la limite est désactivée. Pour plus d'informations sur les valeurs limites, voir Workload Manager limits File dans dans le document Files Reference.
totalVirtMem
Quantité maximale de mémoire virtuelle pouvant être utilisée par l'ensemble de la partition de charge de travail (WPAR). Les processus qui entraînent le dépassement de la limite spécifiée seront arrêtés. La plage et les unités valides sont les mêmes que pour procVirtMem. Si la valeur est fixée à '-1' (aucune unité), la limite est désactivée. Voir Workload Manager limits File dans le document Files Reference.
totalProcesses
Nombre total de processus autorisés dans cette partition de charge de travail. Pour plus d'informations sur le numéro de processeur autorisé, voir Workload Manager limits File dans le fichier dans le document Files Reference.
  (Attributs de l'indicateur -R , suite):
totalPTYs=n
Nombre total de pseudo-terminaux autorisés dans la partition de charge de travail. Pour plus d'informations sur les pseudo-terminaux autorisés, voir Fichier spécial pty.
totalLargePages=n
Nombre de grandes pages pouvant être autorisées pour la partition de charge de travail. Pour plus d'informations sur les grandes pages autorisées, voir Pages volumineuses.
pct_msgIDs=n%
Pourcentage du nombre maximal d'ID file d'attente de messages du système autorisés dans la partition de charge de travail. Pour plus d'informations sur le nombre autorisé d'ID de file d'attente de messages, voir Services de noyau de file d'attente de messages.
pct_semIDs=n%
Pourcentage du nombre maximal d'ID sémaphore du système autorisés dans la partition de charge de travail.
pct_shmIDs=n%
Pourcentage du nombre maximal d'ID de mémoire partagée du système autorisés dans la partition de charge de travail. Pour plus d'informations sur le nombre autorisé d'ID de mémoire partagée, voir Mémoire partagée.
pct_pinMem=n%
Pourcentage de la mémoire réservée maximale du système pouvant être allouée à la partition de charge de travail. Pour plus d'informations sur la mémoire réservée, voir Prise en charge de la mémoire réservée.
totalThreads
Nombre total d'unités d'exécution autorisées dans cette partition de charge de travail. Pour plus d'informations sur le nombre autorisé d'unités d'exécution, voir Workload Manager limits File dans dans le document Files Reference.
-u script utilisateur Indique le chemin d'accès à un script utilisateur à exécuter par les commandes de partition de charge de travail à différents points d'administration. Le paramètre de l'indicateur -u peut être une chaîne entre guillemets incluant des arguments supplémentaires à transmettre au script. Dans tous les cas, le premier composant du paramètre de l'indicateur -u doit être un chemin d'accès absolu à un fichier exécutable existant. Le script est appelé comme suit:
/path/to/userScript<action><
WAPR>

L'argument action indique l'action d'administration en cours, comme suit:

  • WPAR_LOAD: Un script s'exécute dans l'environnement global après la configuration du noyau, avant la création du processus suivi. Si le script renvoie une valeur différente de zéro, la partition de charge de travail ne sera pas démarrée.
  • WPAR_START: Un script s'exécute dans l'environnement global après l'activation de la partition de charge de travail . Pour les partitions de charge de travailde l'application, le script s'exécute une fois que le processus suivi est démarré.
    Remarque: ce chemin de code peut être exécuté de manière asynchrone par un processus dissocié avec ses flux d'E-S standard fermés ou redirigés. La messagerie interne doit être traitée en conséquence et le script doit tenir compte du fait que des partitions de charge de travail de courte durée peuvent être arrêtées ou arrêtées à tout moment pendant l'exécution du script.

    Si le script renvoie une valeur différente de zéro, un avertissement est consigné, mais aucun autre comportement n'est modifié.

  • WPAR_STOP: Un script s'exécute dans l'environnement global une fois tous les processus de partition de charge de travail terminés et avant que le noyau ne soit déconfiguré.
Remarque: ce chemin de code peut être exécuté par un processus dissocié avec ses flux d'E-S standard fermés. La messagerie interne doit être traitée en conséquence.

Si le script renvoie une valeur différente de zéro, un avertissement est consigné, mais aucun autre comportement ne change.
-v

Indique la commande à exécuter en mode prolixe.
-x

Autorise l'accès aux sémaphores et aux segments de mémoire partagée entre les partitions de charge de travail (WPAR).
-w Ecrit le fichier de spécifications. Lorsqu'elle est utilisée avec l'indicateur -o , l'indicateur -w provoque la fermeture de la commande wparexec après avoir écrit le nouveau fichier de spécifications sans créer la partition de charge de travail.
[ -- ] [var=valeur] /chemin/accès/commande [ arg ... ]

Indique l'application (processus suivi) à exécuter dans la partition de charge de travail, ainsi que les paramètres et arguments de variable d'environnement nécessaires.

La commande est requise, soit par cette syntaxe de ligne de commande, soit par l'attribut general.application dans le fichier de spécifications, sauf si la commande crée uniquement un fichier de spécifications (avec l'indicateur -w ). Lorsqu'elle est démarrée, la ligne de commande fournie est toujours développée dans la partition de charge de travail. Lors de l'utilisation de la ligne de commande, les métacaractères de l'interpréteur de commandes doivent être échappés de manière appropriée afin d'éviter une expansion prématurée.

Le séparateur spécial double-moins (--) est utilisé pour indiquer que tous les arguments de ligne de commande suivants comprennent le processus suivi. Par exemple, utilisez ce séparateur pour lever l'ambiguïté entre les attributs de l'indicateur -N et l'affectation de variables d'environnement au processus suivi.

Un seul processus suivi par partition de charge de travail est pris en charge, mais cette application peut créer d'autres processus. La partition de charge de travail est automatiquement arrêtée et supprimée lorsque tous les processus qu'elle contient s'arrêtent. Une partition de charge de travail peut être arrêtée et supprimée prématurément par la commande stopwpar .

Security

Contrôle d'accès: seul l'utilisateur root peut exécuter cette commande.

Attention aux utilisateurs du contrôle d'accès à base de rôles: Cette commande peut effectuer des opérations privilégiées. Seuls les utilisateurs privilégiés peuvent exécuter des opérations privilégiées. Pour plus d'informations sur les autorisations et les privilèges, voir Base de données des commandes privilégiées dans Sécurité. Pour obtenir la liste des privilèges et des autorisations associés à cette commande, voir la commande 'lssecattr ou la sous-commande 'getcmdattr

Exemples

  1. Pour créer une partition de charge de travail d'application exécutant un programme de test de performances, entrez:
    wparexec -n tpcc -N address=192.168.0.51 /u/tpcc/benchmark -f /tmp/logfile
    Remarque: L'indicateur -f est transmis au fichier /u/tpcc/benchmark et n'est pas traité par la commande wparexec en tant qu'indicateur.
  2. Pour créer une partition de charge de travail basée sur un fichier de spécifications existant, entrez:
    wparexec -f /tmp/wparexec1.spec
  3. Pour remplacer la variable PATH minimale par défaut fournie par la commande wparexec , entrez:
    wparexec PATH=/usr/opt/bin:/usr/bin:/usr/sbin /home/joe/runapp

Fichiers

Article Descriptif
/usr/samples/wpars/sample.spec Fichier de spécification partition de charge de travail annoté.