Guide d'administration système : services IP

Chapitre 35 Démarrage et maintenance d'IPQoS (tâches)

Ce chapitre inclut les tâches destinées à activer un fichier de configuration IPQoS et à consigner les événements en rapport avec IPQoS. Il aborde les sujets suivants :

Administration d'IPQoS (liste des tâches)

Cette section répertorie l'ensemble des tâches visant à démarrer et à gérer IPQoS sur un système Oracle Solaris. Avant d'utiliser ces tâches, vous devez disposer d'un fichier de configuration IPQoS complet comme décrit dans la section Définition d'une stratégie QoS dans le fichier de configuration IPQoS (liste des tâches).

Le tableau suivant répertorie et décrit ces tâches et contient des liens vers les sections expliquant en détails comment effectuer ces tâches.

Tâche 

Description 

Voir 

1. Configurez IPQoS sur un système. 

Exécutez la commande ipqosconf pour activer le fichier de configuration IPQoS sur un système.

Application d'une nouvelle configuration aux modules de noyau IPQoS

2. Assurez-vous que les scripts de démarrage Oracle Solaris sont appliqués au fichier de configuration IPQoS débogué après chaque initialisation du système. 

Veillez à ce que le fichier de configuration IPQoS soit appliqué chaque fois que le système redémarre. 

Vérification de l'application de la configuration IPQoS après chaque redémarrage.

3. Activez la journalisation de syslog pour IPQoS.

Ajoutez une entrée pour activer la journalisation par syslog des messages IPQoS.

Activation de la journalisation des messages IPQoS lors de l'initialisation.

4. Résolvez tout problème éventuel lié à IPQoS. 

Vérifiez les messages d'erreur pour dépanner IPQoS. 

Reportez-vous aux messages d'erreur figurant dans le Tableau 35–1.

Application d'une configuration IPQoS

Vous activez ou effectuez toute autre opération pour le fichier de configuration IPQoS à l'aide de la commande ipqosconf.

ProcedureApplication d'une nouvelle configuration aux modules de noyau IPQoS

Vous exécutez la commande ipqosconf pour lire le fichier de configuration IPQoS et pour configurer les modules IPQoS dans le noyau UNIX. La procédure suivante présente le fichier /var/ipqos/Goldweb.qos, en guise d'exemple, créé dans la section Création de fichiers de configuration IPQoS pour les serveurs Web. Pour obtenir des informations détaillées, reportez-vous à la page de manuel ipqosconf(1M).

  1. Prenez le rôle d'administrateur principal ou connectez-vous en tant que superutilisateur dans le système IPQoS.

    Le rôle d'administrateur principal inclut le profil d'administrateur principal. Pour plus d'informations sur la création d'un rôle et son assignation à un utilisateur, reportez-vous au Chapitre 2, Working With the Solaris Management Console (Tasks) du System Administration Guide: Basic Administration.

  2. Appliquez la nouvelle configuration.


    # /usr/sbin/ipqosconf -a/var/ipqos/Goldweb.qos
    

    La commande ipqosconf consigne les informations du fichier de configuration IPQoS spécifié dans les modules IPQoS du noyau Oracle Solaris. Dans cet exemple, les informations du fichier /var/ipqos/Goldweb.qos sont appliquées au noyau Oracle Solaris actuel.


    Remarque –

    Lorsque vous appliquez un fichier de configuration IPQoS avec l'option -a, les actions dans le fichier sont actives seulement pour la session en cours.


  3. Testez et déboguez la nouvelle configuration IPQoS.

    Les utilitaires UNIX permettent d'effectuer le suivi du comportement d'IPQoS et de recueillir des statistiques sur votre mise en œuvre IPQoS. Ces informations vous aident à déterminer si la configuration fonctionne comme prévu.

Voir aussi

ProcedureVérification de l'application de la configuration IPQoS après chaque redémarrage

