Descripción de las funciones de administración de enrutadores

En las secciones siguientes se describen los diferentes tipos de funciones de administración de enrutadores y lo que debe saber para usarlos de forma eficaz.

Todas las funciones de administración de enrutadores requieren privilegios de administrador. Un usuario del grupo de usuarios avanzados no tiene privilegios suficientes para usar las funciones de administración del enrutador.

Las distintas clases de funciones de administración de enrutadores

Las funciones de administración del enrutador se pueden dividir en las funciones de administración y las funciones de configuración. Las funciones de administración tienen un prefijo mprAdmin y las funciones de configuración tienen un prefijo de MprConfig. A pesar de la nomenclatura, ambos conjuntos de funciones se usan para la administración de enrutadores. Las funciones MprAdmin funcionan directamente en el enrutador en ejecución. Las funciones MprConfig tienen una funcionalidad similar, pero funcionan en la configuración del enrutador almacenada en el registro. Ambos tipos de funciones pasan bloques de información.

Las funciones de administración de enrutadores también se pueden dividir en función de los componentes del enrutador que administran: interfaces, administradores de enrutadores o clientes de administrador de enrutadores.

Las funciones de interfaz de enrutador tienen un prefijo de MprAdminInterface o MprConfigInterface. Use estas funciones para acceder a las interfaces. Las funciones del administrador de enrutadores tienen un prefijo mprAdminTransport o MprConfigTransport. Use estas funciones para acceder a los administradores de enrutadores. Por último, las funciones de cliente del administrador de enrutadores tienen un prefijo MprAdminInterfaceTransport o MprConfigInterfaceTransport. Use estas funciones para acceder a los clientes que se ejecutan en el enrutador.

Un subconjunto de funciones MprAdmin son las funciones MprAdminMib. También funcionan solo en la ruta en ejecución. Sin embargo, estas funciones no pasan bloques de información. Estas funciones proporcionan flexibilidad adicional al diseñador de protocolos, especialmente para recuperar información que no sea de configuración, como estadísticas.

Asegurarse de que los cambios se producen inmediatamente y son persistentes

Un desarrollador puede realizar cambios en la configuración del enrutador directamente mediante las funciones de configuración del enrutador. Sin embargo, los cambios realizados en la configuración no surten efecto hasta que se reinicie el enrutador, ya que es la única vez que DIM lee la configuración del registro.

Un desarrollador puede realizar cambios en el enrutador en ejecución mediante las funciones de administración del enrutador. Sin embargo, estos cambios no son persistentes: puesto que no se han escrito en el registro, se pierden si se reinicia el enrutador.

Para realizar cambios que sean inmediatos y persistentes, un desarrollador debe usar tanto la administración del enrutador como las funciones de configuración del enrutador. Si el enrutador no se está ejecutando, el desarrollador solo necesita llamar a las funciones de configuración de enrutador adecuadas.

Para consultar información del enrutador en ejecución, use las funciones de administración del enrutador. Si el enrutador no se está ejecutando, consulte la información mediante las funciones de configuración del enrutador.

Las funciones MprAdminInterfaceCreate y MprAdminInterfaceSetInfo admiten la estructura MPR_INTERFACE_2 . Sin embargo, MprConfigInterfaceCreate y MprConfigInterfaceSetInfo no lo hacen. Para crear una interfaz de marcado a petición que sea persistente después de un reinicio, llame a MprAdminInterfaceCreate con MPR_INTERFACE_2 y, a continuación, llame a MprConfigInterfaceCreate con MPR_INTERFACE_0 o MPR_INTERFACE_1. De forma similar, para realizar cambios persistentes en una interfaz de marcado a petición, llame a MprAdminInterfaceSetInfo con MPR_INTERFACE_2 y, a continuación, llame a MprConfigInterfaceSetInfo con MPR_INTERFACE_0 o MPR_INTERFACE_1.

Uso de funciones de configuración y administración de enrutadores de forma remota

La mayoría de las funciones de configuración y administración de enrutadores se pueden llamar en un equipo distinto del que se administra. Estas funciones toman como parámetro, un identificador para el servicio de enrutador o la configuración que se va a administrar. Las funciones de administración usan RPC (llamada a procedimiento remoto) para comunicarse con el servicio de enrutamiento especificado por el identificador. Las funciones de configuración escriben y leen desde el registro del equipo especificado por el identificador.

Para administrar el servicio de enrutamiento en una máquina remota, llame primero a MprAdminIsServiceRunning para comprobar que el servicio se está ejecutando. A continuación, llame a MprAdminServerConnect para obtener el identificador. Si el servicio de enrutador no se está ejecutando en la máquina remota, se producirá un error en todas las llamadas de administración de enrutadores (MprAdmin).

Para realizar cambios en la configuración del enrutador en un equipo remoto, obtenga un identificador mediante una llamada a la función MprConfigServerConnect .