MicroStrategy ONE

Solución de problemas de su MicroStrategy Library Instalación

Asunto: Mi Library esta vacio

  1. Abre el Library Panel de control de administración y verifique que el servidor Intelligence esté configurado y ejecutándose.
  2. No se ha agregado ningún contenido a tu Library.
  3. Supervisar el error de la API REST

    Cuando el Library La aplicación web se comporta inesperadamente sin ningún mensaje de error, supervise los mensajes de error que devuelve el MicroStrategy API REST utilizando la herramienta de depuración del navegador web.

    1. Desde Chrome, abra Herramientas para desarrolladores.
    2. Abra la pestaña Red.
    3. Realice los pasos para reproducir.
    4. Compruebe que se capturen todas las solicitudes.
    5. Haga clic en una solicitud de red que le interese.
    6. Dentro de la ventana de información de solicitud, abra la pestaña Vista previa. Esto mostrará la respuesta en formato JSON.
    7. Busque cualquier solicitud de red que esté en rojo, ya que esto indica que la solicitud de API REST puede haber fallado. Si solo busca errores de API, haga clic en XHR opción para que la pestaña de red muestre todas las llamadas http(s), incluidas las API.
  4. Revise los registros de errores de MicroStrategyLibrary y busque errores de la consola en la herramienta de depuración del navegador.
  5. Asegúrese de tener el uso Library privilegio para todos los proyectos (ver Privilegios en Library Web), para que pueda acceder a los paneles de todos los proyectos.

Asunto: El servidor de colaboración no está disponible

  1. Si el ícono de notificación no está disponible:

  2. Si el ícono de notificación está disponible pero deshabilitado, el servidor de colaboración no está conectado. Haga clic en el icono y utilice el cuadro de diálogo del mensaje de error para comunicarse con su administrador.
  3. Supervisar el error de Web Socket

    Cuando el servidor de colaboración aparece dentro del Library falla sin un mensaje de error detallado, supervise el mensaje de error directamente desde los mensajes de Web Socket utilizando la herramienta de depuración del navegador web.

    1. Desde Chrome, abre Herramientas de desarrollo.
    2. Abra la pestaña de red.
    3. Realice los pasos para reproducir.
    4. Filtrar el tipo de solicitud por "WS" (WebSockets).
    5. Haga clic en una solicitud de red.
    6. Dentro de la ventana de información de solicitud, abra la pestaña Marcos. Esto mostrará las solicitudes y respuestas en formato JSON.
    • Si no ve ninguna solicitud, actualice la página. Es posible que la herramienta de depuración del navegador haya comenzado a capturar llamadas de red después de que se haya establecido la conexión Web Socket.
    • Si no ve ninguna solicitud incluso después de la actualización, la comunicación entre el Library El servidor web y de colaboración en su entorno se realiza mediante sondeo HTTP en lugar de un Web Socket debido a una limitación del entorno.

Errores de configuración comunes

  • Error que indica que se rechaza la conexión, como por ejemplo:
    • No se puede invocar el método del servidor de autenticación. Error: conecte ECONNREFUSED 127.0.0.1:8443 (código = ECONNREFUSED) No se puede conectar al servidor de autenticación.
    • Verifique que "authorizationServerUrl" utilice el mismo nombre de máquina que el "Nombre común" asociado con su certificado. En resumen, no puede abrir una conexión segura a una máquina si no tiene el certificado para esa misma máquina y el certificado no está firmado por una autoridad certificadora confiable.
  • Error que indica un problema con el certificado, como por ejemplo:
    • No se puede invocar el método del servidor de autenticación. Error: no se puede verificar el primer certificado <code=UNABLE_TO_VERIFY_LEAF_SIGNATURE>. No se puede conectar con el servidor de autenticación.
    • Verifique que los certificados especificados en el servidor de colaboración config.json El archivo es el mismo que se usa para crear el archivo de almacén de claves usado con Tomcat.

Diagnosticar problemas de conexión del servidor de colaboración

MicroStrategy Las instalaciones proporcionan una herramienta de diagnóstico de línea de comandos para solucionar problemas de conexión del servidor de colaboración.

Para invocar la herramienta de diagnóstico:

Windows:

Cambie el directorio de trabajo actual a <MicroStrategy_commonFiles_path>\nodejs.

Ejecute el comando:

Copiar 
node "<MicroStrategy_installed_path>\Collaboration Server\node_modules\mstr-collab-svc\diagnose.js" "<MicroStrategy_installed_path>\Collaboration Server\config.json"

Linux:

Ejecute el siguiente comando desde el /opt/mstr/MicroStrategy/install/CollaborationServer directorio para iniciar la herramienta de diagnóstico del servidor de colaboración:

Copiar 
./collaborationServer.sh diagnose

Al invocar la herramienta de diagnóstico en un sistema en ejecución se devolverá lo siguiente:

  • Ambos servidores dependientes se mostrarán como Conectados

  • El servidor de colaboración se muestra como Iniciado y en estado de ejecución.

  • Una lista de certificados confiables con el nombre y la fecha de vencimiento (solo si los certificados confiables están configurados en config.json archivo)

Errores comunes de la herramienta de diagnóstico

El servidor de colaboración se muestra como detenido

Esto significa que el servidor de colaboración no se está ejecutando. Debe iniciar el servidor de colaboración y volver a ejecutar la herramienta de diagnóstico.

El estado del servidor de colaboración se muestra como en pausa: Servidor de autorización no conectado

Archivos de certificado de CA confiables

La herramienta diagonística intentará leer cada ruta de archivo configurada en config.json archivo como un certificado de confianza. Puede haber varios certificados en un solo archivo. Aquí están los posibles resultados:

  • Éxito

  • Formato no compatible

  • Advertencia: Contiene un certificado caducado

  • Bloque PEM no válido

  • Éxito: 2 certificados

  • Advertencia: Contiene un certificado caducado (hay 2 certificados dentro de este archivo. Uno es válido y el otro está caducado)

