Create MicroStrategy Mobile configuration when using multiple Mobile Servers

How to create mobile configurations when load balancing is configured for multiple Mobile Servers when using MicroStrategy?

A mobile device configuration is a list of settings for a MicroStrategy Mobile application that are stored in a file on Mobile Server. 

Ideally in Production environments in MicroStrategy Enterprise  are clustered and If an administrator has setup two or more MicroStrategy Mobile Server machines behind a Load Balancer, it is important to keep in mind that the MicroStrategy Mobile Configurations created in one MicroStrategy Mobile server are not get automatically shared by the other MicroStrategy Mobile server nodes. This means that the Configuration only exists in one of the nodes of the cluster, thus all other nodes are missing the configuration. When users click on the link, the load balancer might direct the user to one mobile server that contains the configuration or might direct them to another node that does not contain the configuration, then below error will occur. This explains why the problem is intermittent, as the client device could be routed to different mobile servers every time.

Configuration Retrieval Error

?Configuration not found. Please see the log for details.

To fix this kind of issue, In an environment where load balancing is configured for multiple MicroStrategy Mobile servers, the mobile configuration needs to be configured using the following steps.

1. On the MicroStrategy Mobile Server, navigate to the folder:

 /WEB-INF/xml/mobile

  

2. Open the 'MobileConfigurationIndex.xml' file and make sure it is not pointing to any other Mobile configuration. 

Without any configuration the 'MobileConfigurationIndex.xml' will look as follows:

<cnfndx v="0" bld="9.0.628.176J"><cnfs/></cnfndx>

3. Open the MicroStrategy Mobile Administration page and create an iPad/iPhone configuration.

4. Open the 'Connectivity Settings' tab.

5. In the Mobile Server name parameter, provide the name of one of the MicroStrategy Mobile Servers, not of the Load Balancer, to prevent a request timeout error.

6. Fill in all other required fields.

7. Save and close the Mobile Configuration.

8. Based on the mobile configuration a new xml file will be created. This file can be found in the same folder location 

/WEB-INF/xml/mobile

and has the following nomenclature: 

mobileConfig-xxx-xxx-xxx-xxx.xml

9. Edit this 'mobileConfig-xxx-xxx-xxx-xxx.xml' file.

10. Find the parameter with the MicroStrategy Mobile server name and replace the server name with the Load Balancer's IP or server name and save the changes. E.g.

From:

<ws nm="MobileServerName" po="80" pt="MicroStrategyMobile" ty="1" rt="0" udc="true">

 To: 

<ws nm="LoadBalancerName" po="80" pt="MicroStrategyMobile" ty="1" rt="0" udc="true">

Note: If port changes have to be made to reach the load balancer, also include those changes here. 

11. In the 'MobileConfigurationIndex.xml', the new configuration is also listed. 

<cnfndx v="0" bld="9.0.628.176J"><cnfs/></cnfndx>
<cnf n="New Configuration" cid="ceb44e2d-fc85-4b73-b06b-e91e3cdb8ada" dt="1"><lnk am="1" rt="0"/></cnf>

12. Take the new generated 'mobileConfig-xxx-xxx-xxx-xxx.xml' file and the 'MobileConfigurationIndex.xml' and copy+paste them on each MicroStrategy Mobile Server that will be part of the cluster.

If configuring the MicroStrategy Mobile setup directly on the iPad/iPhone device, the load balancer's IP address or name has to be provided as the Mobile Server name.

Its always recommended to please take a backup of the configuration files before making any changes to avoid other issues. .