Deploying Strategy Web and Mobile Server

Assuming you have made all the necessary configurations described in Preconfiguration Information, you can begin deploying Strategy Web (JSP) and Mobile Server (JSP) with JBoss.

• Deploying using JBoss as a stand-alone Web container
• Configuring administrative access to Strategy JSP applications
• Accessing the Strategy JSP application administrative page
• Troubleshooting

Deploying using JBoss as a stand-alone Web container

To deploy Strategy JSP applications using JBoss as a stand-alone Web container

Here are the steps to deploy Strategy Web (JSP) with an exploded folder. If you want to deploy Strategy Mobile Server (JSP), you need to change MicroStrategy.war to MicroStrategyMobile.war in the steps below.

1. Unzip MicroStrategy.war into the JBOSS_EAP_HOME/standalone/deployments/ directory.

2. Create an empty file named MicroStrategy.war.dodeploy.

3. Start the server by running the standalone.sh or standalone.bat command.

Your Strategy JSP application is deployed automatically, based on the following:

• If you have configured JBoss to deploy an exploded WAR file, which is often the default behavior, a folder is created within the JBOSS_HOME\server\default\deploy directory:
  • When deploying Strategy Web (JSP), the folder is named MicroStrategy by default.
  • When deploying Strategy Mobile Server (JSP), the folder is named MicroStrategyMobile by default.
• If you have configured JBoss to deploy an unexploded WAR file, the configuration files are created within the system's default temporary file directory. For Windows systems, the temporary file directory is commonly defined by the TMP environment variable:
  • When deploying Strategy Web (JSP), a /microstrategy/web-Version/ folder is created within the temporary file directory, where Version is the version number for the Strategy Web (JSP) product. Within this folder location, various configuration files can be found within the WEB-INF folder and its subfolders.
  • When deploying Strategy Mobile Server (JSP), a /microstrategy/mobile-Version/ folder is created within the temporary file directory, where Version is the version number for the Strategy Mobile Server (JSP) product. Within this folder location, various configuration files can be found within the WEB-INF folder and its subfolders.

Configuring administrative access to Strategy JSP applications

To allow users authorized to access Strategy Web Administrator, Strategy Mobile Server Administrator, you must create the users and assign them the role of admin under the JBoss user configuration files. The steps to configure this access are below.

To configure administrative access to Strategy JSP applications

1. Browse to the directory JBOSS_HOME\server\default\conf, where JBOSS_HOME is the location in which you installed JBoss.
2. Create the following two files within this directory:
   • users.properties
   • roles.properties
3. Open the users.properties file in a text editor.
4. Include one line for each user to grant administrative access to the Web Administrator and Mobile Server Administrator, using the following syntax:

   user_id=user_password

   For example, you create UserA and UserB with passwords 1234 and 5678 respectively using the following syntax:

   UserA=1234

   UserB=5678

5. Save your changes and close the users.properties file.
6. Open the roles.properties file in a text editor.
7. Include one line for each user you included in the users.properties file and grant them administrative access, using the following syntax:

   user_id=admin

   For example, you define UserA and UserB to have administrative access using the following syntax:

   • UserA=admin
   • UserB=admin
8. Save your changes and close the roles.properties file.
9. To start JBoss, browse to JBOSS_HOME\bin. Then run the following command:

   run.bat -b 0.0.0.0

Now you can access and configure your Strategy JSP application, as described in Accessing the Strategy JSP application administrative page.

Accessing the Strategy JSP application administrative page

You can use the steps below to access the administrative page for your Strategy JSP application.

To access the Strategy JSP application administrative page

1. In a Web browser, access the administrative page by specifying the following URL:
   • For Web (JSP): http://localhost:8080/MicroStrategy/servlet/mstrWebAdmin
   • For Mobile Server (JSP): http://localhost:8080/MicroStrategyMobile/servlet/mstrWebAdmin

   The servlet names at the end of the URLs listed above are case-sensitive. Make sure to use the correct case when typing the servlet name. If the application server is enabled with security, a dialog box related to the administrator authentication opens.

2. When prompted for a user name and password, type the user name for the administrator user you created in the roles.properties file and the login information in the users.properties file.
3. After you are authenticated:
   • If you are deploying Strategy Web (JSP), the Strategy Web Administrator page appears. Add and connect to an Intelligence Server.
   • If you are deploying Strategy Mobile Server (JSP), the Strategy Mobile Server Administrator page appears. Add and connect to an Intelligence Server. Once connected, click Mobile Configuration to configure your Strategy Mobile applications to communicate with Mobile Server and Intelligence Server. For steps on how to define this configuration, see the MicroStrategy Mobile Ayuda de administración. Creating a configuration completes the steps required to deploy Mobile Server (JSP).
4. If you are deploying Strategy Web (JSP), proceed to launch the Strategy Web project page. In a Web browser, access Strategy Web project using this URL:

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

Creating a user for administrative access to Strategy JSP applications

To allow users authorized to access Strategy Web Administrator or Strategy Mobile Server Administrator, you must create a user to ApplicationRealm and map it to admin role. The steps to configure this access are below.

To create a user for administrative access to Strategy JSP applications

1. Open a terminal and change to the JBOSS_EAP_HOME/bin/ directory. If you run Linux or another UNIX-like operating system, run add-user.sh. If you run Microsoft Windows Server, run add-user.bat.

2. Choose whether to add a Management User or Application User. Enter b to add an Application User to the default ApplicationRealm.

3. Enter the desired username, password, and roles when prompted. Verify your choice by entering yes, or entering no to cancel the changes. The changes are written to each of the properties files for the security realm. When prompted, What groups do you want this user to belong to? (Please enter a comma separated list, or leave blank for none)[ ]:, enter admin to map the user to the admin role.

4. Start the server by running the standalone.sh or standalone.bat command.

   Now you can access and configure your Strategy JSP application, as described in Accessing the Strategy JSP application administrative page.

Troubleshooting

Under certain circumstances, an error in a request involving JSON may appear:

"Invalid JSON body, Illegal Type (com.microstrategy.rest.model.filter.viewfilter.BranchExpression) to deserialize: prevented for security reasons;"

In the Web server logs, a similar warning message may also appear:

WARN  [org.jboss.as.jaxrs] (MSC service thread 1-2) WFLYRS0018: Explicit usage of Jackson annotation in a JAX-RS deployment; the system will disable JSON-B processing for the current deployment. Consider setting the 'resteasy.preferJacksonOverJsonB' property to 'false' to restore JSON-B.

When this occurs JBoss must be configured to disable Jackson. This can by done by:

• Starting JBoss server with the following option:

  ./bin/standalone.sh  -Dresteasy.preferJacksonOverJsonB=FALSE

• Or creating an exclusion in tag in the structure xml for the org.jboss.resteasy.resteasy-json-binding-provider module.

See the JBoss documentation for RESTEasy JAX-RS for more information about this situation.