MicroStrategy ONE

Déploiement de MicroStrategy Web et Mobile Server

En supposant que vous avez effectué toutes les configurations nécessaires décrites dans Informations de préconfiguration, vous pouvez commencer à déployer MicroStrategy Web (JSP) et Mobile Server (JSP) avec JBoss.

Déploiement à l'aide de JBoss en tant que conteneur Web autonome

Pour déployer des applications MicroStrategy JSP en utilisant JBoss comme conteneur Web autonome

Voici les étapes à suivre pour déployer MicroStrategy Web (JSP) avec un dossier éclaté. Si vous souhaitez déployer MicroStrategy Mobile Server (JSP), vous devez modifier MicroStrategy.war à MicroStrategyMobile.war dans les étapes ci-dessous.

  1. Décompresser MicroStrategy.war dans JBOSS_EAP_HOME/standalone/deployments/ répertoire.

  2. Créez un fichier vide nommé MicroStrategy.war.dodeploy.

  3. Démarrez le serveur en exécutant la standalone.sh ou en standalone.bat commande.

Votre application MicroStrategy JSP est déployée automatiquement, en fonction des éléments suivants :

  • Si vous avez configuré JBoss pour déployer un fichier WAR éclaté, qui est souvent le comportement par défaut, un dossier est créé dans JBOSS_HOME\server\default\deploy répertoire :
    • Lors du déploiement de MicroStrategy Web (JSP), le dossier est nommé MicroStrategy par défaut.
    • Lors du déploiement de MicroStrategy Mobile Server (JSP), le dossier est nommé MicroStrategyMobile par défaut.
  • Si vous avez configuré JBoss pour déployer un fichier WAR non éclaté, les fichiers de configuration sont créés dans le répertoire de fichiers temporaires par défaut du système. Pour les systèmes Windows, le répertoire des fichiers temporaires est généralement défini par TMP variable d'environnement :
    • Lors du déploiement de MicroStrategy Web (JSP), une /microstrategy/web-Version/ Le dossier est créé dans le répertoire du fichier temporaire, où Version est le numéro de version du produit MicroStrategy Web (JSP). Dans cet emplacement de dossier, divers fichiers de configuration peuvent être trouvés dans WEB-INF dossier et ses sous-réseaux.
    • Lors du déploiement de MicroStrategy Mobile Server (JSP), un /microstrategy/mobile-Version/ Le dossier est créé dans le répertoire du fichier temporaire, où Version est le numéro de version du produit MicroStrategy Mobile Server (JSP). Dans cet emplacement de dossier, divers fichiers de configuration peuvent être trouvés dans WEB-INF dossier et ses sous-réseaux.

Configuration de l'accès administratif aux applications MicroStrategy JSP

Pour autoriser les utilisateurs à accéder à l'administrateur MicroStrategy Web, MicroStrategy Administrateur Mobile Server, vous devez créer les utilisateurs et leur attribuer le rôle de admin sous les fichiers de configuration utilisateur JBoss. Les étapes pour configurer cet accès sont ci-dessous.

À configurer l'accès administratif aux applications MicroStrategy JSP

  1. Parcourir le répertoire JBOSS_HOME\server\default\conf, où JBOSS_HOME est l'emplacement où vous avez installé JBoss.
  2. Créez les deux fichiers suivants dans ce répertoire :
    • users.properties
    • roles.properties
  3. Ouvrir la users.properties fichier dans un éditeur de texte.
  4. Ajoutez une ligne pour que chaque utilisateur accorde un accès administratif à l'administrateur Web et à l'administrateur du serveur Mobile, en utilisant la syntaxe suivante :
    user_id=mot de passe utilisateur

    Par exemple, vous créez un utilisateurA et un utilisateurB avec les mots de passe 1234 et 5678 respectivement en utilisant la syntaxe suivante :

    UserA=1234

    UserB=5678

  5. Sauvegardez vos modifications et fermez la users.properties fichier.
  6. Ouvrir la roles.properties fichier dans un éditeur de texte.
  7. Inclure une ligne pour chaque utilisateur que vous avez inclus dans users.properties fichier et accordez-leur un accès administrateur, en utilisant la syntaxe suivante :
    user_id=admin

    Par exemple, vous définissez UserA et UserB comme ayant un accès administrateur en utilisant la syntaxe suivante :

    • UserA=admin
    • UserB=admin
  8. Sauvegardez vos modifications et fermez la roles.properties fichier.
  9. Pour démarrer JBoss, accédez à JBOSS_HOME\bin. Exécutez ensuite la commande suivante :
    run.bat -b 0.0.0.0

Vous pouvez désormais accéder à votre application MicroStrategy JSP et la configurer, comme indiqué dans Accès à la page d'administration de l'application MicroStrategy JSP.

Accès à la page d'administration de l'application MicroStrategy JSP

Vous pouvez suivre les étapes ci-dessous pour accéder à la page d'administration de votre application MicroStrategy JSP.

