Strategy ONE

Implementar MicroStrategy Web y Mobile Server

Suponiendo que ha realizado todas las configuraciones necesarias descritas en Información de preconfiguración, puede empezar a implementar MicroStrategy Web (JSP) y Mobile Server (JSP) con JBoss.

Implementación usando JBoss como contenedor web independiente

Para desplegar las aplicaciones MicroStrategy JSP con JBoss como contenedor de Web independiente

Estos son los pasos para implementar MicroStrategy Web (JSP) con una carpeta expandida. Si desea implementar MicroStrategy Mobile Server (JSP), debe cambiar MicroStrategy.war a MicroStrategyMobile.war en los pasos a continuación.

  1. Descomprimir MicroStrategy.war en la JBOSS_EAP_HOME/standalone/deployments/ directorio.

  2. Cree un archivo vacío llamado MicroStrategy.war.dodeploy.

  3. Inicie el servidor ejecutando la standalone.sh o standalone.bat comando.

Su aplicación MicroStrategy JSP se implementa automáticamente en función de lo siguiente:

  • Si ha configurado JBoss para implementar un archivo WAR expandido, lo cual suele ser el comportamiento por defecto, se crea una carpeta dentro del JBOSS_HOME\server\default\deploy directorio:
    • Al implementar MicroStrategy Web (JSP), la carpeta se llama MicroStrategy por defecto.
    • Al implementar MicroStrategy Mobile Server (JSP), la carpeta se llama MicroStrategyMobile por defecto.
  • Si ha configurado JBoss para implementar un archivo WAR sin explotar, los archivos de configuración se crean dentro del directorio de archivos temporales predeterminado del sistema. En los sistemas Windows, el directorio de archivos temporales suele definirlo el TMP variable de entorno:
    • Al implementar MicroStrategy Web (JSP), /microstrategy/web-Version/ se crea una carpeta en el directorio de archivos temporales, donde Version es el número de versión del producto MicroStrategy Web (JSP). Dentro de esta ubicación de carpeta, pueden encontrarse varios archivos de configuración dentro de la WEB-INF carpeta y sus subcarpetas.
    • Al implementar MicroStrategy Mobile Server (JSP), /microstrategy/mobile-Version/ se crea una carpeta en el directorio de archivos temporales, donde Version es el número de versión del producto MicroStrategy Mobile Server (JSP). Dentro de esta ubicación de carpeta, pueden encontrarse varios archivos de configuración dentro de la WEB-INF carpeta y sus subcarpetas.

Configurar el acceso de administrador a las aplicaciones JSP de MicroStrategy

Para permitir a los usuarios autorizados acceder a MicroStrategy Web Administrador, MicroStrategy Mobile Server Administrator, debe crear los usuarios y asignarles el rol de admin en los archivos de configuración del usuario de JBoss. Los pasos para configurar este acceso se encuentran a continuación.

Hasta configurar el acceso de administrador a las aplicaciones MicroStrategy JSP

  1. Navegar al directorio JBOSS_HOME\server\default\conf, donde JBOSS_HOME es la ubicación en la que ha instalado JBoss.
  2. Cree los dos archivos siguientes dentro de este directorio:
    • users.properties
    • roles.properties
  3. Abrir la users.properties en un editor de texto.
  4. Incluya una línea para cada usuario para conceder acceso de administrador al administrador de Web y al administrador de Mobile Server con la siguiente sintaxis:
    ID_usuario=contraseña_de_usuario

    Por ejemplo, cree el UsuarioA y el UsuarioB con las contraseñas 1234 y 5678 respectivamente con la siguiente sintaxis:

    UserA=1234

    UserB=5678

  5. Guarde los cambios y cierre el users.properties archivo.
  6. Abrir la roles.properties en un editor de texto.
  7. Incluya una línea para cada usuario que haya incluido en el users.properties y concédales acceso de administrador utilizando la siguiente sintaxis:
    ID_usuario=admin

    Por ejemplo, puede definir UserA y UserB para que tengan acceso de administrador utilizando la siguiente sintaxis:

    • UserA=admin
    • UserB=admin
  8. Guarde los cambios y cierre el roles.properties archivo.
  9. Para iniciar JBoss, vaya a JBOSS_HOME\bin. Luego ejecute el siguiente comando:
    run.bat -b 0.0.0.0

Ahora puede acceder a la aplicación MicroStrategy JSP y configurarla, tal y como se describe en Acceso a la página administrativa de la aplicación MicroStrategy JSP.

Acceso a la página administrativa de la aplicación MicroStrategy JSP

Siga los pasos a continuación para acceder a la página administrativa de su aplicación MicroStrategy JSP.