Vous devez rendre explicite la persistance de la configuration IPQoS d'un redémarrage à l'autre. Sinon, la configuration actuelle n'a d'effet que jusqu'au redémarrage système suivant. Lorsque IPQoS fonctionne convenablement sur un système, procédez comme suit pour définir la configuration de manière permanente.

  1. Prenez le rôle d'administrateur principal ou connectez-vous en tant que superutilisateur dans le système IPQoS.

    Le rôle d'administrateur principal inclut le profil d'administrateur principal. Pour plus d'informations sur la création d'un rôle et son assignation à un utilisateur, reportez-vous au Chapitre 2, Working With the Solaris Management Console (Tasks) du System Administration Guide: Basic Administration.

  2. Testez l'existence d'une configuration IPQoS dans des modules de noyau.


    # ipqosconf -l
    

    Si une configuration existe déjà, ipqosconf affiche la configuration à l'écran. En l'absence de sortie, appliquez la configuration comme indiqué à la section Application d'une nouvelle configuration aux modules de noyau IPQoS.

  3. Assurez-vous que la configuration IPQoS existante est appliquée chaque fois que le système IPQoS redémarre.


    # /usr/sbin/ipqosconf -c
    

    L'option -c permet d'ajouter la configuration IPQoS actuelle dans le fichier de configuration /etc/inet/ipqosinit.conf lors de l'initialisation.

Activation de la journalisation des messages IPQoS syslog

Pour enregistrer des messages IPQoS lors de l'initialisation, vous devez modifier le fichier /etc/syslog.conf comme indiqué dans la procédure suivante.

ProcedureActivation de la journalisation des messages IPQoS lors de l'initialisation

  1. Prenez le rôle d'administrateur principal ou connectez-vous en tant que superutilisateur dans le système IPQoS.

    Le rôle d'administrateur principal inclut le profil d'administrateur principal. Pour plus d'informations sur la création d'un rôle et son assignation à un utilisateur, reportez-vous au Chapitre 2, Working With the Solaris Management Console (Tasks) du System Administration Guide: Basic Administration.

  2. Ouvrez le fichier /etc/syslog.conf.

  3. Ajoutez le texte suivant comme ultime entrée du fichier.


    user.info                 /var/adm/messages
    

    Insérez des tabulations plutôt que des espaces entre les colonnes.

    L'entrée permet de journaliser tous les messages générés par IPQoS dans le fichier /var/adm/messages, lors de l'initialisation.

  4. Réinitialisez le système pour appliquer les messages.


Exemple 35–1 Sortie d'IPQoS du fichier /var/adm/messages

Lorsque vous affichez /var/adm/messages après le redémarrage système, la sortie peut contenir des messages de journalisation IPQoS similaires aux suivants.


May 14 10:44:33 ipqos-14 ipqosconf: [ID 815575 user.info]
 New configuration applied.
May 14 10:44:46 ipqos-14 ipqosconf: [ID 469457 user.info] 
Current configuration saved to init file.
May 14 10:44:55 ipqos-14 ipqosconf: [ID 435810 user.info]
Configuration flushed.

Des messages d'erreur IPQoS, identiques aux suivants, peuvent éventuellement apparaître dans le fichier /var/adm/messages du système IPQoS.


May 14 10:56:47 ipqos-14 ipqosconf: [ID 123217 user.error]
 Missing/Invalid config file fmt_version.
May 14 10:58:19 ipqos-14 ipqosconf: [ID 671991 user.error] 
No ipgpc action defined.

Pour obtenir la description de ces messages d'erreur, reportez-vous au Tableau 35–1.


Dépannage à l'aide des messages d'erreur IPQoS

Cette section contient le tableau des messages d'erreur qui sont générés par IPQoS ainsi que leurs solutions possibles.

Tableau 35–1 Messages d'erreur IPQoS

Message d'erreur 

Description 

Solution 

Undefined action in parameter nom du paramètre action nom de l'action

Dans le fichier de configuration IPQoS, le nom de l'action spécifiée pour parameter-name n'existe pas dans le fichier de configuration.

Créez l'action. Ou faites appel à une action différente existante dans le paramètre. 

action nom de l'action involved in cycle

Dans le fichier de configuration IPQoS, nom de l'action fait partie du cycle d'actions, ce qui n'est pas autorisé par IPQoS.

Déterminez le cycle d'actions. Supprimez ensuite une des références cycliques du fichier de configuration IPQoS. 

action nom de l'action isn't referenced by any other actions

Une définition d'action non ipgpc n'est pas référencée par d'autres actions définies dans le fichier de configuration IPQoS, ce qui n'est pas autorisé par IPQoS.

Supprimez l'action non référencée. Vous pouvez aussi faire en sorte qu'une action fasse référence à l'action actuellement sans référence. 

Missing/Invalid config file fmt_version

Le format du fichier du configuration n'est pas spécifié en tant que première entrée du fichier, ce qui est requis par IPQoS. 

Ajoutez la version du format comme indiqué dans la section Création du fichier de configuration IPQoS et définition des classes de trafic.

Unsupported config file format version

