BMC Mobility Administration console

This topic provides information about using the BMC Mobility Administration console to configure and administer BMC Remedy ITSM - Mobility: Service Desk applications and server clusters.

Configuration information for the BMC Mobility server cluster is stored in a centralized repository called the BMC Mobility admin server. The BMC Mobility admin server hosts the BMC Mobility Administration console, which provides an interface for BMC Mobility administrators and tenants to apply Mobility configurations. The console application is implemented as a BMC Remedy Action Request System deployable application.

A centralized configuration repository simplifies cluster management. All configuration changes are implemented in one place, and are distributed to all servers in the cluster automatically.

All tenants configurations are identified by tenant IDs and have row-level security enforced on shared forms. This ensures that each tenant can see only their own configurations. The console forms can be accessed by the Mobility Administrator and Mobility roles. The Mobility role has read and write access to mobility configuration forms. The Mobility Administrator role has read and write access to cluster configuration forms and can set Mobility privileges.

In a production or testing environment, the Mobility role can be mapped to Mobility Group, and the Mobility Administrator role can be mapped to the Mobility Administrator Group. Each tenant user belongs to both their Tenant Group and to the Mobility Group. The Mobility Administrator belongs to the Mobility Administrator Group. The Mobility Server installer creates the Mobility Administrator Group and the Mobility Group.

The following sections describe how to use the Administration console to perform various tasks.

Using the Administration Console to configure applications
Using the Administration Console to configure a cluster

Using the Administration Console to configure applications

The installer for the BMC Remedy ITSM - Mobility server adds default configurations to the Mobility Administration application. Therefore, the Mobility server functions as soon as the installation completes. Then you can use the Administration console to modify the default configurations.

BMC Mobility Console - Applications

You can use the Administration Console to configure applications.

To manage Applications

Select the Applications tab.
Select the Tenant.
Select Applications.
Select the application that you want to manage.
Enable or disable the application. Only the Mobility and Mobility Admin roles can enable and disable the application. If Enable is selected, then the Filter API plug-in validates the application version with the compatibility string that is displayed in the Applications panel.
Select a Data Store for the application. Only the Mobility Admin role can select a Data Store.
Click Save.
Select the Data Source, select the Data Source Query, set the query size, and modify the Qualification value. Only the Mobility and Mobility Admin roles can do this.
Click Save.

To create, modify, and delete persistent Data Stores

Select the Applications tab.
Select the Tenant.
Select the Persistent Data Stores.
Select a Data Store. Only the Mobility Admin role can create, delete and modify Data Stores. However, both the Mobility and Mobility Admin roles can view the data store information.
Create a new persistent Data Store clicking the green "+" icon above the list of persistent Data Stores. Then set the values for Host Name/ IP Address, Port, Admin Password, and Data Store Type on the right side of the panel, and click Save. When a new persistent Data Store is created, the Filter API plugin configures the data store by enabling Field Change on the Data Store.
Delete the selected persistent Data Store by clicking the red "-" icon above the list of persistent Data Stores.
Modify the selected persistent Data Store by setting the values for Host Name/ IP Address, Port, Admin Password, and Data Store Type on the right side of the panel and clicking Save.

To create, modify and delete Profiles and applications or devices associated with them

Select the Applications tab.
Select the Tenant.
Select Profiles. A list of existing profiles appears in the left pane.
To delete a profile, select the profile that you want to delete and click the red "-" icon.
To add a profile, click the green "+" icon.
1. In the right panel, type the Profile Name and Description.
2. If you want the profile to be the Default Profile, then check the check box.
3. Click Save.
To change the name of a profile, select the profile in the left pane.
1. Click Change.
2. Change the name of the profile.
3. Click Save.
To change the description of a profile, select the profile in the left pane.
1. Change the description of the profile.
2. Click Save.
To make a profile the Default profile, select the current Default profile.
1. Uncheck the *Default Profile check box.
2. Click Save.
3. Select the profile that you want to be the Default profile.
4. Check the *Default Profile check box.
5. Click Save.
To add an application to a profile, select the profile in the left pane.
1. Go to the applications section.
2. Select an application from the menu.
3. Click the green "+" button.
To remove an application from a profile, select the profile in the left pane.
1. Go to the applications section.
2. Select an application from the list.
3. Click the red "-" button.
To add an device to a profile, select the profile in the left pane.
1. Go to the applications section.
2. Select a device from the menu. (If All Devices is chosen for the profile device, then all devices are allowed to use the mobility platform.)
3. Click the green "+" button.
To remove a device from a profile, select the profile in the left pane.
1. Go to the applications section.
2. Select a device from the list.
3. Click the red "-" button.

