Chapitre 1. Informations Red Hat Satellite


Cette section couvre divers sujets concernant la configuration avancée de Red Hat Satellite.
Outre les options fournies sur le site web Red Hat Satellite, il existe deux outils en ligne de commande pour gérer les fichiers de configuration d'un système : le Red Hat Network Configuration Client et le Red Hat Network Configuration Manager. Il existe un autre outil, le Red Hat Network Actions Control, qui est utilisé pour activer et désactiver la gestion de configuration sur les systèmes client. Si vous ne disposez pas encore de ces outils, vous pouvez les obtenir dans canal enfant Red Hat Network Tools de votre système d'exploitation.

Note

Lors du déploiement d'un fichier de configuration via le site web, une sauvegarde du fichier précédent, y compris son chemin complet, est effectuée dans le répertoire /var/lib/rhncfg/backups/ sur le système concerné. Cette sauvegarde conserve son nom de fichier, mais une extension .rhn-cfg-backup y est ajoutée.

1.1.1. Red Hat Network Actions Control

Le Red Hat Network Actions Control (rhn-actions-control) est utilisé pour activer et désactiver la gestion de configuration d'un système. Les systèmes client, par défaut, ne peuvent pas être gérés de cette manière. Cet outil permet aux administrateurs système d'activer et désactiver des modes spécifiques d'actions admissibles, comme le déploiement d'un fichier de configuration sur le système, le téléchargement d'un fichier à partir du système, l'utilisation de diff afin de trouver ce qui est actuellement géré sur un système et ce qui est disponible, ou l'autorisation de l'exécution de commandes à distance arbitraires. Ces divers modes sont activés ou désactivés en plaçant ou en supprimant des fichiers et des répertoires dans le répertoire /etc/sysconfig/rhn/allowed-actions/. Vu les permissions par défaut sur le répertoire /etc/sysconfig/rhn/, le Red Hat Network Actions Control doit être exécuté par un utilisateur possédant l'accès root.

1.1.1.1. Options en ligne de commande générales

Une page man est disponible, comme pour la plupart des outils en ligne de commande. Décidez simplement quelles actions programmées de Red Hat Network devraient être activées de façon à être utilisées par les administrateurs système. Ces options activent les différents modes d'actions programmées :
Expand
Tableau 1.1. options de rhn-actions-control
Option Description
--enable-deploy Permet à rhncfg-client de déployer des fichiers.
--enable-diff Permet à rhncfg-client de comparer des fichiers.
--enable-upload Permet à rhncfg-client de télécharger des fichiers.
--enable-mtime-upload Permet à rhncfg-client de télécharger mtime.
--enable-all Permet à rhncfg-client de tout faire.
--enable-run Active l'exécution d'un script.
--disable-deploy Désactive le déploiement.
--disable-diff Désactive la comparaison.
--disable-upload Désactive le téléchargement.
--disable-mtime-upload Désactive le téléchargement de mtime.
--disable-all Désactive toutes les options.
--disable-run Désactive l'exécution de scripts.
--report Rapporte si les modes sont activés ou désactivés.
-f, --force Force l'opération sans demander avant
-h, --help Affiche le message d'aide et quitte
Une fois qu'un mode est défini, votre système sera prêt pour la gestion de configuration via Red Hat Satellite. rhn-actions-control --enable-all est une option courante.

1.1.2. Red Hat Network Configuration Client

Comme son nom l'indique, le Red Hat Network Configuration Client (rhncfg-client) est installé et exécuté depuis un système client individuel. Vous pouvez l'utiliser pour recueillir des informations sur la manière selon laquelle Red Hat Network déploie les fichiers de configuration sur le client.
Le Red Hat Network Configuration Client offre les modes primaires suivants : list, get, channels, diff et verify.

1.1.2.1. Listage des fichiers de configuration

