Benutzerdefinierte Variablen in dynamischen Profilen

In dynamischen Serviceprofilen können Sie mit Junos OS benutzerdefinierte Variablen auf Hierarchieebene [edit dynamic-profiles profile-name variables] konfigurieren und diese Variablen in der [edit dynamic-profiles] Hierarchie verwenden. Das dynamische Profil ruft während der Abonnentenauthentifizierung Daten für diese Variablen von einem externen Server (z. B. RADIUS) ab und ersetzt sie. Zur Laufzeit werden die Variablen durch tatsächliche Werte ersetzt und zur Konfiguration von Anwenderschnittstellen verwendet.

Sie können eine der folgenden Anweisungen verwenden, um benutzerdefinierte Variablen zu konfigurieren:

• default-value: Konfigurieren Sie einen Standardwert für eine benutzerdefinierte Variable in einem dynamischen Profil. Die Werte, die das System für diese Variablen verwendet, werden bei der Authentifizierung des Abonnenten angewendet. Durch die Angabe eines Standardwerts wird eine eigenständige Konfiguration für die zugeordnete Anweisung oder eine Sicherung für die Anweisungskonfiguration bereitgestellt, wenn auf den externen Server nicht zugegriffen werden kann oder er keinen Wert für die Variable enthält.

• equals– Konfigurieren Sie einen Ausdruck für eine benutzerdefinierte Variable, der zur Laufzeit ausgewertet und als Variablenwert zurückgegeben wird.

• mandatory– Geben Sie an, dass ein externer Server (z. B. RADIUS) einen Wert für die benutzerdefinierte Variable zurückgeben muss. Wenn der externe Server keinen Wert für die Variable zurückgibt, schlägt das dynamische Profil fehl.

• uid– Konfigurieren Sie eine eindeutige ID für parametrisierte Filter und CoS in einem dynamischen Profil, das für Services erstellt wurde.

• uid-reference: Konfigurieren Sie eine Variable, die auf eine eindeutige ID für parametrisierte Filter oder CoS in einem dynamischen Profil verweist, das für Services erstellt wurde.

Anmerkung:

Die Reihenfolge, in der Sie definieren, wie Variablen abgerufen werden, ist wichtig. Um sicherzustellen, dass Sie alle obligatorischen Variablen von einem externen Server abrufen und keine Werte aus Standardwerten oder durch Variablenausdrücke ableiten, müssen Sie zuerst alle obligatorischen Variablen definieren.

Mit Junos OS können Sie Ausdrücke – Gruppen von arithmetischen Operatoren, Zeichenfolgenoperatoren und Operanden – für die Verwendung als Variablen in dynamischen Profilen erstellen. Sie konfigurieren Variablenausdrücke auf Hierarchieebene [dynamic-profiles profile-name variables] . Zur Laufzeit werden die Variablenausdrücke berechnet und als Variablenwerte verwendet, um dynamische Anwenderschnittstellen zu konfigurieren.

Bei der Konfiguration von Ausdrücken in dynamischen Profilen müssen Sie die folgenden Regeln beachten:

• Sie können Ausdrücke nur innerhalb eines variablen Zeilenbereichs eines dynamischen Profils konfigurieren.

• Dynamische Profile, die Ausdrücke für benutzerdefinierte Variablen enthalten, dürfen nur für die Dienstaktivierung verwendet werden.

• In der Regel weisen Sie Ausdrücke nur benutzerdefinierten Variablen zu. Sie können interne Variablen oder vordefinierten Variablen keine Ausdrücke zuweisen.

• Ausdruckswerte haben Vorrang vor Standardwerten.

• Ganze Ausdrücke müssen in Anführungszeichen (" ") gesetzt werden.

• Zeichenfolgen in den Ausdrücken müssen in einfachen Anführungszeichen (' ' ) angegeben werden, und die einfachen Anführungszeichen dürfen nur Zeichenfolgen enthalten.

• Leerzeichen werden als Trennzeichen für alle Operanden und Operatoren behandelt. Zeichenfolgen, die Leerzeichen enthalten, die Sie in Ausdrücken erstellen, werden als einzelne Zeichenfolgen behandelt und enthalten alle führenden oder nachfolgenden Leerzeichen. So erstellen Sie z. B. ein Serviceprofil:

• Der Ausdruck muss entweder aus allen arithmetischen Operatoren oder aus allen Zeichenfolgenoperatoren bestehen. Das Mischen von arithmetischen Operatoren und Zeichenfolgenoperatoren ist nur zulässig, wenn sie ordnungsgemäß in den richtigen Typ konvertiert wurden.

• Ausdrücke können sich auf andere vordefinierte Systemvariablen oder andere benutzerdefinierte Variablen beziehen. Es ist jedoch kein Zirkelverweis zwischen Variablen zulässig. Zum Beispiel ist die folgende Referenz falsch:

• Verwenden Sie das folgende Format, um eine dynamische Schnittstelle und ein Schnittstellenset für die BNG-CUPS-Benutzerebene zu erstellen:

  Sie können die Rangfolge von Dienstfiltern für die BNG-CUPS-Benutzerebene konfigurieren, um die Dienstauswertungsreihenfolge für die Pakete zu steuern. Sie können die Prioritätskonfiguration zum dynamischen Profil hinzufügen.

• Jede obligatorische Variable, die keinen Standardwert oder keinen Gleichheitsausdruck enthält, muss im Rahmen der Dienstaktivierung einen Wert enthalten. Beispielsweise ist ein RADIUS-Dienst-VSA wie "service-video( value1, value2)" erfolgreich, der zwei oder weniger obligatorische Variablen in der dynamischen Serviceprofildefinition "service-video" enthält. Die Dienstaktivierung schlägt fehl, wenn mindestens einer obligatorischen Variablen kein Wert zugeordnet ist, entweder durch Attributauswertung "default" oder "equals".

In Tabelle 1 sind die unterstützten Operatoren und Funktionen aufgeführt, mit denen Sie Ausdrücke erstellen können. Rangfolge 5 ist die höchste Stufe.

Tabelle 1: Operatoren und Funktionen

Operation	Operator	Assoziativität	Vorrang	Aktion
Arithmetische Addition	+	Links	1	Addiert die Elemente rechts und links neben dem Operator zusammen.
Arithmetische Subtraktion	-	Links	1	Subtrahiert das Element rechts vom Operator von dem Element links vom Operator.
Arithmetische Multiplikation	*	Links	2	Multipliziert das Element links vom Operator mit dem Element rechts neben dem Operator.
Arithmetische Division	/	Links	2	Teilt das Element links vom Operator durch das Element rechts neben dem Operator.
Arithmetic Modulo	%	Links	2	Teilt das Element links vom Operator durch das Element rechts neben dem Operator und gibt den ganzzahligen Rest zurück. Wenn das Element links vom Operator kleiner ist als das Element rechts vom Operator, ist das Ergebnis das Element links vom Operator.
Verkettung	##	Links	3	Erstellt eine neue Zeichenfolge, indem die Zeichenfolgenwerte links vom Operator und die Werte rechts vom Operator miteinander verbunden werden.
Maximum	max(param1,param2)	Links	4	Akzeptiert das Maximum der beiden Werte, die als Parameter übergeben werden.
Minimum	min(param1,param2)	Links	4	Akzeptiert das Minimum der beiden Werte, die als Parameter übergeben werden.
Rund	rund(param1)	-	4	Rundet den Wert auf die nächste ganze Zahl.
Abschneiden	trunc(param1)	-	4	Schneidet einen nicht ganzzahligen Wert auf den Wert links vom Dezimaltrennzeichen ab.
In Zeichenfolge konvertieren	toStr(param1)	-	4	Konvertiert die Variable in den Klammern in eine mit NULL abgeschlossene Zeichenfolge.
In Ganzzahl konvertieren	toInt(param1)	-	4	Konvertiert den Parameter in eine ganze Zahl. Ein einzelner String oder eine einzelne Variable ist als Parameter zulässig.
Zufällig	rand()	-	4	Generiert einen zufälligen numerischen Wert.
Wenn nicht Null	ifNotZero(param1; param2)	Links	4	Gibt den zweiten Parameter zurück, wenn der erste Parameter nicht Null ist. Gibt NULL zurück, wenn der erste Parameter Null ist.
Runde Klammern	( )	-	5	Gruppiert Operanden und Operatoren, um Ergebnisse zu erzielen, die sich von der einfachen Rangfolge unterscheiden. hat effektiv die höchste Priorität.

Ausdrücke werden ausgewertet, nachdem Variablen mit Werten aufgefüllt wurden. Die Auswertung erfolgt unmittelbar vor der Profilinstanziierung und beinhaltet eine Wertprüfung. Wenn die berechneten Werte nicht akzeptabel sind oder Regeln für die Ausdruckssyntax verletzt werden, schlägt die Ausdrucksauswertung fehl, die Profilinstanziierung findet nicht statt, und es werden Meldungen protokolliert, um die Fehler zu beschreiben.

Tabelle 2 listet die möglichen Ausdrucksfehlerszenarien und die von der Routersoftware ausgeführte Aktion auf.

Tabelle 2: Ausdrucksfehler und Aktionen

Fehler	Vorkommen	Aktion	Variablenwert
Parsing-Fehler	Commit-Check-Phase	Commit schlägt fehl	nicht zutreffend
Abhängigkeitsfehler bei zirkulären Variablen	Commit-Check-Phase	Commit schlägt fehl	nicht zutreffend
Variablen innerhalb der Ausdrücke sind nicht definiert	Commit-Check-Phase	Commit schlägt fehl	nicht zutreffend
Durch Null dividieren	Profil-Instanziierung	Fehler bei der Profilinstanziierung	Null (0)
Hinzufügen einer Zeichenfolge zu einer Zahl	Profil-Instanziierung	Fehler bei der Profilinstanziierung	Null (0)
Überlauffehler	Profil-Instanziierung	Fehler bei der Profilinstanziierung	Undefiniert
Unterlauffehler	Profil-Instanziierung	Fehler bei der Profilinstanziierung	Undefiniert

