Kategorie: FC-Port#

Die Kategorie FC-Port dokumentiert die Fibre-Channel-Ports eines Servers oder Storage-Systems. Sie ist eine Multi-Value-Kategorie -- ein HBA hat typischerweise zwei oder vier FC-Ports, und jeder wird als eigener Eintrag erfasst.

Fibre-Channel-Ports sind das physische Bindeglied zwischen einem Server und dem SAN (Storage Area Network). Jeder Port besitzt weltweit eindeutige Adressen (WWN/WWPN), über die das SAN-Zoning gesteuert wird. Ohne korrekt dokumentierte FC-Ports ist eine saubere SAN-Dokumentation nicht möglich -- und ohne SAN-Dokumentation wird jede Storage-Migration oder jedes Zoning-Update zum Blindflug.

Verwendung#

Typische Anwendungsfälle:

• SAN-Zoning-Dokumentation: Die WWPN eines FC-Ports wird in der SAN-Switch-Konfiguration (Zoning) verwendet, um festzulegen, welcher Server auf welche Storage-LUNs zugreifen darf. Wenn die WWPN in i-doit dokumentiert ist, kann das Storage-Team bei Zoning-Änderungen die korrekte Adresse nachschlagen, ohne sich am Server anmelden zu müssen.
• Fabric-Inventar: Über den Report Manager lassen sich alle FC-Ports mit ihren WWPNs, Geschwindigkeiten und Verbindungen auflisten. Das ergibt ein vollständiges Fabric-Inventar, das bei SAN-Audits oder Migrationen unverzichtbar ist.
• Multipath-Analyse: Moderne SAN-Konfigurationen nutzen redundante Pfade (Multipath I/O). Jeder Pfad läuft über einen eigenen FC-Port. Die FC-Port-Kategorie zeigt, über welche Ports ein Server mit dem SAN verbunden ist, und in Kombination mit der Kategorie Logische Geräte (Client) ergibt sich ein vollständiges Multipath-Bild.
• Troubleshooting bei SAN-Problemen: Wenn ein Server keinen Zugriff auf eine LUN hat, prüft der Storage-Admin die WWPN im Zoning. Stimmt die dokumentierte WWPN mit der tatsächlichen überein? Ist der Port-Typ korrekt? Ist die Geschwindigkeit richtig ausgehandelt? All diese Informationen sind in der FC-Port-Kategorie hinterlegt.
• Migration und Refresh: Beim Austausch eines HBAs ändern sich die WWPNs. Die alte WWPN muss aus dem Zoning entfernt und die neue hinzugefügt werden. Die FC-Port-Kategorie dokumentiert sowohl den alten Zustand (archivierter Eintrag) als auch den neuen.

Felder#

Bezeichnung#

Der Name des FC-Ports, z.B. FC0 oder Port 1 - Fabric A. Verwende eine eindeutige Benennung, die den physischen Slot und die Fabric-Zuordnung erkennen lässt.

Typ#

Der Port-Typ, z.B. N_Port (Node Port, Standardfall bei Server-HBAs), F_Port (Fabric Port, auf SAN-Switch-Seite), E_Port (Inter-Switch-Link) oder NL_Port (Arbitrated Loop). Dialog+-Feld -- eigene Typen können ergänzt werden.

Verbundener Controller#

Der HBA, zu dem dieser FC-Port gehört. Dieses Feld referenziert einen Eintrag aus der HBA-Kategorie desselben Objekts. Die Zuordnung ist wichtig, weil ein Server mehrere HBAs haben kann und die FC-Ports korrekt zugeordnet werden müssen.

Zugewiesener Ein-/Ausgang#

Referenz auf den zugehörigen physischen Connector des Objekts. Wird für die Kabelverbindungs-Dokumentation in i-doit verwendet.

Medium#

Der physische Medientyp der FC-Verbindung, z.B. Multimode Fibre, Singlemode Fibre oder Copper (SFP+). Dialog+-Feld. Relevant für die Beschaffung der richtigen SFP-Module und Kabel.

Geschwindigkeit und Geschwindigkeits-Einheit#

Die Linkgeschwindigkeit des FC-Ports, z.B. 16 mit Einheit Gbit/s. Gängige Werte sind 8, 16, 32 oder 64 Gbit/s. Die tatsächlich ausgehandelte Geschwindigkeit kann niedriger sein als die Maximalgeschwindigkeit -- dokumentiere den konfigurierten oder ausgehandelten Wert.

Node WWN#

Die World Wide Node Name (WWNN) des HBAs, z.B. 20:00:00:25:B5:01:00:0A. Die WWNN identifiziert den HBA als Ganzes (nicht den einzelnen Port) und wird bei manchen SAN-Konfigurationen für das Zoning verwendet.

Port WW(P)N#

Die World Wide Port Name (WWPN) dieses spezifischen FC-Ports, z.B. 21:00:00:25:B5:01:00:0A. Die WWPN ist die wichtigste Adresse für das SAN-Zoning, weil sie jeden einzelnen Port weltweit eindeutig identifiziert. Die meisten SAN-Konfigurationen verwenden WWPN-basiertes Zoning.

SAN-Zone und Verbindungstyp#

Die SAN-Zone(n), denen dieser FC-Port zugewiesen ist. Verknüpft den Port mit den in i-doit dokumentierten SAN-Zoning-Konfigurationen. In größeren SAN-Umgebungen gehört ein Port häufig zu mehreren Zonen.

Zielobjekt#

Das Objekt, mit dem dieser FC-Port physisch verbunden ist -- typischerweise ein SAN-Switch-Port oder direkt ein Storage-Port (bei Direct-Attach-Konfigurationen).

Verbindung#

Die physische Kabelverbindung zu einem anderen FC-Port. Hier wird die tatsächliche Punkt-zu-Punkt-Verbindung dokumentiert, inklusive des verbundenen Ports am Zielobjekt.

Beschreibung#

Freitext für zusätzliche Informationen: SFP-Modul-Typ, Fabric-Zuordnung (A/B), VSAN-Zugehörigkeit, Besonderheiten bei der Verkabelung oder Hinweise zum Zoning.

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

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.save",
    "params": {
        "apikey": "dein-api-key",
        "object": 1042,
        "category": "C__CATG__CONTROLLER_FC_PORT",
        "data": {
            "title": "FC0 - Fabric A",
            "type": "N_Port",
            "connected_controller": 15,
            "medium": "Multimode Fibre",
            "speed": 32,
            "speed_unit": 3,
            "wwn": "20:00:00:25:B5:01:00:0A",
            "wwpn": "21:00:00:25:B5:01:00:0A",
            "description": "Fabric A, SFP+ 32G SW, verbunden mit SAN-Switch-A Port 12"
        }
    },
    "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": 1042,
        "category": "C__CATG__CONTROLLER_FC_PORT"
    },
    "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": 1042,
        "category": "C__CATG__CONTROLLER_FC_PORT",
        "entry": 3,
        "data": {
            "speed": 32,
            "speed_unit": 3,
            "description": "2026-04: SFP-Upgrade von 16G auf 32G, neues SFP-Modul Brocade 32G SW"
        }
    },
    "id": 3
}