La version de format spécifiée dans le fichier de configuration n'est pas prise en charge par IPQoS. 

Remplacez la version du format par fmt_version 1.0, nécessaire pour exécuter Solaris 9 9/02 et les versions ultérieures d'IPQoS.

No ipgpc action defined.

Vous n'avez pas défini une action pour la classification ipgpc dans le fichier de configuration alors que cela est une exigence d'IPQoS.

Définissez une action pour ipgpc comme indiqué dans la section Création du fichier de configuration IPQoS et définition des classes de trafic.

Can't commit a null configuration

Lorsque vous avez exécuté ipqosconf -c pour valider une configuration, cette configuration était vide. Or, ce n'est pas autorisé par IPQoS.

Assurez-vous d'avoir appliqué un fichier de configuration avant de valider une configuration. Pour obtenir plus d'instructions, reportez-vous à la section Application d'une nouvelle configuration aux modules de noyau IPQoS.

Invalid CIDR mask on line numéro de la ligne

Dans le fichier de configuration, vous avez utilisé un masque CIDR en tant que partie de l'adresse IP qui se trouve hors de la plage des adresses IP valides.  

Changez la valeur du masque pour qu'elle soit comprise dans la page 1–32 pour IPv4 et 1–128 pour IPv6. 

Address masks aren't allowed for host names line numéro de la ligne

Dans le fichier de configuration, vous avez défini un masque CIDR en guise de nom d'hôte ce qui n'est pas autorisé dans IPQoS. 

Supprimez le masque ou remplacez le nom d'hôte par une adresse IP. 

Invalid module name line numéro de la ligne

Le nom du module spécifié dans une instruction d'action au sein du fichier de configuration est incorrect. 

Vérifiez l'orthographe du nom de module. Pour obtenir la liste des modules IPQoS, reportez-vous au Tableau 37–5.

ipgpc action has incorrect name line numéro de la ligne

Le nom assigné à l'action ipgpc dans le fichier de configuration ne correspond pas à l'action ipgpc.classify demandée.

Renommez l'action ipgpc.classify.

Second parameter clause not supported line numéro de la ligne

Dans le fichier de configuration, vous avez spécifié deux clauses de paramètres pour une seule action ce que IPQoS n'autorise pas. 

Combinez tous les paramètres faisant référence à l'action en une seule clause de paramètres. 

Duplicate named action

Dans le fichier de configuration, vous avez attribué le même nom à deux actions. 

Renommez ou supprimez une des actions. 

Duplicate named filter/class in action nom de l'action

Vous avez donné le même nom à deux filtres ou à deux classes de la même action, ce qui n'est pas autorisé dans le fichier de configuration IPQoS. 

Renommez ou supprimez une des classes. 

Undefined class in filter nom du filtre in action nom de l'action

Dans le fichier de configuration, le filtre fait référence à une classe qui n'est pas définie dans l'action. 

Créez la classe ou remplacez la référence de filtre par une classe déjà existante. 

Undefined action in class nom de la classe action nom de l'action

Le classe fait référence à une action non définie dans le fichier de configuration. 

Créez l'action ou remplacez la référence par une action déjà existante. 

Invalid parameters for action nom de l'action

Dans le fichier de configuration, un des paramètres est incorrect. 

Pour le module appelé par l'action nommée, reportez-vous à l'entrée du module figurant dans la section Architecture IPQoS et modèle Diffserv. Vous avez également la possibilité de consulter la page du manuel ipqosconf(1M).

Mandatory parameter missing for action nom de l'action

Vous n'avez pas défini un paramètre requis pour une action dans le fichier de configuration. 

Pour le module appelé par l'action nommée, reportez-vous à l'entrée du module figurant dans la section Architecture IPQoS et modèle Diffserv. Vous avez également la possibilité de consulter la page du manuel ipqosconf(1M).

Max number of classes reached in ipgpc

Vous avez spécifié plus de classes qu'il n'est permis de le faire dans l'action ipgpc du fichier de configuration IPQoS. Le nombre maximum est 10007.

Vérifiez le fichier de configuration et supprimez les classes inutiles. Une autre solution consiste à atteindre le nombre maximum de classes en ajoutant l'entrée ipgpc_max_classes nom de la classe au fichier /etc/system.

Max number of filters reached in action ipgpc

Vous avez spécifié plus de filtres qu'il n'est permis de le faire dans l'action ipgpc du fichier de configuration IPQoS. Le nombre maximum est 10007.

