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
- Configuration de l'accès administratif aux applications MicroStrategy JSP
- Accès à la page d'administration de l'application MicroStrategy JSP
- Résolution des problèmes
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.
-
Décompresser
MicroStrategy.war
dansJBOSS_EAP_HOME/standalone/deployments/
répertoire. -
Créez un fichier vide nommé
MicroStrategy.war.dodeploy
. -
Démarrez le serveur en exécutant la
standalone.sh
ou enstandalone.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.
- Lors du déploiement de MicroStrategy Web (JSP), le dossier est nommé
- 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 dansWEB-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 dansWEB-INF
dossier et ses sous-réseaux.
- Lors du déploiement de MicroStrategy Web (JSP), une
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
- Parcourir le répertoire
JBOSS_HOME
\server\default\conf
, oùJBOSS_HOME
est l'emplacement où vous avez installé JBoss. - Créez les deux fichiers suivants dans ce répertoire :
users.properties
roles.properties
- Ouvrir la
users.properties
fichier dans un éditeur de texte. - 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 utilisateurPar 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
- Sauvegardez vos modifications et fermez la
users.properties
fichier. - Ouvrir la
roles.properties
fichier dans un éditeur de texte. - 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
- Sauvegardez vos modifications et fermez la
roles.properties
fichier. - 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
- 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.
- Pour Web (JSP) :
- 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 dansusers.properties
fichier. - 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).
- 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
-
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écutezadd-user.sh
. Si vous exécutez Microsoft Windows Server, exécutezadd-user.bat
. -
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éfautApplicationRealm
. -
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 saisissantno
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)[ ]:
, saisissezadmin
pour mapper l'utilisateur àadmin
rôle. -
Démarrez le serveur en exécutant la
standalone.sh
ou enstandalone.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.