Konfigurationsvorlagen im icom Router Management ermöglichen es, individualisierte Konfigurationen für jeden Router auszurollen.

Das icom Router Management für alle icom OS-basierten Router-Modelle ermöglicht Rollouts von Geräte-Firmware, Konfigurationen, Sicherheitszertifikaten und Anwendungen.

Situation

Sie verfügen über eine Reihe von Routern im Feld, auf die Sie gemeinsam eine Router-individuelle Konfiguration in einem Vorgang im icom Router Management ausrollen möchten.

Sie möchten beispielsweise die Konfiguration aller Router mit individuellen Standortdaten für jeden Routers aktualisieren.

Der Anwendungsfall ist exemplarisch und kann für beliebige Konfigurationsoptionen verwendet werden.

Lösung

Legen Sie eigene Felder für individuelle Variablen im icom Router Management an. Belegen Sie diese Felder für jeden Router mit seinen individuellen Daten. Erstellen Sie eine Konfigurationsvorlage, die für jeden Router eine individuelle Konfigurationsdatei erzeugt, und dabei die Individualwerte aus den eigenen Feldern abruft. Wenden Sie die Konfigurationsvorlage auf die Router an.

Anlegen der eigenen Felder

Legen Sie eigene Felder an, die Sie mit individuellen Daten für jeden Router belegen können. In diesem Beispiel sind dies Felder für die Stadt, die Straße und die Hausnummer, aus denen dann der Standort zusammengesetzt wird.

  1. Melden Sie sich am icom Router Management an.

  2. Klicken Sie in der Titelleiste auf cog Einstellungen → file edit Eigene Felder und wählen Sie plus Hinzufügen
    cg de rm config templates 01

  3. Geben Sie den Namen des eigenen Felds ein, z.B. town.

  4. Geben Sie optional eine Beschreibung des neuen eigenen Felds ein, z.B. Stadt.

  5. Legen Sie den Datentyp des neuen eigenen Felds fest, in diesem Anwendungsfall string.
    string: der Dateninhalt des eigenen Felds ist eine Zeichenfolge (Text)
    boolean: der Dateninhalt des eigenen Felds ist 0 oder 1
    number: der Dateninhalt des eigenen Felds ist eine Zahl

  6. Klicken Sie auf   Hinzufügen  .
    cg de rm config templates 02

  7. Legen Sie zwei weitere eigene Felder für die Straße und die Hausnummer wie folgt an.
    cg de rm config templates 03

Damit haben Sie die eigenen Felder für die Beschreibung des Standorts hinzugefügt.

Hinterlegen der Standortdaten der Router in den eigenen Feldern

Hinterlegen Sie die detaillierten Daten des Standorts für jeden Router.

  1. Markieren Sie auf der Seite package variant closed Inventar → Router den Router, den sie bearbeiten möchten, und klicken Sie rechts oben auf flash outline Aktionen → auf pencil Bearbeiten.
    cg de rm config templates 04

  2. Wechseln Sie auf die Registerkarte Eigene Felder, geben Sie die gewünschten Standortdaten in das jeweilige eigene Feld ein.
    cg de rm config templates 05

Damit haben Sie die Standortdaten für diesen Router hinterlegt. Gehen Sie für weitere Router analog vor.

Erstellen der Konfigurationsvorlage

Erstellen Sie eine Konfigurationsvorlage, die den genauen Standort jedes Routers aus den für ihn hinterlegten Daten zusammensetzt und dann auf den Router schreibt.

  1. Wählen Sie auf der Seite package variant closed Inventar → ASCII-Vorlagen plus Hinzufügen.
    cg de rm config templates 06

  2. Geben Sie den Name der Konfigurationsvorlage ein, z.B. location_update.

  3. Klicken sie auf   plus  PARAMETER HINZUFÜGEN  , geben Sie einen Namen für den Parameter an, z. B. Stadt und wählen Sie für den neuen Parameter aus der Dropdown-Liste Typ das eigene Feld Stadt.
    cg de rm config templates 07

  4. Klicken Sie auf plus bei Actions und fügen sie zwei weitere Parameter für Straße und die Hausnummer wie folgt hinzu. [1]
    cg de rm config templates 08

  5. Geben Sie unter Vorlage den CLI-Befehl zum Setzen des Standorts administration.hostnames.location= ein.
    cg de rm config templates 09

  6. Positionieren sie den Cursor direkt hinter den eingefügten Befehl und klicken sie hinter dem Parameter für die Stadt auf application braces plus outline Parameter in die Vorlage kopieren, um die Variable für die Stadt einzufügen.
    cg de rm config templates 10

  7. Positionieren sie den Cursor direkt hinter den eingefügten Parameter, geben Sie ein Komma und ein Leerzeichen ein, und klicken sie hinter dem Parameter für die Straße auf application braces plus outline Parameter in die Vorlage kopieren, um die Variable für die Straße einzufügen.
    cg de rm config templates 11

  8. Positionieren sie den Cursor direkt hinter den eingefügten Parameter, geben Sie ein Leerzeichen ein, und klicken sie hinter dem Parameter für die Hausnummer auf application braces plus outline Parameter in die Vorlage kopieren, um die Variable für die Hausnummer einzufügen.
    cg de rm config templates 12

  9. Geben Sie unter Vorlage in die Zeile unter dem CLI-Befehl zum Setzen des Standorts den CLI-Befehl zum Aktivieren des Profils administration.profiles.activate ein.
    cg de rm config templates 13

  10. Klicken Sie auf   Hinzufügen  .
    cg de rm config templates 14