Vérifiez le fichier de configuration et supprimez les filtres inutiles. Vous pouvez aussi élever le nombre maximum de filtres en ajoutant l'entrée ipgpc_max_filters nombre de filtres au fichier /etc/system.

Invalid/missing parameters for filter nom du filtre in action ipgpc

Dans le fichier de configuration, le filtre nom du filtre comporte un paramètre non valide ou un paramètre est manquant.

Reportez-vous à la page de manuel ipqosconf(1M) pour obtenir la liste des paramètres corrects.

Name not allowed to start with '!', line numéro de la ligne

Un nom d'action, de filtre ou de classe doit commencer par un point d'exclamation mark (!), ce qui n'est pas autorisé dans le fichier IPQoS. 

Supprimez le point d'exclamation ou changez le nom de l'action, de la classe ou du filtre. 

Name exceeds the maximum name length line numéro de la ligne

Vous avez donné un nom à une action, une classe ou un filtre dans le fichier de configuration qui dépasse la longueur maximum de 23 caractères. 

Choisisse un nom d'action, de classe ou de filtre plus court. 

Array declaration line numéro de la ligne is invalid

Dans le fichier de configuration, la déclaration de tableau pour le paramètre sur la ligne numéro de la ligne n'est pas valide.

Pour définir correctement la syntaxe de déclaration de tableau appelée par l'instruction action avec le tableau non valide, reportez-vous à la section Architecture IPQoS et modèle Diffserv. Vous pouvez aussi consulter la page du manuel ipqosconf(1M).

Quoted string exceeds line, numéro de la ligne

La chaîne n'inclut pas les guillemets de fermeture sur la même ligne, ce qui est obligatoire dans le fichier de configuration. 

Assurez-vous que la chaîne comprise entre les guillemets commence et finit sur la même ligne dans le fichier de configuration. 

Invalid value, line numéro de la ligne

La valeur attribuée à la ligne numéro de la ligne du fichier de configuration n'est pas prise en charge par le paramètre.

Pour connaître les valeurs autorisées pour le module appelé par l'instruction action, reportez-vous à la description du module dans la section Architecture IPQoS et modèle Diffserv. Vous avez également la possibilité de consulter la page du manuel ipqosconf(1M).

Unrecognized value, line numéro de la ligne

La valeur du numéro de la ligne du fichier de configuration n'est pas une valeur d'énumération prise en charge par le paramètre.

Vérifiez la validité de la valeur d'énumération choisie pour le paramètre. Pour obtenir une description du module appelé par l'instruction action avec le numéro de ligne non reconnu, reportez-vous à la section Architecture IPQoS et modèle Diffserv. Vous avez également la possibilité de consulter la page du manuel ipqosconf(1M).

Malformed value list line numéro de la ligne

L'énumération spécifiée à la ligne numéro de la ligne du fichier de configuration n'est pas conforme à la syntaxe de spécification.

Pour en savoir plus sur la syntaxe correcte du module appelé par l'instruction action avec la liste de valeurs non conforme, reportez-vous à la description du module figurant à la section Architecture IPQoS et modèle Diffserv. Vous avez également la possibilité de consulter la page du manuel ipqosconf(1M).

Duplicate parameter line numéro de la ligne

Un paramètre en double a été spécifié à la ligne numéro de la ligne qui n'est pas autorisé dans le fichier de configuration.

Supprimez les paramètres en double. 

Invalid action name line numéro de la ligne

Vous avez attribué à l'action, ligne numéro de la ligne du fichier de configuration un nom correspondant à un des noms prédéfinis ("continue" ou "drop").

Renommez l'action de sorte que son nom diffère des noms prédéfinis. 

Failed to resolve src/dst host name for filter at line numéro de la ligne, ignoring filter

ipqosconf n'a pas pu résoudre l'adresse d'origine ou de destination définie pour le filtre concerné dans le fichier de configuration. En conséquence, le filtre n'est pas pris en compte.

Si le filtre est important, réessayez d'appliquer la configuration plus tard. 

Incompatible address version line numéro de la ligne

La version IP de l'adresse à la ligne numéro de la ligne est incompatible avec la version d'une adresse IP ou d'un paramètre version_ip déjà spécifié.

Modifiez les deux entrées en conflit de manière à ce qu'elles soient compatibles. 

Action at line numéro de la ligne has the same name as currently installed action, but is for a different module

Vous avez essayé de modifier le module d'une action qui existe déjà dans la configuration IPQoS du système, mais ce n'est pas autorisé. 

Videz la configuration actuelle avant d'appliquer la nouvelle configuration.