Pour dresser la liste des fichiers de configuration pour la machine et des étiquettes (labels) s'appliquant au canaux de configuration, exécutez la commande suivante :
rhncfg-client list
Copy to Clipboard Toggle word wrap
La sortie ressemble à la liste suivante :
Config Channel      File
config-channel-17   /etc/example-config.txt
config-channel-17   /var/spool/aalib.rpm
config-channel-14   /etc/rhn/rhn.conf
Copy to Clipboard Toggle word wrap
Ces fichiers sont les fichiers de configuration qui s'appliquent à votre système. Cependant, il se peut que des fichiers dupliqués soient présents dans les autres canaux. Par exemple, exécutez la commande suivante :
rhncfg-manager list config-channel-14
Copy to Clipboard Toggle word wrap
et examinez la sortie suivante :
Files in config channel 'config-channel-14' /etc/example-config.txt /etc/rhn/rhn.conf
Copy to Clipboard Toggle word wrap
Vous pouvez alors vous demander où est passée la seconde version de /etc/example-config.txt. Le niveau du fichier /etc/example-config.txt dans config-channel-17 était supérieur à celui du même fichier dans config-channel-14. Ainsi, la version du fichier de configuration dans config-channel-14 n'est pas déployée pour ce système, bien que le fichier réside toujours dans le canal. La commande rhncfg-client ne liste pas le fichier parce qu'il ne sera pas déployé sur ce système.

1.1.2.2. Obtention d'un fichier de configuration

Pour télécharger le fichier de configuration le plus approprié à votre machine, exécutez la commande suivante :
rhncfg-client get /etc/example-config.txt
Copy to Clipboard Toggle word wrap
Une sortie semblable à celle reproduite ci-dessous devrait apparaître :
Deploying /etc/example-config.txt
Copy to Clipboard Toggle word wrap
Afficher le contenu du fichier avec la commande less ou un autre pager. Remarquez que le fichier est sélectionné comme étant le plus pertinent selon le rang du canal de configuration le contenant. Cette opération est effectuée sous l'onglet Configuration de la page Détails du système.

1.1.2.3. Affichage des canaux de configuration

Pour afficher les étiquettes et les noms de canaux de configuration s'appliquant au système, exécutez la commande suivante :
rhncfg-client channels
Copy to Clipboard Toggle word wrap
Une sortie semblable à celle reproduite ci-dessous devrait apparaître :
Config channels: Label Name ----- ---- config-channel-17 config chan 2 config-channel-14 config chan 1
Copy to Clipboard Toggle word wrap
La table suivante liste les options disponibles pour rhncfg-client get :
Expand
Tableau 1.2. options de rhncfg-client get
Option Description
--topdir=TOPDIR Rend toutes les opérations de fichiers relatives à cette chaîne
--exclude=EXCLUDE Exclut le déploiement d'un fichier avec 'get'/ Peut être utilisé de multiples fois.
-h, --help Affiche le message d'aide et quitte

1.1.2.4. Différentiation entre les fichiers de configuration

Pour afficher les différences entre les fichiers de configuration déployés sur le système et ceux stockés par Red Hat Network, exécutez la commande suivante :
rhncfg-client diff
Copy to Clipboard Toggle word wrap
Une sortie semblable à celle reproduite ci-dessous devrait apparaître :
[root@testsatellite root]# rhncfg-client diff
--- /etc/test
+++ /etc/test	2013-08-28 00:14:49.405152824 +1000
@@ -1 +1,2 @@
 This is the first line
+This is the second line added
Copy to Clipboard Toggle word wrap
De plus, vous pouvez inclure l'option --topdir pour comparer les fichiers de configuration dans Red Hat Network avec ceux figurant sur un emplacement arbitraire (et non utilisé) sur le système client, comme ceci :
[root@ root]# rhncfg-client diff --topdir /home/test/blah/ /usr/bin/diff: /home/test/blah/etc/example-config.txt: No such file or directory /usr/bin/diff: /home/test/blah/var/spool/aalib.rpm: No such file or directory
Copy to Clipboard Toggle word wrap

1.1.2.5. Vérification des fichiers de configuration

Pour déterminer rapidement si des fichiers de configuration client sont différents des fichiers qui lui sont associés via Red Hat Network, exécutez la commande suivante :
rhncfg-client verify
Copy to Clipboard Toggle word wrap
Une sortie semblable à celle reproduite ci-dessous devrait apparaître :
modified /etc/example-config.txt /var/spool/aalib.rpm
Copy to Clipboard Toggle word wrap
Le fichier example-config.txt est modifié localement alors que aalib.rpm lui ne l'est pas.
La table suivante liste les options disponibles pour rhncfg-client verify :
Expand
Tableau 1.3. options de rhncfg-client verify
Option Description
-v, --verbose Augmente la quantité d'informations de sortie. Affiche les différences dans le mode, le propriétaire et les permissions de groupe pour le fichier de configuration spécifié.
-o, --only Affiche uniquement les fichiers présentant des différences.
-h, --help Affiche le message d'aide et quitte

