Opis funkcji zarządzania routerem
W poniższych sekcjach omówiono różne typy funkcji zarządzania routerami oraz informacje o ich efektywnym użyciu.
Wszystkie funkcje zarządzania routerem wymagają uprawnień administratora. Użytkownik w grupie Power User nie ma wystarczających uprawnień do korzystania z funkcji zarządzania routerem.
Różne klasy funkcji zarządzania routerami
Funkcje zarządzania routerem można podzielić na funkcje administracyjne i funkcje konfiguracji. Funkcje administracyjne mają prefiks MprAdmin, a funkcje konfiguracji mają prefiks MprConfig. Pomimo nazewnictwa oba zestawy funkcji są używane do zarządzania routerami. Funkcje MprAdmin działają bezpośrednio na uruchomionym routerze. Funkcje MprConfig mają podobne funkcje, ale działają w konfiguracji routera przechowywanej w rejestrze. Oba typy funkcji przekazują bloki informacji.
Funkcje zarządzania routerami można również podzielić na podstawie składników routera, którymi zarządzają: interfejsy, menedżerowie routerów lub klienci menedżera routerów.
Funkcje interfejsu routera mają prefiks MprAdminInterface lub MprConfigInterface. Użyj tych funkcji, aby uzyskać dostęp do interfejsów. Funkcje menedżera routera mają prefiks MprAdminTransport lub MprConfigTransport. Użyj tych funkcji, aby uzyskać dostęp do menedżerów routerów. Na koniec funkcje klienta menedżera routera mają prefiks MprAdminInterfaceTransport lub MprConfigInterfaceTransport. Użyj tych funkcji, aby uzyskać dostęp do klientów uruchomionych na routerze.
Podzbiór funkcji MprAdmin to funkcje MprAdminMib. Działają one również wyłącznie na trasie biegania. Jednak te funkcje nie przekazują bloków informacji. Te funkcje zapewniają dodatkową elastyczność projektanta protokołów, zwłaszcza w przypadku pobierania informacji niekonfiguracyjnych, takich jak statystyki.
Zapewnienie, że zmiany następują natychmiastowo i są trwałe
Deweloper może wprowadzić zmiany w konfiguracji routera bezpośrednio przy użyciu funkcji konfiguracji routera . Jednak wszelkie zmiany dokonane w konfiguracji nie zostaną wprowadzone do momentu ponownego uruchomienia routera, ponieważ jest to jedyny moment, kiedy DIM odczytuje konfigurację z rejestru.
Deweloper może wprowadzić zmiany w uruchomionym routerze przy użyciu funkcji administracji routera . Jednak te zmiany nie są trwałe: ponieważ nie zostały zapisane w rejestrze, zostaną utracone w przypadku ponownego uruchomienia routera.
Aby wprowadzić zmiany, które są zarówno natychmiastowe, jak i trwałe, deweloper musi korzystać zarówno z funkcji administracji routera, jak i konfiguracji routera. Jeśli router nie jest uruchomiony, deweloper musi wywołać tylko odpowiednie funkcje konfiguracji routera.
Aby wykonywać zapytania dotyczące informacji z uruchomionego routera, użyj funkcji administracyjnych routera. Jeśli router nie jest uruchomiony, wykonaj zapytanie dotyczące informacji przy użyciu funkcji konfiguracji routera.
Funkcje MprAdminInterfaceCreate i MprAdminInterfaceSetInfo obsługują strukturę MPR_INTERFACE_2. Jednak MprConfigInterfaceCreate i MprConfigInterfaceSetInfo nie. Aby utworzyć interfejs wybierania numeru na żądanie, który jest trwały po ponownym uruchomieniu, wywołaj MprAdminInterfaceUtwórz za pomocą MPR_INTERFACE_2, a następnie wywołaj MprConfigInterfaceUtwórz za pomocą MPR_INTERFACE_0 lub MPR_INTERFACE_1. Podobnie, aby wprowadzić trwałe zmiany w interfejsie wybierania numerów na żądanie, wywołaj MprAdminInterfaceSetInfo za pomocą MPR_INTERFACE_2, a następnie wywołaj MprConfigInterfaceSetInfo za pomocą MPR_INTERFACE_0 lub MPR_INTERFACE_1.
Zdalne używanie funkcji administracji routera i konfiguracji
Większość funkcji administracji i konfiguracji routera może być wywoływana na komputerze innym niż administrowany. Te funkcje przyjmują jako parametr, dojście do usługi routera lub konfiguracji do administrowania. Funkcje administracyjne używają zdalnego wywołania procedur (RPC) do komunikacji z określoną usługą routingu przez uchwyt. Funkcje konfiguracji zapisują do i odczytują z rejestru komputera określonego przez uchwyt.
Aby administrować usługą routingu na maszynie zdalnej, najpierw wywołaj MprAdminIsServiceRunning w celu sprawdzenia, czy usługa jest uruchomiona. Następnie wywołaj MprAdminServerConnect, aby uzyskać dojście. Jeśli usługa routera nie jest uruchomiona na maszynie zdalnej, wszystkie wywołania administracyjne routera (MprAdmin) kończą się niepowodzeniem.
Aby wprowadzić zmiany w konfiguracji routera na maszynie zdalnej, uzyskaj uchwyt przez wywołanie funkcji MprConfigServerConnect.