Hasta acceder a la página administrativa de la aplicación MicroStrategy JSP

  1. En un navegador web, acceda a la página administrativa especificando la siguiente URL:
    • Para Web (JSP): http://localhost:8080/MicroStrategy/servlet/mstrWebAdmin
    • Para Mobile Server (JSP): http://localhost:8080/MicroStrategyMobile/servlet/mstrWebAdmin

    Los nombres de servlet al final de los URL enumerados anteriormente distinguen entre mayúsculas y minúsculas. Asegúrese de utilizar las mayúsculas y minúsculas correctas al escribir el nombre del servlet. Si el servidor de aplicaciones está habilitado con seguridad, se abrirá un cuadro de diálogo relacionado con la autenticación de administrador.

  2. Cuando se le solicite un nombre de usuario y una contraseña, escriba el nombre de usuario para el usuario administrador que creó en el roles.properties y la información de inicio de sesión en el users.properties archivo.
  3. Después de estar autenticado:
    • Si está implementando MicroStrategy Web (JSP), aparece la página del Administrador de MicroStrategy Web. Agregue y conéctese a un Intelligence Server.
    • Si está implementando MicroStrategy Mobile Server (JSP), aparece la página del Administrador de MicroStrategy Mobile Server. Agregue y conéctese a un Intelligence Server. Una vez conectado, haga clic en Configuración móvil para configurar sus aplicaciones de MicroStrategy Mobile de modo que se comuniquen con Mobile Server e Intelligence Server. Para conocer los pasos para definir esta configuración, consulte el MicroStrategy Mobile Ayuda de administración. La creación de una configuración completa los pasos necesarios para desplegar Mobile Server (JSP).
  4. Si está implementando MicroStrategy Web (JSP), inicie la página del proyecto de MicroStrategy Web. En un navegador de web, acceda al proyecto de MicroStrategy Web usando esta URL:

    http://localhost:8080/MicroStrategy/servlet/mstrWeb

Crear un usuario para acceso de administrador a las aplicaciones JSP de MicroStrategy

Para permitir a los usuarios autorizados acceder al Administrador de MicroStrategy Web o al Administrador de servidores de MicroStrategy Mobile, debe crear un usuario para ApplicationRealm y asignarlo a admin rol. Los pasos para configurar este acceso se encuentran a continuación.

Para crear un usuario con acceso de administrador a las aplicaciones JSP de MicroStrategy

  1. Abra un terminal y cambie a la JBOSS_EAP_HOME/bin/ directorio. Si ejecuta Linux u otro sistema operativo similar a UNIX, ejecute add-user.sh. Si ejecuta Microsoft Windows Server, ejecute add-user.bat.

  2. Elija si desea agregar un usuario de gestión o un usuario de aplicación. Intro b para agregar un usuario de la aplicación al directorio predeterminado. ApplicationRealm.

  3. Introduzca el nombre de usuario, la contraseña y los roles que desee cuando se le solicite. Verifique su elección escribiendo yes o introduciendo no para cancelar los cambios. Los cambios se escriben en cada uno de los archivos de propiedades del dominio de seguridad. Cuando se le solicite, What groups do you want this user to belong to? (Please enter a comma separated list, or leave blank for none)[ ]:, entrar admin para asignar el usuario al admin rol.

  4. Inicie el servidor ejecutando la standalone.sh o standalone.bat comando.

    Ahora puede acceder a la aplicación MicroStrategy JSP y configurarla, tal y como se describe en Acceso a la página administrativa de la aplicación MicroStrategy JSP.

Solución de problemas

En determinadas circunstancias, puede aparecer un error en una solicitud que involucre JSON:

"Cuerpo JSON no válido, tipo ilegal (com.microstrategy.rest.model.filter.viewfilter.BranchExpression) para deserializar: impedido por razones de seguridad;"

En los registros del servidor web, también puede aparecer un mensaje de advertencia similar:

WARN [org.jboss.as.jaxrs] (subproceso de servicio de MSC 1-2) WFLYRS0018: uso explícito de la anotación Jackson en un despliegue de JAX-RS; el sistema deshabilitará el procesamiento de JSON-B para la implementación actual. Considere establecer la propiedad 'resteasy.preferJacksonOverJsonB' en 'false' para restaurar JSON-B.

Cuando esto ocurre, JBoss debe configurarse para deshabilitar Jackson. Esto puede hacerse mediante:

  • Iniciando el servidor JBoss con la siguiente opción:

    ./bin/standalone.sh  -Dresteasy.preferJacksonOverJsonB=FALSE
  • O creando una exclusión en la etiqueta en la estructura xml para el org.jboss.resteasy.resteasy-json-binding-provider módulo.

Consulte la documentación de JBoss para RESTEasy JAX-RS para obtener más información acerca de esta situación.