À propos de la gestion des routeurs avec MIB
Les API MIB (Management Information Base) pour la gestion des routeurs permettent d’interroger et de définir les valeurs des variables MIB exportées par l’un des gestionnaires de routeur ou l’un des protocoles de routage que les gestionnaires de routeurs gèrent. À l’aide de cette API, le routeur prend en charge le protocole SNMP (Simple Network Management Protocol).
Dans l’infrastructure SNMP, chacun des objets gérables dans le routeur est représenté par une variable qui a un identificateur d’objet (OID) unique. Correspondant à chaque OID est une valeur qui représente l’état actuel de l’objet. La collection d’OID et de valeurs est appelée base d’informations de gestion (MIB). Les appels MprAdminMib permettent à un développeur de spécifier un objet par son OID et d’interroger ou d’écrire (« Définir ») la valeur de l’objet.
Pour interroger et définir des variables MIB, le module qui traite les appels doit définir un ensemble de structures de données. Ces structures de données incluent des structures à utiliser comme identificateurs d’objet et des structures qui contiennent les valeurs des variables MIB auxquelles vous accédez. Ces structures de données sont opaques pour tous, sauf pour l’appelant de la fonction MIB et pour le module qui traite l’appel.
Le module de maintenance de l’appel MIB est un gestionnaire de routeur ou l’un des protocoles de routage. L’appelant doit spécifier un gestionnaire de routeur même si l’appel est géré par l’un des protocoles de routage. Dans ce cas, l’appelant doit spécifier le gestionnaire de routeur qui correspond à la famille de protocoles pour ce protocole de routage. Par exemple, si le protocole de routage Open Shortest Path First (OSPF) gérait l’appel MIB, l’appelant doit spécifier le gestionnaire de routeur IP, car OSPF appartient à la famille de protocoles IP. Dans chacune des fonctions MIB, le paramètre dwTransportId spécifie un gestionnaire de routeur et le paramètre RoutingPid spécifie le protocole de routage. Le gestionnaire de routeur a également un routagePid unique, car certaines variables MIB peuvent être gérées par le gestionnaire de routeur lui-même.
Les fonctions MprAdminMib peuvent être appelées sur un ordinateur autre que celui administré. Les fonctions MprAdminMIB qui interrogent ou écrivent des valeurs, prennent comme paramètre un handle à administrer sur l’ordinateur. Utilisez la fonction MprAdminMIBServerConnect pour établir la connexion à l’ordinateur distant et obtenir ce handle. Après avoir appelé les fonctions MprAdminMIB nécessaires pour accomplir une tâche d’administration particulière, appelez la fonction MprAdminMIBServerDisconnect pour arrêter la connexion à l’ordinateur distant.
Les fonctions MprAdminMIBEntryCreate et MprAdminMIBEntrySet prennent comme paramètres un OID et une mémoire tampon qui contient la nouvelle valeur de l’objet.
Les fonctions MprAdminMIBEntryGet, MprAdminMIBEntryGetFirst et MprAdminMIBEntryGetNext prennent comme paramètres un OID et l’adresse d’une variable de pointeur. En cas de retour réussi, la variable pointeur pointe vers une mémoire tampon qui contient la valeur de l’objet. L’appelant doit libérer la mémoire pour cette mémoire tampon en appelant la fonction MprAdminMIBBufferFree .
Les fonctions MprAdminMIBEntryGetFirst et MprAdminMIBEntryGetNext permettent à un développeur d’effectuer une marche SNMP. Étant donné que les OID sont triés, chaque OID et par conséquent chaque objet gérable a un OID suivant . Une marche SNMP fait référence à la traversée d’une partie de la MIB en lisant ou en écrivant une séquence d’OID.
Tous les appels MprAdminMib passent par le Gestionnaire d’interface dynamique (DIM). En fonction de l’OID, DIM passe l’appel à l’un des gestionnaires de routeur. (IP et IPX prennent en charge SNMP). Là encore, en fonction de l’OID, le gestionnaire de routeur peut gérer l’appel lui-même ou passer l’appel à l’un de ses clients. Tous les clients de routeur doivent implémenter et exporter les fonctions suivantes qui correspondent aux fonctions MprAdminMIB de même nom :