Kategorie: WAN-Leitungen#

Die Kategorie WAN-Leitungen dokumentiert Wide-Area-Network-Verbindungen eines Objekts. Sie ist eine Multi-Value-Kategorie — pro Objekt können beliebig viele WAN-Verbindungen angelegt werden, z.B. bei Standorten mit redundanter Anbindung über verschiedene Provider. Die Kategorie erfasst Bandbreiten, Provider-Informationen, Circuit-IDs und die Verknüpfung zu den angebundenen Netzen und Routern.

Verwendung#

Typische Anwendungsfälle:

• Provider-Management: Erfasse für jede WAN-Leitung den Provider, die Vertragsnummer (Kundennummer), die Projektnummer und die Warenkorbbestellnummer. So lässt sich jederzeit nachvollziehen, welche Leitungen bei welchem Provider unter welchem Vertrag laufen — unverzichtbar bei Kündigungen, Störungsmeldungen und Vertragsverhandlungen.
• Bandbreitenplanung: Die Felder für Upload- und Download-Kapazität (Ist und Maximum) ermöglichen eine detaillierte Bandbreitenübersicht. Ein Report über alle WAN-Leitungen mit weniger als 100 Mbit/s zeigt sofort, welche Standorte bei steigendem Datenaufkommen zum Engpass werden.
• Redundanz und Ausfallsicherheit: Bei Standorten mit mehreren WAN-Leitungen (z.B. Primär über MPLS, Backup über Internet-VPN) dokumentiert jeder Eintrag eine Leitung. Über die Rolle (Primary, Backup) ist sofort erkennbar, welche Leitung im Fehlerfall übernimmt.
• Störungsmanagement: Die Ticketnummer und Circuit-ID (Projektnummer) sind die Schlüsselinformationen, die der Provider bei einer Störungsmeldung benötigt. Wenn diese Daten in i-doit gepflegt sind, spart das im Ernstfall wertvolle Minuten.
• Netz- und Router-Verknüpfung: Über die Felder Angeschlossene Router und Angeschlossene Netze wird die WAN-Leitung direkt mit den relevanten Infrastruktur-Objekten verknüpft. Impact-Analysen zeigen dann automatisch, welche Netze und Router betroffen sind, wenn eine Leitung ausfällt.

Felder#

Bezeichnung#

Der Name der WAN-Verbindung, z.B. MPLS Berlin-München oder Internet Backup Standort Süd. Dieser Wert erscheint in der Listenansicht und in Reports.

Rolle#

Die Rolle der Leitung im Netzwerk, z.B. Primary, Backup oder Management. Dialog+-Feld — eigene Werte lassen sich bei Bedarf ergänzen.

Typ#

Die Technologie der WAN-Verbindung, z.B. MPLS, Internet VPN, SD-WAN, Standleitung oder DSL. Dialog+-Feld — eigene Werte lassen sich bei Bedarf ergänzen.

Kanäle#

Die Anzahl der Kanäle (Channels), z.B. bei ISDN-Leitungen oder gebündelten Verbindungen.

Rufnummer(n)#

Rufnummern, die der WAN-Leitung zugeordnet sind. Mehrzeiliges Textfeld — bei mehreren Nummern eine pro Zeile eintragen.

Standort der Verbindung#

Verknüpfung zu einem Standort-Objekt in i-doit (z.B. Gebäude oder Raum), an dem die WAN-Leitung physisch terminiert. Objekt-Browser-Feld.

Kapazität UP und Kapazität UP Einheit#

Die tatsächliche Upload-Bandbreite der Leitung. Die Einheit wird separat als kbit/s, Mbit/s oder Gbit/s angegeben. Dokumentiere hier die vertraglich zugesicherte Bandbreite.

Kapazität DOWN und Kapazität DOWN Einheit#

Die tatsächliche Download-Bandbreite der Leitung. Analog zur Upload-Kapazität.

Max. Kapazität UP und Max. Kapazität DOWN#

Die maximal mögliche Bandbreite der Leitung (Burst oder technisches Maximum), getrennt nach Upload und Download mit jeweiliger Einheit. Nützlich, um zu dokumentieren, welche Reserven eine Leitung bietet.

Projektnummer#

Die interne oder providerseitige Projektnummer bzw. Circuit-ID der Leitung. Dieses Feld ist kritisch für Störungsmeldungen — der Provider identifiziert die Leitung in der Regel über diese Nummer.

VLAN-ID#

Verknüpfung zu einem Layer-2-Netz-Objekt, in dem die WAN-Leitung terminiert. Objekt-Browser-Feld.

Warenkorbnummer#

Die Bestellnummer aus dem Beschaffungsprozess. Hilfreich für die Nachverfolgung von Bestellungen und die Zuordnung zu Rechnungen.

Ticketnummer#

Eine Referenz auf ein Ticket (z.B. aus dem Ticketsystem), das mit der Bereitstellung oder einer Störung der Leitung zusammenhängt.

Kundennummer#

Die Kundennummer beim Provider. Wichtig für die Zuordnung bei Störungsmeldungen und Vertragsfragen.

Angeschlossene Router#

Verknüpfung zu Router-Objekten, die an der WAN-Leitung angeschlossen sind. Objekt-Browser-Feld — mehrere Router können zugewiesen werden. Siehe auch Kategorie Routing.

Angeschlossene Netze#

Verknüpfung zu Netz-Objekten, die über die WAN-Leitung erreichbar sind. Objekt-Browser-Feld — mehrere Netze können zugewiesen werden. Siehe auch Kategorie Netz.

Beschreibung#

Freitext für zusätzliche Angaben: SLA-Details, Kündigungsfristen, technische Ansprechpartner beim Provider, Übergabepunkte oder besondere Konfigurationshinweise.

Technische Referenz#

Felder (API-Referenz)#

API-Beispiele#

Eintrag erstellen#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.save",
    "params": {
        "apikey": "dein-api-key",
        "object": 123,
        "category": "C__CATG__WAN",
        "data": {
            "title": "MPLS Berlin-München Primary",
            "role": "Primary",
            "type": "MPLS",
            "capacity_up": 100,
            "capacity_up_unit": 3,
            "capacity_down": 100,
            "capacity_down_unit": 3,
            "max_capacity_up": 200,
            "max_capacity_up_unit": 3,
            "max_capacity_down": 200,
            "max_capacity_down_unit": 3,
            "project_no": "CID-2025-04711",
            "customer_no": "KD-889900",
            "description": "MPLS-Primärleitung, Provider: Telekom, SLA 99.9%, 4h Entstörzeit"
        }
    },
    "id": 1
}

Einträge lesen#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.read",
    "params": {
        "apikey": "dein-api-key",
        "object": 123,
        "category": "C__CATG__WAN"
    },
    "id": 2
}

Eintrag aktualisieren#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.save",
    "params": {
        "apikey": "dein-api-key",
        "object": 123,
        "category": "C__CATG__WAN",
        "entry": 5,
        "data": {
            "capacity_up": 200,
            "capacity_down": 200,
            "description": "Bandbreitenupgrade 2025-10: 100 Mbit/s auf 200 Mbit/s symmetrisch."
        }
    },
    "id": 3
}