Sie können die benutzerdefinierten Variablen auch mit einem Standardwert konfigurieren. Der Standardwert bietet eine eigenständige Konfiguration für die zugeordnete Anweisung oder eine Sicherung für die Anweisungskonfiguration, wenn auf den RADIUS-Server nicht zugegriffen werden kann oder das VSA-Attribut keinen Wert enthält.

Die bedingte Konfiguration umfasst zwei Hauptschritte:

1. Definieren der Bedingungsvariablen

2. Verweisen auf die Bedingungsvariable in einer Konfigurationsanweisung

Eine bedingte Variable wird als Ausdruck ifNotZero (param1, param2)definiert. In diesem Ausdruck ist eine benutzerdefinierte Variable, param1 deren Wert von einem externen Server wie RADIUS abgeleitet wird und param2 eine benutzerdefinierte Variable, eine Funktion, ein Vorgang, eine Zahl oder eine Zeichenfolge sein kann. Bei einer Bedingungsvariablen kann es sich um eine benutzerdefinierte Variable oder eine eindeutige ID (UID) reference handeln. Es darf sich nicht um eine vordefinierte oder UID-Variable handeln. In Junos OS werden bedingte Variablen nur für die dynamischen Serviceprofile unterstützt.

Die Konfigurationsanweisungen, in denen auf die Bedingungsvariablen verwiesen wird, werden als Konfigurationsanweisungen bezeichnet conditional . Nachdem die Bedingungsvariable definiert wurde, wird in dynamic-profiles Konfigurationsanweisungen auf sie verwiesen und sie werden verarbeitet, wenn das Dienstprofil instanziiert wird. Die folgenden Konfigurationsanweisungen für Dienstprofile unterstützen bedingte Variablen:

• dynamic-profiles profile-name interfaces interface-name unit unit-no family type filter input filter-name

• dynamic-profiles profile-name interfaces interface-name unit unit-no family type filter output filter-name

• dynamic-profiles profile-name firewall family type filter filter-name term term-name

• dynamic-profiles profile-name firewall family type filter filter-name term term-name then policer policer-name

• dynamic-profiles profile-name firewall family type filter filter-name term term-name then hierarchical-policer policer-name

• dynamic-profiles profile-name class-of-service scheduler-maps map-name forwarding-class class-name scheduler scheduler-name

Das System befolgt die folgenden Regeln bei der Auswertung der bedingten Variablen und bedingten Konfigurationsanweisungen während der Instanziierung des Dienstprofils:

• Wenn in der Funktion ifNotZero(param1, param2) der Wert von a param1 nicht von einem externen Server empfangen wird und der Standardwert nicht konfiguriert ist, wird der Wert der Variablen als ungleich Null behandelt und param2 ausgewertet.

• Wenn der Wert von param1 in der Funktion ifNotZero(param1, param2) 0 ist, wird NULL als Wert des Ausdrucks zurückgegeben und param2 nicht ausgewertet. In diesem Fall wird der Wert der bedingten Variablen NULL, und die Konfigurationsanweisung, in der auf die bedingte Variable verwiesen wird, wird ignoriert.

• Wenn der Wert von param1 ungleich Null ist, wird er ausgewertet, param2 und sein Wert wird als Wert des Ausdrucks zurückgegeben.

Die folgenden filter-service cos-service Konfigurationsbeispiele zeigen, wie die Regeln angewendet werden:

Konfigurationsbeispiel für Filterdienst

filter-service Im Konfigurationsbeispiel sind , output-filter-ref, policer1-refund term1 bedingte Variablen, input-filter-refwhile input "$input-filter-ref" precedence 50, output "$output-filter-ref" precedence 50, term $term1und policer "$policer1-ref" sind bedingte Konfigurationsanweisungen. Wenn in diesem Beispiel der Wert von input-filter-var 0 ist, wird der Wert der bedingten Variablen input-filter-ref zu NULL. Daher wird die gesamte Konfigurationsanweisung input “$input-filter-ref” precedence 50, in der auf die Bedingungsvariable verwiesen wird, ignoriert. Wenn der Wert der Variablen jedoch ungleich Null ist, wird die Konfigurationsanweisung während der Instanziierung des Dienstprofils verarbeitet.

Konfigurationsbeispiel für CoS-Services

cos-service Im Konfigurationsbeispiel sch1_ref sind und sch2_ref bedingte Variablen while forwarding-class best-effort scheduler "$sch1_ref" und forwarding-class assured-forwarding scheduler "$sch2_ref" sind bedingte Konfigurationsanweisungen. Ähnlich wie bei der filter-service Auswertung im Konfigurationsbeispiel wird die Konfigurationsanweisung, in der auf die bedingte Variable verwiesen wird, ignoriert und während der CoS-Serviceprofilinstanziierung nicht verarbeitet, wenn der Wert einer Variablen, auf die in einer bedingten Variablen verwiesen wird, 0 ist.