1.1.3. Red Hat Network Configuration Manager

Contrairement au Red Hat Network Configuration Client, le Red Hat Network Configuration Manager (rhncfg-manager) est conçu pour maintenir le référentiel central de Red Hat Network contenant les fichiers de configuration et les canaux, et non pas ceux qui figurent sur les systèmes clients. Cet outil offre une alternative en ligne de commande aux fonctionnalités de gestion de la configuration offertes par le site web Red Hat Network, ainsi que la possibilité de créer des scripts pour certaines voire pour toutes les tâches de maintenance associées.
Ce dernier est créé pour être utilisé par des administrateurs de configuration (Config Administrators) et requiert un nom d'utilisateur et un mot de passe Red Hat Network avec l'ensemble de permissions appropriées. Le nom d'utilisateur peut être spécifié dans /etc/sysconfig/rhn/rhncfg-manager.conf ou dans la section [rhncfg-manager] de ~/.rhncfgrc.
Lorsque le Red Hat Network Configuration Manager est exécuté en tant que super-utilisateur, il tente d'obtenir les valeurs de configuration nécessaires du Red Hat Update Agent. S'il est exécuté en tant qu'un utilisateur autre que super-utilisateur, il sera peut-être nécessaire d'apporter des modifications de configuration dans le fichier ~/.rhncfgrc. Le fichier de session est mis en cache dans ~/.rhncfg-manager-session afin d'éviter de devoir se connecter à chaque commande.
Le délai d'expiration par défaut pour le Red Hat Network Configuration Manager est de 30 minutes. Pour modifier cette durée, ajoutez l'option server.session_lifetime ainsi qu'une nouvelle valeur dans le fichier /etc/rhn/rhn.conf présent sur le serveur exécutant le gestionnaire, comme dans l'extrait ci-dessous :
server.session_lifetime = 120
Copy to Clipboard Toggle word wrap
Le Red Hat Network Configuration Manager offre les modes primaires suivants : add, create-channel, diff, diff-revisions, download-channel, get, list, list-channels, remove, remove-channel, revisions, update et upload-channel.
Chaque mode offre son propre ensemble d'options qui peuvent être affichées en exécutant la commande suivante :
rhncfg-manager mode --help 
Copy to Clipboard Toggle word wrap
Remplacez mode par le nom du mode à inspecter.
rhncfg-manager diff-revisions --help
Copy to Clipboard Toggle word wrap
Vous pouvez consulter une telle liste d'options pour le mode add (ajouter) dans le Tableau 1.4, « options de rhncfg-manager add ».

1.1.3.1. Création d'un canal de configuration

Pour créer un canal de configuration pour votre organisation, exécutez la commande suivante :
rhncfg-manager create-channel channel-label
Copy to Clipboard Toggle word wrap
Si le système demande votre nom d'utilisateur et mot de passe pour Red Hat Satellite, saisissez-les. Une sortie semblable à celle reproduite ci-dessous devrait apparaître :
Red Hat Network username: rhn-user
Password:
Creating config channel channel-label Config channel channel-label created
Copy to Clipboard Toggle word wrap
Une fois que vous avez créé un canal de configuration, utilisez les modes restants affichés ci-dessus pour peupler et maintenir ce canal.

1.1.3.2. Ajout de fichiers au canal de configuration

