Cómo funciona la interfaz del usuario de NW
La interfaz del usuario web de NetWorker (NWUI) utiliza las siguientes tecnologías: HTML5, Apache Tomcat, Spring Framework, Angular Framework y la interfaz de programación de aplicaciones (API) de transferencia de estado representacional (REST). La aplicación NWUI se puede instalar en sistemas operativos Linux o Windows. Se puede instalar directamente en el servidor de NetWorker o en un host que no es el servidor de NetWorker.
Hay cuatro componentes importantes:
Estos componentes pueden estar en el mismo host o en hosts independientes.
- Front-end web: Esta es la capa de presentación escrita en HTML5 y Angular Framework que presenta las operaciones de NetWorker al usuario a través de un navegador web. El navegador web está conectado a los procesos de back-end de la interfaz del usuario.
- Back-end de la interfaz del usuario: La aplicación de back-end se escribe en Spring Framework. Utiliza Java y Apache Tomcat. La comunicación entre el front-end y el back-end, y entre el back-end y el servidor de NetWorker se realiza mediante llamadas internas de la API REST. El proceso de NWUI utiliza la instancia Apache Tomcat existente en el servidor de NetWorker o instala su propia instancia de Apache Tomcat si se instala de manera remota desde el servidor de NetWorker.
- Servidor de NetWorker: La infraestructura REST del servidor de NetWorker es responsable de recibir las llamadas de la API REST desde el back-end de la interfaz del usuario y de conectarlas a los componentes principales del servidor de NetWorker. El bus de mensajes rabbitMQ del servidor de NetWorker también se utiliza para la interacción con nsrjobd.
- AuthC: El componente de autenticación de NetWorker se utiliza para todas las necesidades de autenticación. El proceso de solicitud se comunica con AuthC para verificar las credenciales; después de la verificación, AuthC emite un token de tiempo, basado, firmado y cifrado. Los componentes de NetWorker utilizan este token para verificar al usuario y autorizar o no una operación solicitada. Por lo general, esto se encuentra en el servidor de NetWorker, pero se puede instalar en un host independiente.
La mayor parte de la comunicación se realiza mediante la API REST
, que permite la interacción con los recursos identificados por direcciones de identificador uniforme de recursos (URI). Utiliza verbos HTTP (HEAD, GET, PUT, POST, DELETE) para interactuar con los identificadores uniformes de recursos (URI) de manera sin estado. Estas llamadas a la API REST son internas para las operaciones de NetWorker y NWUI. No deben confundirse con la interfaz de la API REST de NetWorker que proporciona acceso programático a NetWorker para programar operaciones personalizadas que se describen en la Guía para desarrolladores de API REST de NetWorker.
Solución de problemas
Definición del problema
DETALLES
DEL PROBLEMAPara generar una descripción completa del problema, considere las siguientes preguntas:
- ¿Qué operación se intenta que no funciona?
- ¿Funciona esta operación cuando se inicia desde fuera de NWUI? (por ejemplo: ¿Desde NetWorker Management Console (NMC)?
- ¿El problema es coherente o intermitente?
- Si es intermitente, ¿hay un desencadenador conocido?
- ¿Esto funcionó mejor antes y, si es así, se aplicaron cambios conocidos antes y después de que apareció el problema?
- ¿Cuándo ocurrió el problema por primera vez (y qué cambió desde que apareció el problema)?
- ¿El problema ocurre solo en momentos de carga pesada en el entorno de respaldo?
- ¿Cuál es el alcance del problema (todas las operaciones de recuperación/algunas operaciones de recuperación, algunas pestañas no funcionan mientras que otras no se ven afectadas)?
- ¿Qué se ha intentado solucionar hasta ahora y qué conclusiones se extrajeron de esto?
DETALLES DEL ENTORNO
- ¿Cuál es la versión del servidor NetWorker y la plataforma del sistema operativo?
- ¿NWUI está instalado en el servidor de NetWorker o en un host independiente?
- ¿Cuál es la versión de NWUI si se instala en un host separado del servidor de NetWorker?
- Qué paquete de Java está instalado en el servidor de NWUI; es NetWorker Runtime Environment (NRE) instalado o Oracle Java Runtime Environment (JRE).
Autenticación
La autenticación utiliza AuthC de la misma manera que NetWorker Management Console y el comando
nsrlogin . Para los problemas de autenticación, comience probando la autenticación en el propio servidor de NetWorker a fin de separar si el problema de autenticación está relacionado con la NWUI o no. Si utiliza un método de autenticación externo, como AD o LDAP, se recomienda probar primero la autenticación con cuentas locales de NetWorker para ver si el problema solo afecta al método de autenticación externo.
Un comando típico que se utiliza para probar si el proceso de autenticación funciona según lo esperado en el servidor de NetWorker es:
authc_mgmt -u [user name] -p [password] -e find-all-users.
O:
Cuenta local de NetWorker:
nsrlogin -u ACCOUNT -p PASSWORD
nsrlogout
Cuenta externa (AD/LDAP):
nsrlogin -t TENANT -d DOMAIN -u USERNAME -p PASSWORD
nsrlogout
Problemas de instalación
Problemas del navegador
Si hay varios navegadores instalados, pruebe el problema observado en diferentes navegadores para ver si el problema es específico de un navegador.
En el navegador, utilice el botón secundario e "inspeccione" para ver las llamadas de la API REST que se realizan desde el navegador, así como las declaraciones de registro y la información de conexión de red.
- Haga clic con el botón secundario en cualquier lugar de la ventana del navegador y seleccione "inspeccionar"
- Se abre una nueva ventana con varias pestañas. Es probable que las pestañas "Consola" y "Red" sean las más útiles.
- Con estas pestañas, podemos ver las llamadas exactas de la API REST que se realizan al servidor de NetWorker.
- En la pestaña Red, también podemos ver el método de solicitud y la respuesta de la API REST desde el servidor de NetWorker. De esta manera, podemos rastrear exactamente lo que se solicita del servidor de NetWorker y cómo el servidor de NetWorker está respondiendo a esta solicitud.
Problemas de back-end de la interfaz del usuario
Los registros importantes de back-end de la interfaz del usuario son los siguientes:
catalina.log: registro del servidor Tomcat y registro de implementación de aplicaciones.
nwui.log: registro del servidor de aplicaciones de NWUI.
restapi.log: registro de la API REST de NetWorker. NWUI se comunica con el servidor de NetWorker mediante la API REST de NetWorker.
daemon.raw: registro del servidor de NetWorker.
La ubicación de estos archivos de registro depende del sistema operativo que se utiliza, así como de si la instalación de la NWUI es local en el servidor de NetWorker o remota. Si la NWUI se encuentra en el servidor de NetWorker, entonces comparte la misma instancia tomcat con NetWorker.
Si proporciona un archivo de registro de .raw para admitirlo, se recomienda generar el archivo de registro en el sistema desde el cual se origina. Esto garantiza que los registros de fecha y hora se representen en la hora local del servidor:
NetWorker: Cómo utilizar nsr_render_log
Archivos de registro
Linux:
Los procesos que se ejecutan para el back-end de la interfaz del usuario son los siguientes: /opt/nwui/bin/nwuictld y jsvc.exec Puede comprobar si se están ejecutando con el comando ps:
Los registros están aquí:
Local para el servidor de NetWorker:
- /opt/nwui/logs
- /nsr/authc/logs/
- /nsr/logs/restapi/restapi.log
- /nsr/logs/daemon.raw
Remoto:
- /opt/nwui/logs
- /nsr/nwui/logs
Windows
El proceso de back-end de NWUI de Windows que se debe ejecutar se denomina nwuictld.exe:
Puede administrar esto desde services.msc:
Los registros están aquí:
Local para el servidor de NetWorker:
- C:\Archivos de programa\EMC NetWorker\nwui\logs
- C:\Archivos de programa\EMC NetWorker\nsr\authc-server\logs
- C:\Archivos de programa\EMC NetWorker\nsr\restapi\restapi.log
- C:\Program Files\EMC NetWorker\nsr\logs\daemon.raw
Remoto:
- C:\Archivos de programa\EMC NetWorker\nwui\logs
- %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[TIMESTAMP].log
- %LOCALAPPDATA%\Temp\NetWorker_Management_Web_UI_Server_[TIMESTAMP]_0_MCUI.log
Servidor de NetWorker
Ejecute la herramienta nsrget en el servidor de NetWorker para recopilar los registros pertinentes:
Networker: Cómo utilizar la herramienta
de recopilación de datos NSRGet NetWorkerLos registros más pertinentes dependen de la operación que se intenta desde la NWUI. Para obtener más información sobre los registros de NetWorker, consulte:
Networker: Ubicaciones y archivos de registro
Depuración
Para depurar la comunicación de la API REST, cambie el nivel de depuración en el archivo logback.xml en el servidor de NetWorker:
Windows: C:\Archivos de programa\EMC NetWorker\nsr\authc-server\tomcat\webapps\nwrestapi\WEB-INF\classes
Linux: /nsr/authc/webapps/nwrestapi/WEB-INF/classes
Quite la marca de comentario de las líneas que se ocupan del registro de llamadas de la API. Esto hace que el nivel de registro se configure en "trace" para las solicitudes y respuestas de la API REST.