Kapitel 35 Starten und Verwalten des IPQoS (Aufgaben)

Dieses Kapitel enthält Aufgaben zum Aktivieren einer IPQoS-Konfigurationsdatei sowie zum Protokollieren von IPQoS-bezogenen Ereignissen. Es umfasst die folgenden Themen:

Verwalten des IPQoS (Übersicht der Schritte)

In diesem Abschnitt sind Aufgaben zum Starten und Verwalten des IPQoS auf einem Oracle Solaris-System beschrieben. Bevor Sie diese Aufgaben durchführen können, müssen Sie eine vollständige IPQoS-Konfigurationsdatei erstellt haben. Informationen hierzu finden Sie unter Definieren einer QoS-Richtlinie in der IPQoS-Konfigurationsdatei (Übersicht der Schritte).

In der folgenden Tabelle werden diese Aufgaben aufgeführt und beschrieben. Außerdem enthält die Tabelle Links zu den Abschnitten, in denen beschrieben ist, wie diese Aufgaben ausgeführt werden.

Aufgabe	Beschreibung	Siehe
1. Konfiguration von IPQoS auf einem System.	Geben Sie den Befehl `ipqosconf` ein, um die IPQoS-Konfigurationsdatei auf einem System zu aktivieren.	So übernehmen Sie eine neue Konfigurationen für die IPQoS-Kernel-Module
2. Konfiguration der Oracle Solaris-Startskripten, so dass sie die geprüfte IPQoS-Konfigurationsdatei nach jedem Systemstart anwenden.	Stellen Sie sicher, dass die IPQoS-Konfiguration bei jedem Systemstart übernommen wird.	So stellen Sie sicher, dass die IPQoS-Konfiguration bei jedem Systemstart übernommen wird.
3. Konfiguration von `syslog` zum Protokollieren für IPQoS.	Fügen Sie einen Eintrag hinzu, um `syslog` zum Protokollieren von IPQoS-Nachrichten zu aktivieren.	So aktivieren Sie die Protokollierung von IPQoS-Nachrichten während des Bootens.
4. Bereinigen aller eventuell aufgetretenen IPQoS-Probleme.	Beheben Sie alle eventuell aufgetretenen IPQoS-Probleme anhand der Fehlermeldungen.	Lesen Sie dazu die Fehlermeldungen in Tabelle 35–1.

Übernehmen einer IPQoS-Konfiguration

Mit dem Befehl ipqosconf aktivieren und ändern Sie eine IPQoS-Konfiguration.

So übernehmen Sie eine neue Konfigurationen für die IPQoS-Kernel-Module

Geben Sie den Befehl ipqosconf ein, um die IPQoS-Konfigurationsdatei einzulesen und um die IPQoS-Module im UNIX-Kernel zu konfigurieren. Im folgenden Verfahren wird die unter Creating IPQoS Configuration Files for Web Servers erstellte Datei Erstellen von IPQoS-Konfigurationsdateien für Webserver als Beispiel verwendet. Ausführliche Informationen finden Sie in der Manpage ipqosconf(1M).

Nehmen Sie die Rolle eines Primäradministrators an, oder melden Sie sich als Superuser bei dem IPQ-konformen System an.

Die Rolle des Primäradministrators enthält das Primary Administrator-Profil. Informationen zum Erstellen von Rollen und Zuweisen von Rollen zu Benutzern finden Sie in Kapitel 2, Working With the Solaris Management Console (Tasks) in System Administration Guide: Basic Administration.

Übernehmen Sie die neue Konfiguration.
# /usr/sbin/ipqosconf -a/var/ipqos/Goldweb.qos
ipqosconf schreibt die Informationen aus der angegebenen IPQoS-Konfigurationsdatei in die IPQoS-Module im Oracle Solaris-Kernel. In diesem Beispiel werden die Inhalte der Datei /var/ipqos/Goldweb.qos für den aktuellen Oracle Solaris-Kernel übernommen.

Hinweis –
Wenn Sie eine IPQoS-Konfigurationsdatei mit der Option -a übernehmen, gelten die Aktionen in der Datei nur für die aktuelle Sitzung.

Testen und bereinigen Sie die neue IPQoS-Konfiguration.

Verwenden Sie UNIX-Serviceprogramme, um das IPQo-Verhalten zu verfolgen und erfassen Sie Statistiken zu Ihrer IPQoS-Implementierung. Diese Informationen helfen Ihnen festzustellen, ob die Konfiguration gemäß den Erwartungen funktioniert.