Pour ajouter un fichier au canal de configuration, vous devez préciser l'étiquette du canal ainsi que le fichier local à télécharger, comme le montre l'extrait ci-dessous :
rhncfg-manager add --channel=channel-label /path/to/file
Copy to Clipboard Toggle word wrap
Outre l'étiquette de canal et le chemin vers le fichier, vous pouvez utiliser les options disponibles pour modifier le fichier lors de son ajout. Par exemple, vous pouvez modifier le chemin d'accès et le nom du fichier en incluant l'option --dest-file dans la ligne de commande, comme dans l'extrait ci-dessous :
rhncfg-manager add --channel=channel-label --dest-file=/new/path/to/file.txt/path/to/file
Copy to Clipboard Toggle word wrap
Une sortie semblable à celle reproduite ci-dessous devrait apparaître :
Pushing to channel example-channel
Local file >/path/to/file -> remote file /new/path/to/file.txt
Copy to Clipboard Toggle word wrap
La table suivante liste les options disponibles pour rhncfg-manager add :
Expand
Tableau 1.4. options de rhncfg-manager add
Option Description
-c CHANNEL --channel=CHANNEL Télécharge des fichiers dans ce canal de configuration
-d DEST_FILE --dest-file=DEST_FILE Télécharge le fichier comme ce chemin
--delim-start=DELIM_START Commencer le délimiteur pour l'interpolation de variables
--delim-end=DELIM_END Finir le délimiteur pour l'interpolation de variables
-i, --ignore-missing Ignore les fichiers locaux manquants
--selinux-context=SELINUX_CONTEXT Écrase le contexte SELinux
-h, --help Affiche le message d'aide et quitte

Note

Par défaut, la taille maximale des fichiers de configuration est 128 Ko. Si vous devez changer cette valeur, recherchez ou créez la ligne suivante dans le fichier /etc/rhn/rhn.conf :
web.maximum_config_file_size=128
Copy to Clipboard Toggle word wrap
En outre, recherchez ou créez la ligne suivante dans le fichier /etc/rhn/rhn.conf :
maximum_config_file_size=128
Copy to Clipboard Toggle word wrap
Dans les deux emplacements, veuillez remplacer 128 par la valeur limite que vous souhaitez, en octets.
Pour afficher les différences entre les fichiers de configuration stockés sur disque et les dernières révisions sur le canal, exécutez la commande suivante :
rhncfg-manager diff --channel=channel-label --dest-file=/path/to/file.txt \ /local/path/to/file
Copy to Clipboard Toggle word wrap
Une sortie semblable à celle reproduite ci-dessous devrait apparaître :
--- /tmp/dest_path/example-config.txt config_channel: example-channel revision: 1
+++ /home/test/blah/hello_world.txt 2003-12-14 19:08:59.000000000 -0500
@@ -1 +1 @@
-foo
+hello, world
Copy to Clipboard Toggle word wrap
La table suivante liste les options disponibles pour rhncfg-manager diff :
Expand
Tableau 1.5. options de rhncfg-manager diff
Option Description
-c CHANNEL, --channel=CHANNEL Obtenir des fichiers de ce canal de configuration
-r REVISION, --revision=REVISION Utiliser cette révision
-d DEST_FILE, --dest-file=DEST_FILE Télécharge le fichier comme ce chemin
-t TOPDIR, --topdir=TOPDIR Rend tous les fichiers relatifs à cette chaîne
-h, --help Affiche le message d'aide et quitte

1.1.3.4. Différences entre différentes versions

Pour comparer différentes versions d'un fichier parmi les canaux et révisions, utilisez l'option -r pour indiquer la révision spécifique du fichier à laquelle le fichier même devrait être comparé et l'option -n pour identifier les deux canaux devant être vérifiés. Reportez-vous à la Section 1.1.3.11, « Détermination du nombre de révisions d'un fichier  » pour obtenir des informations en relation avec le sujet. Spécifiez ici un seul nom de fichier dans la mesure où vous comparez le fichier à une autre version du même fichier comme le montre l'extrait ci-dessous :
rhncfg-manager diff-revisions -n=channel-label1 -r=1 -n=channel-label2 -r=1 /path/to/file.txt
Copy to Clipboard Toggle word wrap
Une sortie semblable à celle reproduite ci-dessous devrait apparaître :
--- /tmp/dest_path/example-config.txt 2004-01-13 14:36:41 \ config channel: example-channel2 revision: 1
--- /tmp/dest_path/example-config.txt 2004-01-13 14:42:42 \ config channel: example-channel3 revision: 1
@@ -1 +1,20 @@
-foo
+blah
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG v1.0.6 (GNU/Linux)
+Comment: For info see http://www.gnupg.org
+
+iD8DBQA9ZY6vse4XmfJPGwgRAsHcAJ9ud9dabUcdscdcqB8AZP7e0Fua0NmKsdhQCeOWHX +VsDTfen2NWdwwPaTM+S+Cow=
+=Ltp2
+-----END PGP SIGNATURE-----
Copy to Clipboard Toggle word wrap
La table suivante liste les options disponibles pour rhncfg-manager diff-revisions :
Expand
Tableau 1.6. options de rhncfg-manager diff-revisions
Option Description
-c CHANNEL, --channel=CHANNEL Utiliser ce canal de configuration
-r REVISION, --revision=REVISION Utiliser cette révision
-h, --help Affiche le message d'aide et quitte