Damit haben Sie folgende Konfigurationsvorlage angelegt:

administration.hostnames.location={{ .Stadt }}, {{ .Strasse }} {{ .Hausnummer }}
administration.profiles.activate

Mit einem Klick auf flash outline Aktionen → play Testlauf nach dem Markieren der Konfigurationsvorlage lässt sich diese prüfen.
cg de rm config templates 15

Note Für einen Testlauf müssen für den Router valide Daten für die jeweiligen eigenen Felder hinterlegt sein, die in der Konfigurationsvorlage vorhanden sind.

Wählen sie dazu den Router aus und klicken sie auf   Testlauf  .
cg de rm config templates 16

Die aus der Konfigurationsvorlage für diesen Router erzeugte Konfigurationsdatei wird angezeigt.
cg de rm config templates 17

  1. Klicken Sie auf   Schließen  , um den Testlauf zu beenden.

Anwenden der Konfigurationsvorlage auf die Router

Wenden Sie die Konfigurationsvorlage auf den oder die Router an, für den oder die Sie die Standortinformationen hinterlegt haben.

  1. Markieren Sie auf der Seite package variant closed Inventar → ASCII-Vorlagen die zuvor erstellte Konfigurationsvorlage und klicken Sie auf flash outline Aktionen → autorenew Auf Router anwenden.
    cg de rm config templates 18

  2. Wählen Sie den oder die Router aus, auf den oder die Sie die Konfigurationsvorlage anwenden möchten und klicken sie auf   Weiter  .
    cg de rm config templates 19

  3. Überprüfen Sie die Auswahl von ASCII-Vorlage (vorausgewählt) und Router(n) und klicken sie auf   Weiter  .
    cg de rm config templates 20

  4. Geben Sie optional einen eindeutigen Namen für den Update-Vorgang ein, wählen Sie den Ausführungszeitpunkt (hier Sofort) und klicken sie auf   Update fertigstellen  .
    cg de rm config templates 21

  5. Klicken sie nach erfolgreicher Erstellung des Update-Vorgangs auf   Zur Update-Job Ansicht  .
    cg de rm config templates 22

Erfolgskontrolle

Überprüfen Sie erfolgreiche Ausführung der Konfigurationsvorlage für den Update-Vorgang und verifizieren Sie die Konfigurationsänderung auf dem Router.

  1. Überprüfen Sie in der Update-Job-Ansicht (Menü update Updates → Update-Jobs), ob der Update-Vorgang erfolgreich ausgeführt wurde.
    cg de rm config templates 23

  2. Öffnen Sie das Web-Interface des Routers: https://192.168.1.1/ui/index.html [2]

  3. Überprüfen Sie auf der Seite view dashboard outline Status → Dashboard, ob der Standort im Feld Geräteinfo aktualisiert wurde.
    cg de rm config templates 24

Note Die Angabe Standort in der Router-Übersicht (Menü package variant closed Inventar → Router) kann optional beim Anlegen des Routers im icom Router Management angegeben werden und zeigt nicht den im Router konfigurierten Standort an, der mit dieser Konfigurationsvorlage angepasst wird. Daher ändert sich diese Angabe nicht durch die Anwendung der Konfigurationsvorlage.

Tipps und Tricks

  • Die verfügbaren CLI-Befehle und deren Syntax lassen sich mit Hilfe der Kommandozeilenschnittstelle (CLI) ermitteln. Einzelheiten dazu finden Sie in der Online-Hilfe des Routers.

  • Konfigurationsvorlagen ermöglichen auch die Verwendung von Variablen, die bei der Anwendung der Konfigurationsvorlage abgefragt werden. In diesem Beispiel könnte man damit dem Router ein weiteres, optionales Attribut zur Definition des Standorts hinzufügen.
    cg de rm config templates 25
    cg de rm config templates 26

Fehlersuche

  • Sollte eine Seite im icom Router Management ein unerwartetes Verhalten aufweisen hilft oft eine Aktualisierung der Seite im Browser mit refresh Strg+F5.

Zurück zu den Configuration Guides für das icom Router Management

Zurück zur Übersicht

1. Der Parametername Strasse wird hier so geschrieben, da Sonderzeichen im Parameternamen nicht erlaubt sind.
2. Anmeldung je nach Konfiguration; Voreinstellung bei älteren Firmware-Versionen: Benutzername: insys, Kennwort: icom