Informazioni sulle funzioni di gestione dei router

Le sezioni seguenti illustrano i diversi tipi di funzioni di gestione del router e cosa è necessario sapere per usarli in modo efficace.

Tutte le funzioni di gestione del router richiedono privilegi di amministratore. Un utente nel gruppo Power User non dispone di privilegi sufficienti per usare le funzioni di gestione del router.

Classi diverse di funzioni di gestione del router

Le funzioni di gestione del router possono essere suddivise nelle funzioni di amministrazione e nelle funzioni di configurazione. Le funzioni di amministrazione hanno un prefisso MprAdmin e le funzioni di configurazione hanno un prefisso mprConfig. Nonostante la denominazione, entrambi i set di funzioni vengono usati per la gestione del router. Le funzioni MprAdmin operano direttamente sul router in esecuzione. Le funzioni MprConfig hanno funzionalità simili, ma operano sulla configurazione del router archiviata nel Registro di sistema. Entrambi i tipi di funzioni passano blocchi di informazioni .

Le funzioni di gestione del router possono anche essere suddivise in base ai componenti del router gestiti: interfacce, gestioni router o client di gestione router.

Le funzioni dell'interfaccia router hanno un prefisso mprAdminInterface o MprConfigInterface. Usare queste funzioni per accedere alle interfacce. Le funzioni di gestione router hanno un prefisso MprAdminTransport o MprConfigTransport. Usare queste funzioni per accedere ai gestori router. Infine, le funzioni client di gestione router hanno un prefisso MprAdminInterfaceTransport o MprConfigInterfaceTransport. Usare queste funzioni per accedere ai client in esecuzione sul router.

Un sottoinsieme delle funzioni MprAdmin sono le funzioni MprAdminMib . Funzionano anche sul solo percorso in esecuzione. Tuttavia, queste funzioni non passano blocchi di informazioni. Queste funzioni offrono maggiore flessibilità alla finestra di progettazione dei protocolli, in particolare per il recupero di informazioni non di configurazione, ad esempio le statistiche.

Verifica che le modifiche si verifichino immediatamente e siano persistenti

Uno sviluppatore può apportare modifiche alla configurazione del router direttamente usando le funzioni di configurazione del router . Tuttavia, qualsiasi modifica apportata alla configurazione non diventa effettiva fino al riavvio del router, poiché è solo allora che DIM legge la configurazione dal registro di sistema.

Uno sviluppatore può apportare modifiche al router in esecuzione usando le funzioni di amministrazione del router . Tuttavia, queste modifiche non sono persistenti: poiché non sono state scritte nel Registro di sistema, vengono perse se il router viene riavviato.

Per apportare modifiche immediate e persistenti, uno sviluppatore deve usare sia l'amministrazione del router che le funzioni di configurazione del router. Se il router non è in esecuzione, lo sviluppatore deve chiamare solo le funzioni di configurazione del router appropriate.

Per eseguire query sulle informazioni dal router in esecuzione, usare le funzioni di amministrazione del router. Se il router non è in esecuzione, eseguire query sulle informazioni usando le funzioni di configurazione del router.

Le funzioni MprAdminInterfaceCreate e MprAdminInterfaceSet Info supportano la struttura MPR_INTERFACE_2. Tuttavia, MprConfigInterfaceCreate e MprConfigInterfaceSetInfo non lo fanno. Per creare un'interfaccia di chiamata su richiesta persistente dopo un riavvio, chiamare MprAdminInterfaceCreate con MPR_INTERFACE_2, quindi chiamare MprConfigInterfaceCreate con MPR_INTERFACE_0 o MPR_INTERFACE_1. Analogamente, per apportare modifiche persistenti a un'interfaccia di composizione della richiesta, chiamare MprAdminInterfaceSetInfo con MPR_INTERFACE_2, quindi chiamare MprConfigInterfaceSetInfo con MPR_INTERFACE_0 o MPR_INTERFACE_1.

Uso di Funzioni di amministrazione e configurazione del router in modalità remota

La maggior parte delle funzioni di amministrazione e configurazione del router può essere chiamata in un computer diverso da quello da amministrare. Queste funzioni prendono come parametro un handle per il servizio router o la configurazione da amministrare. Le funzioni di amministrazione usano RPC (Remote Procedure Call) per comunicare con il servizio di routing specificato dall'handle. Le funzioni di configurazione scrivono e leggono dal registro di sistema del computer specificato dall'handle.

Per amministrare il servizio di routing su un computer remoto, prima chiama MprAdminIsServiceRunning per verificare che il servizio sia in esecuzione. Chiamare quindi MprAdminServerConnect per ottenere l'handle. Se il servizio router non è in esecuzione nel computer remoto, tutte le chiamate di amministrazione del router (MprAdmin) hanno esito negativo.

Per apportare modifiche alla configurazione del router in un computer remoto, ottenere un handle chiamando la funzioneMprConfigServerConnect.