Solución de problemas mediante el registro del servidor de colaboración

Si el registro del servidor de colaboración está habilitado, los registros creados por el servidor de colaboración proporcionarán información más detallada que incluye:

  • Ejecución de advertencias y errores
  • Solicitar actividades
  • Registros de notificación

Library Errores y advertencias de servidor a servidor de colaboración

Advertencia: Las claves secretas no coinciden

Library El servidor y el servidor de colaboración deben configurarse con la misma clave secreta (una cadena con un mínimo de 5 caracteres) para verificar la identidad del otro servidor. Si las claves secretas no coinciden, el Library El servidor no puede comunicarse con el servidor de colaboración. Funcionalidad como actualizar la configuración del servidor de colaboración en Library El panel de control de administración fallará. El Library El servidor en sí está bien para usar.

Advertencia: Falta el almacén de confianza en Library Servidor

Si el servidor de colaboración se ejecuta con TLS habilitado y utiliza un certificado firmado por una CA raíz privada, el Library Se requiere que el servidor presente el certificado correspondiente para poder establecer una comunicación segura. El administrador puede configurar un archivo de almacén de confianza en el Library servidor (ver MicroStrategy Library Propiedades de configuración del servidor). Si no se hace referencia al certificado requerido en el almacén de confianza, se generará esta advertencia. Con este aviso activo, el Library El servidor no puede comunicarse con el servidor de colaboración. Funcionalidad como actualizar la configuración del servidor de colaboración en Library El panel de control de administración fallará. El Library El servidor en sí está bien para usar.

Advertencia: No se puede establecer una conexión de socket desde el navegador al servidor de colaboración

En algunos casos, el Library El servidor puede comunicarse con el servidor de colaboración, pero es posible que los usuarios finales (navegadores) no puedan establecer comunicación con el servidor de colaboración (fallo al establecer una conexión de socket). Hay tres causas posibles:

  • El Library El servidor se ejecuta con TLS habilitado (URL que comienza con 'https') mientras que el servidor de colaboración se ejecuta con TLS deshabilitado (URL que comienza con 'http'). Algunos navegadores bloquearán cualquier solicitud a 'http' si el sitio web actual utiliza 'https'.

  • El servidor de colaboración se ejecuta con TLS habilitado pero utiliza un certificado firmado por una CA raíz privada. Algunos navegadores considerarán que dichas CA raíz privadas no son de confianza y bloquearán las solicitudes a esos servidores. Es posible que el administrador necesite agregar esas CA raíz privadas a la lista de confianza.

  • El administrador puede utilizar un nombre de host como 'localhost' como nombre de máquina para el servidor de colaboración en el Library servidor. Ese nombre de host sólo es reconocido por el Library servidor y no accesible desde otros usuarios (máquina cliente/navegadores).

    Puede haber dos causas:

    • No puedo encontrar la dirección IP para ese nombre de host: el usuario final puede actualizar el archivo de hosts en el sistema, lo que puede ayudar al sistema a resolver nombres de dominio en una dirección IP

    • La dirección IP no es visible para el usuario final: Puede ser una dirección IP local o el puerto no está expuesto al público.

Servidor de colaboración para Library Errores y advertencias del servidor

Advertencia: El servidor de colaboración no está dirigido a la versión actual Library Servidor.

Esto es sólo una advertencia: el servidor de colaboración está hablando con un usuario diferente. Library servidor. La corriente Library El servidor está bien para usar. Pueden surgir problemas potenciales cuando los dos Library Los servidores proporcionan datos diferentes.

Error: El servidor de colaboración no está dirigido a la versión actual Library Servidor y destino Library No se puede acceder al servidor.

Para este caso, las características relacionadas con la colaboración en Library no se pueden utilizar ya que el servidor de colaboración está en pausa debido a este error. El administrador puede optar por utilizar la versión actual. Library servidor como objetivo Library servidor para este servidor de colaboración.

Error: Objetivo Library No se puede acceder al servidor y no se puede configurar a través del Panel de control de administración

Hay dos casos en los que la UI de administración puede mostrar problemas sobre el servidor de colaboración actual pero no puede proporcionar ninguna solución para el problema:

  • Las claves secretas no coinciden entre los Library servidor y servidor de colaboración.

  • El servidor de colaboración está habilitado para TLS mediante un certificado firmado por una CA raíz privada, mientras que el Library Al servidor le falta el almacén de confianza para ese certificado.

Ambas causas conducirán a la Library El servidor no puede comunicarse con el servidor de colaboración y, por lo tanto, no puede controlar/actualizar la configuración del servidor de colaboración.

Error: No se puede acceder a la tienda de colaboración

El panel de control de administración actual no expone una interfaz para actualizar la Tienda de colaboración. El administrador puede actualizarlo manualmente a través de la configuración del servidor de colaboración.

Library Errores y advertencias de servidor a servidor Intelligence

Error: El servidor de inteligencia no es accesible

El administrador verá este mensaje de error cuando el Library El servidor no puede conectarse al servidor Intelligence actual.

El administrador verá este mensaje de error cuando el Library El servidor no puede conectarse al servidor Intelligence actual y la interfaz de usuario del administrador realizó correctamente una prueba de conexión utilizando el nombre de host y el puerto del servidor Intelligence actual. Lo más probable es que esto se deba al uso de una configuración TLS incorrecta.

Error: Requisito de versión mínima

Si el Library Si el servidor ha establecido un requisito mínimo de versión del servidor Intelligence y el servidor Intelligence actual no cumple con ese requisito, se mostrará este mensaje de error.