1.1.3.5. Téléchargement de tous les fichiers d'un canal

Pour télécharger tous les fichiers d'un canal sur le disque, créez un répertoire et exécutez la commande suivante :
rhncfg-manager download-channel channel-label --topdir . 
Copy to Clipboard Toggle word wrap
Une sortie semblable à celle reproduite ci-dessous devrait apparaître :
Copying /tmp/dest_path/example-config.txt -> \ blah2/tmp/dest_path/example-config.txt
Copy to Clipboard Toggle word wrap
La table suivante liste les options disponibles pour rhncfg-manager download-channel :
Expand
Tableau 1.7. options de rhncfg-manager download-channel
Option Description
-t TOPDIR, --topdir=TOPDIR Répertoire auquel tous les chemins de fichiers sont associés. Cette option doit être définie.
-h, --help Affiche le message d'aide et quitte

1.1.3.6. Obtention du contenu d'un fichier

Pour diriger le contenu d'un fichier spécifique vers la sortie standard (stdout), exécutez la commande suivante :
rhncfg-manager get --channel=channel-label \ /tmp/dest_path/example-config.txt 
Copy to Clipboard Toggle word wrap
Vous devriez voir le contenu du fichier en sortie.

1.1.3.7. Listage de tous les fichiers d'un canal

