Help & DocumentationSystem AdministrationDeployment & Configuration Deploying Metric InsightsDeploying Metric Insights' Custom Mobile Apps at your organization

Deploying Metric Insights' Custom Mobile Apps at your organization

This document will describe the steps needed to deploy the Metric Insights mobile app on iOS; Android is much more simple—a small section at the bottom is dedicated to it.

PREREQUISITES

  • Submit your information via the Custom Mobile Build form (please request it from support@metricinsights.com)
  • Receive the Xcode project and APK for your custom mobile build from Metric Insights team
  • Acquire an Apple Developer Enterprise account

Mobile App Deployment Architecture

MI-MobileAppArchitecture.pdf

Create a new 'Metric Insights' App ID

Create a new 'Metric Insights' App ID

Log into the iOS Dev Center and open your Account page:

  1. From the Program Resources Navigation menu to the left of the screen select Certificates, IDs & Profiles
  2. In the opened page select App IDs from the Identifiers section to the left of the screen
  3. At the iOS App IDs screen click Add (a plus button)

Register an App ID

Register an App ID
  1. Define the Name of a new App ID
  2. Select Explicit App ID option and define Bundle ID
  3. In the App Services section make sure to select Push Notifications to enable them for your application

You should now see the info about App ID that you have created. Click Submit to continue.

Create  a "Metric Insights" Certificate for Push Notifications

Create  a 'Metric Insights' Certificate for Push Notifications

Generate a certificate for the and upload it the 'certificates' directory on your Metric Insights instance at:

/opt/mi/iv/data/certificates

Certificate has 2 variants: [app_id].pem (prooduction) and [app_id].dev.pem (development).

For example, 'com.metricinsights.viewer.pem' or 'com.metricinsights.viewer.dev.pem'.

For this reason, we have a Config Variable in Metric Insights that determines which certificate should be used (see next step).

Define the type of certificate to be used in Metric Insights

  1. Go to Admin > Utilities > Config Variables
  2. Search for a MOBILE_PUSH_ENVIRONMENT variable and define which certificate should be used and click Save in the pop-up
  3. Do not forget to click Save changes at the bottom of  the Config Variables page to apply the changes

Once the certificates have been created and are in the appropriate locations, Push Notifications should begin to work.

NOTE: The certificates should be added to all supported instances (dev, prod, etc.).

If you have created a passphrase while building the Certificate, copy it into Metric Insights

  1. Go to Admin > Utilities > Config Variables
  2. Find MOBILE_PUSH_PRIVATE_KEY_PASSPHRASE variable and click a Gear button to edit it
  3. Define a passphrase for this variable and click Save in the pop-up
  4. Do not forget to click Save changes at the bottom of  the Config Variables page to apply the changes
  5. Log out of Flex Alerts on the mobile device, and log back in
  6. Now go back to My Settings page in Metric Insights and try resending the test alert (described in the step below)

NOTE: You'll need to go through these steps for every server that needs to function with the Dashmonitor app.

Testing Alerts for an individual user

  1. In the drop-down menu below your name select My Settings
  2. In the opened screen click Send a test Alert. Assuming the device is logged in to the instance from which you are sending the test, you should receive it on your phone

Resending an existing aler

To test Alerts more thoroughly, you can create an Alert and then re-trigger it:

To get the Alert ID:

  1. Find the required Alert
  2. Go the Metric Editor of the Metric where this Alert has fired
  3. Open the Alerting tab; find and copy Alert ID in the Alert History grid
  4. Go to [INSTANCE_URL]/service/ns/alert
  5. Enter Alert ID in the corresponding field and click Send at the bottom of the screen
  6. System informs you whether the alert has been successfully resent

Android Requirements

On Android, there is no additional setup required for receiving Push Notifications. There is a key pair that comes with the MI instance and the Android app, and as there is no third party gatekeeper that manages notifications (e.g. Apple Push Notification Service), it should work as-is.