KB253254: How to configure Usher Professional in MicroStrategy 10.1 Secure Enterprise Hotfix 1

Summary

Strategy 10.1 Secure Enterprise Hotfix 1 enables users to perform reporting on the Usher Professional environments. To set up a Strategy 10.1 Secure Enterprise Hotfix 1 Linux environment for Usher Professional the following steps need to be performed.
 

Overview

Step I: Import the Strategy 10.1 Hotfix 1 Usher Professional Package.
Step II: Create an Usher Professional Strategy 10.1 Hotfix 1 Mobile Configuration.
Step III: Enable Access to Usher Professional for all users or for network administrators only.
 

I. Import Strategy 10.1 Hotfix 1 Usher Professional Package 

• In the Intelligence Server, navigate to the Usher Installation as below:
   
  

  
  /opt/pol/Usher/UsherAnalytics/conf

  
  
• Execute the script with the name: usherpro_2.4.06-01.sh
   
• Provide the Strategy Project Source, Administrator User and Password.
   
• Confirm that the Intelligence Server will be restarted,
  If the parameters are provided correctly, the sample output below will be displayed:
  
  

• Execute the script with the name usherpro_2.4.07.sh
• Repeat step 3 and 4 with this second script. 
   

II. Create an Usher Professional Strategy 10.1 Hotfix 1 Mobile Configuration

Usher Professional must be configured using the Mobile Administrator Web Interface using the method below:
 

Configure Usher Professional for iPad and iPhone using the Mobile Administrator 

• Navigate to the Usher Installation images folder typically the one below:
   
  

  
  /opt/pol/Usher/UsherMobile/conf/usherpro

  
  
• Copy all the image files in the path of step 1 to the images folder in the Mobile Server typically the one below:
   
  

  
  <tomcat_home>/<webapp_directory>/MicroStrategyMobile/images/usherpro

  
  
• Restart the Mobile Server
• Launch the Strategy 10.1 Hotfix 1 Mobile Administrator and click on Mobile Configuration on the left.
• Click "Create new configuration" and choose "iPad"
  Note: for iPhone choose the "iPhone" option.
• In the iPad/iPhone Settings tab check the box "Clear caches when the application closes" as shown in the image below:
  
  

• In the Connectivity Settings tab fill the information for the Mobile Server and the login and password for the Usher Analytics project. 
• Click on "Configure New Project" and select the Usher Analytics Strategy Project. 
  A sample of the configurations for the above steps is shown below
  
  

• In the Home Screen tab choose the "Display a custom home screen" radio button. 
• Login with the user name and password. 
• Once logged in, navigate to the "Usher Pro iPad" document under the following path:
   
  

  
  Public Objects > Shared Reports > Usher Mobile Reporting > iPad 1.1.1

  
  
  As shown in the image below:
  
  

• Note: iPhone navigate to the "Usher Pro iPhone" document in the following path:
   
  

  
  Public Objects > Shared Reports > Usher Mobile Reporting > iPhone

  
  
• Navigate to the Mobile Administrator page and generate the configuration URL by clicking the "Generate URL" button. A sample URL is show below:
  
  

• Modify the Generated URL according to the device as explained below:
  a. iPad: Replace mstr:// to mstrusheripad:// as shown below:
  
  mstrusheripad://?url=http%3A%2F%2Fmycompany.usher.com%3A80%2FStrategyMobile%2Fasp%2FTaskProc.aspx%3FtaskId%3DgetMobileConfiguration%26taskEnv%3Dxml%26taskContentType%3Dxmlanf%26configurationID%3D781d8457-8206-4f2e-8a87-9f423d95e4fe&authMode=1&dt=2
  
  b. iPhone: Replace mstr:// to mstrusher:// as shown below:
  
  mstrusher://?url=http%3A%2F%2Fmycompany.usher.com%3A80%2FStrategyMobile%2Fasp%2FTaskProc.aspx%3FtaskId%3DgetMobileConfiguration%26taskEnv%3Dxml%26taskContentType%3Dxmlanf%26configurationID%3D551d8667-8206-4f2c-8a87-9f447d95e4fe&authMode=1&dt=1
   

III. Enable access to Usher Professional for all users or for network administrators only 

• Login to the Usher Network Manager: 
  a. In a web browser, navigate to https://go.usher.com/ or your organization's custom Usher Network Manager home page.
  b. Open your smartphone and access the Usher Security Application
  c. Tap the administrator badge for the network you want to login to.
  d. Swipe up to display the QR code reader and scan the QR code that displays in the browser screen for Usher Network Manager.
• Click on Network Management
• In the Badge Management area, click Properties
• Click Basic
• Select one of the following:
  
• To restrict access to the Usher Professional app to your Usher network administrators only, turn the Limit access to Usher Pro switch on.
• To allow all users in your network to view information about other users via the Usher Professional app, turn the Limit access to Usher Pro switch off (default).
• Click Save.
• Configure the Out of the Box Usher Professional App to the currently used organization's Metadata
  a. In the Network Manage page navigate as an administrator to:
  https://mycompany.usher.com/networkmanager/managesystem
  Re-scan the QR code for the Network Administrator.
  b.Copy the Mobile Configuration links generated in the section II of this document and copy them in the respective sections of "Usher Professional Mobile Configuration" as shown below:
  

• c. Click "Next".
  d. Click "Save". The Usher Pro app is now configured. When the app is launched it will automatically configure to the organization's Usher environment.