Pour dresser la liste de tous les fichiers d'un canal, exécutez la commande suivante :
rhncfg-manager list channel-label
Copy to Clipboard Toggle word wrap
Une sortie semblable à celle reproduite ci-dessous devrait apparaître :
Files in config channel `example-channel3': /tmp/dest_path/example-config.txt
Copy to Clipboard Toggle word wrap
La table suivante liste les options disponibles pour rhncfg-manager get :
Expand
Tableau 1.8. options de rhncfg-manager get
Option Description
-c CHANNEL, --channel=CHANNEL Obtenir des fichiers de ce canal de configuration
-t TOPDIR, --topdir=TOPDIR Rend tous les fichiers relatifs à cette chaîne
-r REVISION, --revision=REVISION Obtenir la révision de ce fichier
-h, --help Affiche le message d'aide et quitte

1.1.3.8. Listage de tous les canaux de configuration

Pour dresser la liste de tous les canaux de configuration de votre organisation, exécutez la commande suivante :
rhncfg-manager list-channels 
Copy to Clipboard Toggle word wrap
Une sortie semblable à celle reproduite ci-dessous devrait apparaître :
Available config channels: example-channel example-channel2 example-channel3 config-channel-14 config-channel-17
Copy to Clipboard Toggle word wrap
Notez que cette opération ne dresse pas la liste de canaux local_override ou server_import

1.1.3.9. Suppression d'un fichier dans un canal

Pour supprimer un fichier dans un canal, exécutez la commande suivante :
rhncfg-manager remove --channel=channel-label /tmp/dest_path/example-config.txt
Copy to Clipboard Toggle word wrap
Si le système demande votre nom d'utilisateur et mot de passe pour Red Hat Network, saisissez-les. Une sortie semblable à celle reproduite ci-dessous devrait apparaître :
Red Hat Network username: rhn-user Password: Removing from config channel example-channel3 /tmp/dest_path/example-config.txt removed
Copy to Clipboard Toggle word wrap
La table suivante liste les options disponibles pour rhncfg-manager remove :
Expand
Tableau 1.9. options de rhncfg-manager remove
Option Description
-c CHANNEL, --channel=CHANNEL Supprimer les fichiers dans ce canal de configuration
-t TOPDIR, --topdir=TOPDIR Rend tous les fichiers relatifs à cette chaîne
-h, --help Affiche le message d'aide et quitte

1.1.3.10. Suppression d'un canal de configuration

Pour supprimer un canal de configuration dans votre organisation, exécutez la commande suivante :
rhncfg-manager remove-channel channel-label 
Copy to Clipboard Toggle word wrap
Une sortie semblable à celle reproduite ci-dessous devrait apparaître :
Removing config channel example-channel Config channel example-channel removed
Copy to Clipboard Toggle word wrap

1.1.3.11. Détermination du nombre de révisions d'un fichier

Pour connaître le nombre de révisions (les révisions vont de 1 à N, N représentant un nombre entier supérieur à 0) d'un fichier/chemin d'accès existant dans un canal, exécutez la commande suivante :
rhncfg-manager revisions channel-label /tmp/dest_path/example-config.txt 
Copy to Clipboard Toggle word wrap
Une sortie semblable à celle reproduite ci-dessous devrait apparaître :
Analyzing files in config channel example-channel \ /tmp/dest_path/example-config.txt: 1
Copy to Clipboard Toggle word wrap

1.1.3.12. Mise à jour d'un fichier dans un canal

Pour créer une nouvelle révision d'un fichier dans un canal (ou ajouter la première révision à ce canal si aucune n'existait avant le chemin d'accès spécifié), exécutez la commande suivante :
rhncfg-manager update \ --channel=channel-label --dest-file=/path/to/file.txt /local/path/to/file
Copy to Clipboard Toggle word wrap
Une sortie semblable à celle reproduite ci-dessous devrait apparaître :
Pushing to channel example-channel: Local file example-channel/tmp/dest_path/example-config.txt -> \ remote file /tmp/dest_path/example-config.txt
Copy to Clipboard Toggle word wrap
La table suivante liste les options disponibles pour rhncfg-manager update :
Expand
Tableau 1.10. options de rhncfg-manager update
Option Description
-c CHANNEL, --channel=CHANNEL Télécharge des fichiers dans ce canal de configuration
-d DEST_FILE, --dest-file=DEST_FILE Télécharge le fichier comme ce chemin
-t TOPDIR, --topdir=TOPDIR Rend tous les fichiers relatifs à cette chaîne
--delim-start=DELIM_START Commencer le délimiteur pour l'interpolation de variables
--delim-end=DELIM_END Finir le délimiteur pour l'interpolation de variables
-h, --help Affiche le message d'aide et quitte
Pour télécharger plusieurs fichiers dans un canal de configuration depuis un disque local et en une seule opération, exécutez la commande suivante :
rhncfg-manager upload-channel --topdir=topdir channel-label
Copy to Clipboard Toggle word wrap
Une sortie semblable à celle reproduite ci-dessous devrait apparaître :
Using config channel example-channel4 Uploading /tmp/ola_world.txt from blah4/tmp/ola_world.txt
Copy to Clipboard Toggle word wrap
La table suivante liste les options disponibles pour rhncfg-manager upload-channel :
Expand
Tableau 1.11. options de rhncfg-manager upload-channel
Option Description
-t TOPDIR, --topdir=TOPDIR Répertoire auquel tous les chemins de fichiers sont associés
-c CHANNEL, --channel=CHANNEL Liste des canaux dans lesquels les informations de configuration seront téléchargées. Les canaux sont délimités par ",". Par exemple : --channel=foo,bar,baz
-h, --help Affiche le message d'aide et quitte
Retour au début
Red Hat logoGithubredditYoutubeTwitter

Apprendre

Essayez, achetez et vendez

Communautés

À propos de la documentation Red Hat

Nous aidons les utilisateurs de Red Hat à innover et à atteindre leurs objectifs grâce à nos produits et services avec un contenu auquel ils peuvent faire confiance. Découvrez nos récentes mises à jour.

Rendre l’open source plus inclusif

Red Hat s'engage à remplacer le langage problématique dans notre code, notre documentation et nos propriétés Web. Pour plus de détails, consultez le Blog Red Hat.

À propos de Red Hat

Nous proposons des solutions renforcées qui facilitent le travail des entreprises sur plusieurs plates-formes et environnements, du centre de données central à la périphérie du réseau.

Theme

© 2025 Red Hat