À accéder à la page d'administration de l'application MicroStrategy JSP

  1. Dans un navigateur Web, accédez à la page d'administration en spécifiant l'URL suivante :
    • Pour Web (JSP) : http://localhost:8080/MicroStrategy/servlet/mstrWebAdmin
    • Pour Mobile Server (JSP) : http://localhost:8080/MicroStrategyMobile/servlet/mstrWebAdmin

    Les noms de servlets à la fin des URL répertoriées ci-dessus sont sensibles à la casse. Assurez-vous d'utiliser la casse correcte lorsque vous saisissez le nom du servlet. Si le serveur d'application est activé avec la sécurité, une boîte de dialogue liée à l'authentification de l'administrateur s'affiche.

  2. Lorsque vous êtes invité à fournir un nom d'utilisateur et un mot de passe, saisissez le nom d'utilisateur de l'utilisateur administrateur que vous avez créé dans roles.properties fichier et les informations de connexion dans users.properties fichier.
  3. Après vous être authentifié :
    • Si vous déployez MicroStrategy Web (JSP), la page Administrateur MicroStrategy Web s'affiche. Ajoutez et connectez-vous à un Intelligence Server.
    • Si vous déployez MicroStrategy Mobile Server (JSP), la page Administrateur MicroStrategy Mobile Server s'affiche. Ajoutez et connectez-vous à un Intelligence Server. Une fois connecté, cliquez sur Configuration mobile pour configurer vos applications MicroStrategy Mobile afin de communiquer avec Mobile Server et Intelligencer Server. Pour connaître les étapes nécessaires à la définition de cette configuration, reportez-vous à la Aide MicroStrategy Mobile Administration. La création d'une configuration termine les étapes requises pour déployer Mobile Server (JSP).
  4. Si vous déployez MicroStrategy Web (JSP), continuez pour lancer la page de projet MicroStrategy Web. Dans un navigateur Web, accédez au projet MicroStrategy Web à l'aide de cette URL :

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

Création d'un utilisateur pour l'accès administrateur aux applications MicroStrategy JSP

Pour autoriser les utilisateurs à accéder à l'administrateur MicroStrategy Web ou à l'administrateur du serveur MicroStrategy Mobile, vous devez créer un utilisateur pour ApplicationRealm et mapper à admin rôle. Les étapes pour configurer cet accès sont ci-dessous.

Pour créer un utilisateur pour l'accès administrateur aux applications MicroStrategy JSP

  1. Ouvrez un terminal et passez à JBOSS_EAP_HOME/bin/ répertoire. Si vous exécutez Linux ou un autre système d'exploitation de type UNIX, exécutez add-user.sh. Si vous exécutez Microsoft Windows Server, exécutez add-user.bat.

  2. Choisissez si vous souhaitez ajouter un utilisateur de gestion ou un utilisateur d'application. Saisissez b pour ajouter un utilisateur d'application à l'utilisateur par défaut ApplicationRealm.

  3. Saisissez le nom d'utilisateur, le mot de passe et les rôles souhaités lorsque vous y êtes invité. Confirmez votre choix en saisissant yes, ou en saisissant no pour annuler les modifications. Les modifications sont écrites dans chacun des fichiers de propriétés du realm de sécurité. Lorsque vous y êtes invité, What groups do you want this user to belong to? (Please enter a comma separated list, or leave blank for none)[ ]:, saisissez admin pour mapper l'utilisateur à admin rôle.

  4. Démarrez le serveur en exécutant la standalone.sh ou en standalone.bat commande.

    Vous pouvez désormais accéder à votre application MicroStrategy JSP et la configurer, comme indiqué dans Accès à la page d'administration de l'application MicroStrategy JSP.

Résolution des problèmes

Dans certaines circonstances, une erreur dans une requête impliquant du JSON peut apparaître :

"Corps JSON non valide, type illégal (com.microstrategy.rest.model.filter.viewfilter.BranchExpression) à désérialiser : empêché pour des raisons de sécurité ;"

Dans les journaux du serveur Web, un message d'avertissement similaire peut également apparaître :

WARN [org.jboss.as.jaxrs] (fil de service MSC 1-2) WELYRS0018 : Utilisation explicite de l'annotation Jackson dans un déploiement JAX-RS ; le système désactivera le traitement JSON-B pour le déploiement actuel. Pensez à définir la propriété « resteasy.preferJacksonOverJsonB » sur « false » pour restaurer JSON-B.

Lorsque cela se produit, JBoss doit être configuré pour désactiver Jackson. Cela peut être fait par :

  • Démarrage du serveur JBoss avec l'option suivante :

    ./bin/Standalone.sh  -Dresteasy.preferJacksonOverJSONB=FALSE
  • Ou en créant une exclusion dans la balise dans la structure XML pour le org.jboss.resteasy.resteasy-json-binding-provider module.

Consultez la documentation de JBoss pour RESTEasy JAX-RS pour plus d'informations sur cette situation.