Siehe auch

Informationen zum Anzeigen von Statistiken zu den IPQoS-Modulen finden Sie unter Erfassen statistischer Informationen.
Informationen zum Protokollieren der ipqosconf-Nachrichten finden Sie unter Aktivieren von syslog zum Protokollieren von IPQoS-Nachrichten.
Informationen, wie Sie sicherstellen, dass die aktuelle IPQoS-Konfiguration bei jedem Systemstart übernommen wird, finden Sie unter So stellen Sie sicher, dass die IPQoS-Konfiguration bei jedem Systemstart übernommen wird.

So stellen Sie sicher, dass die IPQoS-Konfiguration bei jedem Systemstart übernommen wird

Sie müssen explizit konfigurieren, dass eine IPQoS-Konfiguration bei jedem Neustart übernommen wird. Andernfalls gilt die aktuelle Konfiguration nur für die aktuelle Sitzung. Wenn IPQoS korrekt auf einem System arbeitet, führen Sie die folgenden Schritte aus, um sicherzustellen, dass die Konfiguration bei jedem Neustart übernommen wird.

Nehmen Sie die Rolle eines Primäradministrators an, oder melden Sie sich als Superuser bei dem IPQ-konformen System an.

Die Rolle des Primäradministrators enthält das Primary Administrator-Profil. Informationen zum Erstellen von Rollen und Zuweisen von Rollen zu Benutzern finden Sie in Kapitel 2, Working With the Solaris Management Console (Tasks) in System Administration Guide: Basic Administration.

Prüfen Sie auf das Vorhandensein einer IPQoS-Konfiguration in den Kernel-Modulen.
# ipqosconf -l
Wenn eine Konfiguration vorhanden ist, zeigt der Befehl ipqosconf die Konfiguration auf dem Bildschirm an. Wird keine Ausgabe angezeigt, übernehmen Sie die Konfiguration gemäß der Beschreibung unter So übernehmen Sie eine neue Konfigurationen für die IPQoS-Kernel-Module.

Stellen Sie sicher, dass die vorhandene IPQoS-Konfiguration bei jedem Neustart des IPQoS-Systems übernommen wird.
# /usr/sbin/ipqosconf -c
Die Option -c sorgt dafür, dass die aktuelle IPQoS-Konfiguration in der Boot-Konfigurationsdatei /etc/inet/ipqosinit.conf vorhanden ist.

Aktivieren von `syslog` zum Protokollieren von IPQoS-Nachrichten

Zum Aufzeichnen von Nachrichten, die beim Booten von IPQoS erzeugt werden, müssen Sie die Datei /etc/syslog.conf wie im Folgenden gezeigt ändern.

So aktivieren Sie die Protokollierung von IPQoS-Nachrichten während des Bootens

Nehmen Sie die Rolle eines Primäradministrators an, oder melden Sie sich als Superuser bei dem IPQ-konformen System an.

Die Rolle des Primäradministrators enthält das Primary Administrator-Profil. Informationen zum Erstellen von Rollen und Zuweisen von Rollen zu Benutzern finden Sie in Kapitel 2, Working With the Solaris Management Console (Tasks) in System Administration Guide: Basic Administration.

Öffnen Sie die Datei /etc/syslog.conf.

Fügen Sie den folgenden Text als letzten Eintrag in die Datei ein.
user.info /var/adm/messages
Verwenden Sie Tabulatoren anstelle von Leerzeichen zwischen den Spalten.

Der Eintrag protokolliert alle Nachrichten, die von IPQoS beim Booten erzeugt werden, in der Datei /var/adm/messages.

Booten Sie das System neu, um die Nachrichten zu übernehmen.

Beispiel 35–1 IPQoS-Ausgabe von `/var/adm/messages`

Wenn Sie die /var/adm/messages nach einem Systemneustart anzeigen, könnte die Ausgabe die folgenden protokollierten IPQoS-Nachrichten enthalten.

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.

Eventuell werden auch die folgenden IPQoS-Fehlermeldungen in der /var/adm/messages-Datei des IPQoS-Systems angezeigt.

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.

Eine Beschreibung dieser Fehlermeldungen finden Sie in Tabelle 35–1.

Fehlerbehebung mit IPQoS-Fehlermeldungen

Dieser Abschnitt enthält von IPQoS erzeugte Fehlermeldungen sowie mögliche Abhilfemaßnahmen.