To set or modify the mapping order for Group to Profile Mapping for Data Stores

Select the Applications tab.
Select the Tenant.
Select Profiles.
Click Profile to Group Mapping.
Select a Data Store from the menu.
Select a profile from the menu.Select a group from the menu.
Click the green "+" icon to add the profile and group to the Profile to Group Mapping table.
Select a group and profile from the Profile to Group Mapping table, and click the red "-" icon to remove it.
Select a group and profile from the Profile to Group Mapping table, and click the “up arrow” or “down arrow” icon to toggle rows in the Profile to Group Mapping table. The profile order is saved based on the order it appears in the Profile to Group Mapping table.

After you set or modify the mapping order for Group to Profile Mapping for Data Stores, the Filter API plug-in updates that mapping information in the back-end Data Store form with the name: Mobility Administration: Items Access.

When the mobile client logs in, the Mobility server queries the Mobility Administration: Items Access form in the Data Store for profiles that the user can access. The profile determines which mobile applications the user can use and on which devices. If the user has access to more than one profile, then the mapping order determines which profile is used.

To enable or disable Audit user activities and settings

Select the Applications tab.
Select the Tenant.
Select Audit Settings.
The Mobility or Mobility Admin roles can view the audit settings.
The Mobility or Mobility Admin roles can enable, disable, and change the audit settings.
1. Enable or disable auditing of user activities by checking or unchecking the Audit User Activities check box.
2. Enable or disable the types of data that you want to capture by checking or unchecking the appropriate check box.
Click Save.

For more information of monitoring activities about the mobility platform, see Mobility-platform-activity-monitoring.

Using the Administration Console to configure a cluster

Only a Mobility Admin can use the Administration Console to view, add and remove mobility servers from the cluster.

Caution

Be very careful when modifying the cluster or cluster information. Any mistakes may produce unintended and unwanted results.

To view cluster settings

Select the Cluster tab. A list of Mobility servers appears in the left panel.
Select a server. Information about that server appears in the right panel.
Click Edit Settings. Additional information about that server appears in the right panel.

To add a Mobility server to the cluster

Note

BMC strongly recommends that you use the Mobility server Installer to add a Mobility server to the cluster. Otherwise, the Mobility server might not be configured properly to join the cluster. When the Mobility server is configured after it is added to the cluster, it receives notifications if the configuration changes.

Select the Cluster tab.
Select a server from the list of Mobility servers in the left panel.
Click the green "+" icon.
Add the required information about the server.
Click Save.

To remove a Mobility servers from the cluster

Select the Cluster tab.
Select a server from the list of Mobility servers in the left panel.
Click the red "-" icon. The server is removed from the cluster.

To modify the connection information for any existing mobility server

Select the Cluster tab.
Select a server from the list of Mobility servers in the left panel. The information about that server is displayed in the right panel.
- The Server Host Name and Web Server Port of the Mobility server are used by the Admin server when it sends change notifications to the Mobility server.
- The Log Directory only provides information. Changing it does not affect the log directory on the Mobility server.
Make any required changes in the appropriate fields.
Click Save.

To modify the log level for the Mobility Cluster

The Log Level determines the how much information is logged by the Mobility servers in the cluster.

Select the Cluster tab.
Click Edit Settings.
Choose one of the four settings (Error, Warn, Info, Debug) from the list in the Log Level field.
Click Save.