Tabelle 35–1 IPQoS-Fehlermeldungen


Fehlermeldung	Beschreibung	Lösung
`Unbestimmte Aktion in Parameter` `Parametername` `Aktion` `Aktionsname`	Der in `Parametername` angegebene Aktionsname existiert nicht in der IPQoS-Konfigurationsdatei.	Erstellen Sie die Aktion oder verweisen Sie auf eine andere vorhandene Aktion in dem Parameter.
`Aktion` `Aktionsname` `ist am Zyklus beteiligt.`	In der IPQoS-Konfigurationsdatei ist `Aktionsname` Teil eines Aktionszyklus, der laut IPQoS nicht zulässig ist.	Ermitteln Sie den Aktionszyklus. Dann entfernen Sie einen der zyklischen Verweise aus der IPQoS-Konfigurationsdatei.
`Aktion` `Aktionsname` `wird von keiner anderen Aktion referenziert`	Eine nicht-`ipgpc`-Aktionsdefinition wurde von keiner anderen in der IPQoS-Konfiguration definierten Aktionen referenziert. Dies ist laut IPQoS nicht gestattet.	Entfernen Sie die nicht referenzierte Aktion. Alternativ sorgen Sie dafür, dass eine andere Aktionsreferenz die derzeit nicht referenzierte Aktion referenziert.
`Fehlende/ungültige Konfigurationsdatei fmt_version`	Das Format der Konfigurationsdatei ist nicht als erster Eintrag der Datei angegeben. Dies ist jedoch eine Voraussetzung für IPQoS.	Fügen Sie die Formatversion gemäß den Angaben unter So erstellen Sie eine IPQoS-Konfigurationsdatei und definieren Datenverkehrsklassen hinzu.
`Nicht unterstützte Konfigurationsdatei-Formatversion`	Die in der Konfigurationsdatei angegebene Formatversion wird nicht von IPQoS unterstützt.	Ändern Sie die Formatversion zu `fmt_version 1.0`. Diese Formatversion ist zum Ausführen von Solaris 9 9/02 und höheren Versionen von IPQoS erforderlich.
`Keine ipgpc-Aktion definiert.`	Sie haben keine Aktion für den `ipgpc`-Classifier in der Konfigurationsdatei definiert. Dies ist jedoch eine Voraussetzung für IPQoS.	Definieren Sie eine Aktion für `ipgpc` gemäß den Angaben unter So erstellen Sie eine IPQoS-Konfigurationsdatei und definieren Datenverkehrsklassen.
`Es kann keine Null-Konfiguration vorgenommen werden`	Als Sie `ipqosconf -c` zur Bestätigung einer Konfiguration ausführen wollten, war diese Rekonfiguration leer. Dies ist laut IPQoS nicht zulässig.	Achten Sie darauf, eine Konfigurationsdatei zu übernehmen, bevor Sie versuchen, eine Konfiguration zu bestätigen. Anweisungen hierzu finden Sie unter So übernehmen Sie eine neue Konfigurationen für die IPQoS-Kernel-Module.
`Ungültige CIDR-Maske Zeile` `Zeilennummer`	In der Konfigurationsdatei haben Sie eine CIDR-Maske als Teil der IP-Adresse verwendet, die sich außerhalb des gültigen Bereichs für IP-Adressen befindet.	Ändern Sie den Wert der Maske so, dass er sich im Bereich von 1–32 für IPv4 und 1–128 für IPv6 befindet.
`Adressmasken sind unzulässig für Hostnamen Zeile` `Zeilennummer`	In der Konfigurationsdatei haben Sie eine CIDR-Maske für einen Hostnamen definiert, der in IPQoS nicht zulässig ist.	Entfernen Sie die Maske oder ändern Sie den Hostnamen zu einer IP-Adresse.
`Ungültiger Modulname, Zeile` `Zeilennummer`	In der Konfigurationsdatei ist der von Ihnen in einer action-Anweisung angegebenen Modulname ungültig.	Prüfen Sie die richtige Schreibweise des Modulnamens. Eine Liste der IPQoS-Module finden Sie unter Tabelle 37–5.
`ipgpc-Aktion weist falschen Namen auf, Zeile` `Zeilennummer`	Der Name, den Sie der `ipgpc`-Aktion in der Konfigurationsdatei gegeben haben, ist nicht der erforderliche `ipgpc.classify`-Name.	Benennen Sie die Aktion `ipgpc.classify` um.
`Zweite Parameterklausel nicht unterstützt, Zeile` `Zeilennummer`	In der Konfigurationsdatei haben Sie zwei Parameterklauseln für eine Aktion angegeben. Dies ist laut IPQoS nicht zulässig.	Kombinieren Sie alle Parameter für die Aktion in einer Parameterklausel.
`Gleichnamige Aktion`	In der Konfigurationsdatei haben zwei Aktionen den gleichen Namen.	Benennen Sie eine der Aktionen um, oder löschen Sie sie.
`Gleichnamiger Filter/Klasse in Aktion` `Aktionsname`	Sie haben zwei Filtern oder zwei Klassen in der gleichen Aktion denselben Namen gegeben. Dies ist in der IPQoS-Konfigurationsdatei nicht zulässig.	Benennen Sie einen der Filter bzw. eine der Klassen um, oder löschen Sie sie.
`Unbestimmte Klasse in Filter` `Filtername` `Aktion` `Aktionsname`	In der Konfigurationsdatei verweist der Filter auf eine Klasse, die nicht in der Aktion definiert ist.	Erstellen Sie die Klasse oder ändern Sie den Filterverweis auf eine bereits existierende Klasse.
`Unbestimmte Aktion in Klasse` `Klassenname` `Aktion` `Aktionsname`	Die Klasse verweist auf eine Aktion, die nicht in der Konfigurationsdatei definiert ist.	Erstellen Sie die Aktion oder ändern Sie den Verweis auf eine bereits existierende Aktion.
`Ungültige Parameter für Aktion` `Aktionsname`	Einer der Parameter in der Konfigurationsdatei ist ungültig.	Lesen Sie den Moduleintrag unter IPQoS-Architektur und das Diffserv-Modell für das Modul, das von der angegebenen Aktion aufgerufen wird. Alternativ lesen Sie die Manpage `ipqosconf`(1M).
`Obligatorischer Parameter fehlt für Aktion` `Aktionsname`	Ein für die Aktion erforderlicher Parameter ist in der Konfigurationsdatei nicht definiert.	Lesen Sie den Moduleintrag unter IPQoS-Architektur und das Diffserv-Modell für das Modul, das von der angegebenen Aktion aufgerufen wird. Alternativ lesen Sie die Manpage `ipqosconf`(1M).
`In ipgpc wurde die max. Klassenanzahl erreicht`	Sie haben mehr Klassen als zulässig in der `ipgpc`-Aktion der IPQoS-Konfigurationsdatei angegeben. Die maximal zulässige Anzahl beträgt 10007.	Prüfen Sie die Konfigurationsdatei und entfernen Sie unnötige Klassen. Alternativ heben Sie die maximale Klassenanzahl an, indem Sie der `/etc/system`-Datei den Eintrag `ipgpc_max_classesAnzahl-an-Klassen` hinzufügen.
`In der Aktion ipgpc wurde die max. Filteranzahl erreicht`	Sie haben mehr Filter als zulässig in der `ipgpc`-Aktion der IPQoS-Konfigurationsdatei angegeben. Die maximal zulässige Anzahl beträgt 10007.	Prüfen Sie die Konfigurationsdatei und entfernen Sie unnötige Filter. Alternativ heben Sie die maximale Filteranzahl an, indem Sie der `/etc/system`-Datei den Eintrag `ipgpc_max_filters` `Anzahl-an-Filtern` hinzufügen.
`Ungültige/fehlende Parameter für Filter` `Filtername` `in Aktion ipgpc`	In der Konfigurationsdatei weist der Filter `Filtername` einen ungültigen oder fehlenden Parameter auf.	Eine Liste der gültigen Parameter finden Sie in der Manpage `ipqosconf`(1M).
`Name darf nicht mit '!' beginnen, Zeile` `Zeilennummer`	Sie haben eine Aktion, ein Filter oder einen Klassennamen mit einem Ausrufezeichen (!) begonnen, was in IPQoS-Dateien nicht zulässig ist.	Entfernen Sie das Ausrufezeichen oder benennen Sie die Aktion, Klasse bzw. den Filter um.
`Name überschreitet maximale Länge Zeile` `Zeilennummer`	Sie haben einen Namen für eine Aktion, eine Klasse oder einen Filter in der Konfigurationsdatei definiert, der die maximale Länge von 23 Zeichen überschreitet.	Weisen Sie der Aktion, der Klasse oder dem Filter einen kürzeren Namen zu.
`Array-Deklaration Zeile` `Zeilennummer` `ist ungültig`	In der Konfigurationsdatei ist die Array-Deklaration für den Parameter in der Zeile `Zeilennummer` ungültig.	Die korrekte Syntax der Array-Deklaration, die von der `action`-Anweisung mit dem ungültigen Array aufgerufen wird, finden Sie unter IPQoS-Architektur und das Diffserv-Modell. Alternativ lesen Sie die Manpage `ipqosconf`(1M).
`Zeichenkette in Anführungszeichen überschreitet Zeile, Zeile ,` `Zeilennummer`	Diese Zeichenkette weist keine Beendigungs-Anführungszeichen in der gleichen Zeile auf. Dies ist in der Konfigurationsdatei erforderlich.	Achten Sie darauf, dass die entsprechende Zeichenkette auf einer Zeile in der Konfigurationsdatei beginnt und endet.
`Ungültiger Wert, Zeile` `Zeilennummer`	Der in `Zeilennummer` der Konfigurationsdatei angegebene Wert wird für den Parameter nicht unterstützt.	Gültige Werte für das Modul, das von der `action`-Anweisung aufgerufen wird, entnehmen Sie der Modulbeschreibung unter IPQoS-Architektur und das Diffserv-Modell. Alternativ lesen Sie die Manpage `ipqosconf`(1M).
`Nicht erkannter Wert, Zeile` `Zeilennummer`	Der Wert in `Zeilennummer` der Konfigurationsdatei ist kein unterstützter Aufzählungswert für diesen Parameter.	Prüfen Sie, ob der Aufzählungswert für diesen Parameter korrekt ist. Eine Beschreibung des Moduls, das von der `action`-Anweisung mit der nicht erkannten Zeilennummer aufgerufen wurde, finden Sie unter IPQoS-Architektur und das Diffserv-Modell. Alternativ lesen Sie die Manpage `ipqosconf`(1M).
`Falsch formatierte Werteliste Zeile` `Zeilennummer`	Die in `Zeilennummer` der Konfigurationsdatei angegebene Aufzählung entspricht nicht der Spezifikationssyntax.	Die korrekte Syntax für das Modul, das von der `action`-Anweisung mit der falsch formatierten Werteliste aufgerufen wurde, entnehmen Sie der Modulbeschreibung unter IPQoS-Architektur und das Diffserv-Modell. Alternativ lesen Sie die Manpage `ipqosconf`(1M).
`Doppelter Parameter Zeile` `Zeilennummer`	Ein doppelter Parameter wurde in `Zeilennummer` angegeben. Dies ist in der Konfigurationsdatei nicht zulässig.	Entfernen Sie einen der doppelten Parameter.
`Ungültiger Aktionsname Zeile` `Zeilennummer`	Sie haben der Aktion in `Zeilennummer` der Konfigurationsdatei einen Namen gegeben, der den vordefinierten Namen „continue“ oder „drop“ verwendet.”	Benennen Sie die Aktion um, so dass sie keinen vordefinierten Namen verwendet.
`Fehler bei Auflösung des Ursprungs-/Zielhostnamens für Filter in Zeile` `Zeilennummer, Filter wird ignoriert`	`ipqosconf` konnte die Ursprungs- oder Zieladresse nicht auflösen, die für den angegebenen Filter in der Konfigurationsdatei definiert wurde. Aus diesem Grund wird der Filter ignoriert.	Wenn der Filter wichtig ist, versuchen Sie die Konfiguration zu einem späteren Zeitpunkt zu übernehmen.
`Inkompatible Adressversion Zeile` `Zeilennummer`	Die IP-Version der Adresse in `Zeilennummer` ist inkompatibel mit der Version einer zuvor angegebenen IP-Adresse oder dem Parameter `ip_version`.	Ändern Sie die beiden widersprüchlichen Einträge, so dass sie kompatibel sind.
`Aktion in Zeile` `Zeilennummer` `hat den Namen wie die aktuell installierte Aktion, gilt aber für ein anderes Modul`	Sie versuchten, das Modul einer Aktion zu ändern, das bereits in der IPQoS-Konfiguration des Systems vorhanden ist. Dies ist nicht zulässig.	Leeren Sie die aktuelle Konfiguration, bevor Sie die neue Konfiguration übernehmen.