Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

HPE Marvis Android Client

Complete the preinstallation tasks, and then choose the method that you want to use to install the HPE Marvis Client on your device.

The HPE Marvis client for Android provides detailed visibility into how your Android device interacts with the wireless network. It helps optimize network performance, streamline troubleshooting, and enhance overall user experience by providing insights into device connectivity and performance.

The HPE Marvis Android client is supported on the following devices:

  • Android handheld devices and smartphones that run Android 11.0 and later versions

  • Zebra devices that run Android 11.0 and later versions

HPE Marvis Android Client Installation Overview

You can use any one of the following methods to install the app:

  • Manual—Download and install the HPE Marvis client app directly from the Google Play Store or the HPE Mist portal.

    To download the client from the HPE Mist portal:

    1. Select Organization > Admin > Mobile SDK from the left menu.

    2. Click HPE Marvis Client at the top of the Mobile SDK page.

    3. Select the app version under Android, and then click Download Installer.

      User interface for downloading HPE Marvis Client software from Mobile SDK with options for Windows, MacOS, and Android. Includes dropdowns for app versions, direct download links, and Play Store access for Android. Navigation menu on the left lists platform features like Monitor, HPE Marvis, Clients, Access Points, Switches, WAN Edges, Mist Edges, Location, Analytics, Site, A-B Testing, and Organization.

  • Android Debug Bridge (ADB)—Install the app using ADB, a command-line tool that developers can use to communicate with Android devices to debug issues and install/uninstall apps.

  • Mobile device management (MDM)—Use any of the following MDM solutions to install the app:

    • AirWatch or VMware Workspace ONE

    • SOTI

    Note:

    We've tested interoperability only with the MDMs listed above.

Requirements

Before you start the installation:

  • Enable the mandatory permissions listed in Table 1 for the app.

    Table 1: Permissions Required for the HPE Marvis Client App for Android

    Permission

    Description

    Mandatory or Optional

    Location—Set as Allow all the time

    Enables the HPE Marvis client app to obtain the Wi-Fi roam data and function as expected.

    Mandatory

    Bluetooth

    Allows the app to obtain the x and y coordinates of the location.

    Mandatory

    Nearby devices

    Enables the app to determine the relative location of nearby devices. Android 12 needs this permission enabled to run the location service on mobile devices.

    Mandatory

    Notifications

    Enables notifications if you want to be notified when the HPE Marvis client is running actively in the background.

    Optional

    Camera—Set as Allow Once

    Enables you to scan the QR code during enrollment. You need not enable this permission if you are installing the app through ADB or MDM.

    Optional

  • Configure your network firewall settings to allow the HPE Marvis client to connect to your organization.

    If your organization resides in the Amazon Web Services (AWS) cloud (default), use the following settings:

    • wss://client-terminator.mistsys.net:443/ws or protocol WSS (websocket) port 443 for domain/path

    • https://api.mist.com or the HTTPS protocol port 443 for domain

    If your organization resides in the Google Cloud Platform (GCP) cloud, use the following settings:

    • wss://client-terminator.gc1.mist.com/ws or protocol WSS (websocket) port 443 for domain/path

    • https://api.gc1.mist.com/ or the HTTPS protocol port 443 for domain

    Note:

    If your organization resides in a cloud other than AWS or GCP, contact the support team for the appropriate URLs to configure the firewall settings.

  • Obtain your secret token or QR code to onboard the HPE Marvis client.

    1. Select Organization > Admin > Mobile SDK from the left menu.

    2. Click Token at the top of the Mobile SDK page.

      HPE Mist Documentation interface for Mobile SDK with a sidebar menu, Token tab, and options to manage tokens.

    3. Create a new token, or use an existing token:

      • For a new token—Click Create Invitation. Enter a name for this invitation, and then click Create. When the token appears on the page, click View to see the QR code.

      • For an existing token—Refer to the token names to find the one that you want to use. Click the View link on the right side of the page to see the QR code.

    Note: To obtain the secret token using API, see Create SDK Invite.

As a best practice, we recommend that you disable the random MAC address. This avoids the need to re-register your device every time it connects to the network. To disable the random MAC address:

  1. Navigate to the Settings page on your device.

  2. Tap Network & Internet or Connections and then tap Wi-Fi.

  3. Tap the gear (settings) icon next to the wireless connection.

  4. Tap MAC Address Type and then tap Phone MAC.

Operational Modes

The HPE Marvis client operates in the following modes:

  • Onboarding mode—Default mode when you install the HPE Marvis client app using the GUI method. In this mode, you can onboard devices through a NAC portal.

  • Telemetry mode—Mode when you install the HPE Marvis client app using the CLI method. This mode is the standard operational mode for live environments.

Configure HPE Marvis Android Client for Onboarding

You can use the HPE Marvis Client app to onboard devices to the HPE Mist Networking Access Assurance network through a custom Network Access Control (NAC) portal. For more information, see Client Onboarding Through a NAC Portal Using the HPE Marvis Client App.

Configure HPE Marvis Android Client to Operate in Telemetry Mode

To enable the HPE Marvis client to operate in Telemetry mode, install the HPE Marvis client using an MDM (Deploy the HPE Marvis Client Using the SOTI MDM) or adb command (Deploy HPE Marvis Android Client Using Other MDMs).

Admin Mode on the HPE Marvis Android Client

When you open the HPE Marvis client in onboarding or Telemetry mode, you'll see only the Network Onboarding and About options. To view other menu options, you'll need to switch to the Admin mode:

  1. Tap the hamburger icon, and then tap the HPE Marvis client icon 7 times.

  2. Enter the password as AIDriven. Now you can see that you are in the Admin mode and can view additional menu options.

    HPE Marvis Client interface with options: Connection Status, Network Onboarding, Configuration, Logs, About, and an ADMIN toggle switched on in green with a dark theme.

    In Admin mode, the About page displays the UUID, Device Name, Org ID and Org Name.

    About page showing software version 1.3.0, organization name MobileQATestbed, and redacted UUID, device name, secret key, and org ID with options to copy UUID, secret, and org ID.

    You can use the Configuration option to update or verify the client name, location access, and mobile SDK token.

    Configuration screen with fields for Mobile SDK Secret with QR code scan option, Location Visibility set to Standard, Mobile Client Name set to Samsung_galaxy_s10, and Apply and Cancel buttons.

Connection States

The HPE Marvis client status is indicated by the following visual indicators and connection states. Note that you can view these states only if the HPE Marvis client is in Telemetry mode.

Connected status with green dot and open eyes; Disconnected status with red dot and downward-facing eyes; Sleep status with blue dot and closed eyes.

  • Disconnected—Client is not connected to the HPE Mist cloud.

  • Connected—Client is connected to the HPE Mist cloud.

  • Sleep —Client is connected to the HPE Mist cloud through an AP that is not an HPE Mist Networking AP.

Deploy the HPE Marvis Client Using the SOTI MDM

To deploy the HPE Marvis client using a mobile device management (MDM) solution, you must customize the Android package kit (APK) package deployment. You customize the APK deployment with the intent action to set the secret software development kit (SDK) token upon installation. When you launch the customized application package, the client is fully preconfigured and onboarded for operation.

You can onboard the HPE Marvis client using the SOTI MDM.

Note:

We do not present the overall generic Android application deployment process with SOTI. We present only the information necessary to customize the Android application to complete the HPE Marvis client deployment.

Before you begin:

  1. Ensure that you have a Windows device or a virtual machine (VM). You will run Package Studio, which runs only on Windows devices.

  2. Download SOTI’s MobiControl Package Studio (McStudio.exe).

To deploy the HPE Marvis client using the SOTI MDM:

  1. On your Windows device or VM, launch Package Studio and create a package project with the following settings:

    • Processor—All (unless you're targeting specific CPU or device types)

    • Platform—Android

    • OS Version—11 or later

    • Version String—Same as the APK version

    • Vendor—HPE

    • Optional space requirement specifications

  2. Add the HPE Marvis client APK.
  3. Add the following script file:

    • Script Engine—Legacy

    • Script Type—Post-Install

  4. Import the script file. The script file must have the following content:

    If you have configured a specific port on a Zebra device for voice calls, then the script file must have the following content:

  5. Build the package.

When you deploy the customized package with SOTI, the HPE Marvis client is preconfigured and onboarded.

Deploy the HPE Marvis Client Using AirWatch or VMware Workspace ONE

We do not cover the overall generic Android app deployment process with AirWatch. We cover only the specific steps needed to complete the HPE Marvis client deployment.

Use the following intent command to deploy the client:

If you have configured a specific port on a Zebra device for voice calls, then use the following intent command:

You can use the following references to deploy the intent command:

Deploy HPE Marvis Android Client Using Intune

Follow the procedure in Add Managed Google Play Apps to Android Enterprise Devices With Intune to deploy the HPE Marvis Android client using Intune.

Once the HPE Marvis client is installed successfully, add the configuration details such as secret token, location mode, device name:

  1. On the Intune portal, navigate to Apps>Manage Apps.

  2. Select Configuration>Create>Managed devices.

  3. Add Basic details such as the name, platform, and profile type. Select HPE Marvis Client as the Targeted app.

  4. Add the location access permissions and configuration settings such as MOBILE_LOCATION_DURATION, MOBILE_LOCATION_MODE, MOBILE_CLIENT_NAME, AND MOBILE_SDK_SECRET.

    Create app configuration policy page in Microsoft Intune admin center for Android apps. Permissions set to Prompt for location access. Configuration designer format selected with keys like MOBILE_LOCATION_DURING_SETUP. Connected apps setting not configured.

  5. Add groups.

  6. Click Create.

Deploy HPE Marvis Android Client Using Other MDMs

If you're using any other MDM, verify that the MDM supports intent execution. Here is a sample for Android Debug Bridge (ADB)-based (developer/debug) deployment that you can use to adapt to an MDM of your choice:

Enable the location mode and update the client name:

If the MDM solution does not support execution of Android intents, you might need to onboard each deployed client device manually.

Verify the Installation

After you install and onboard the HPE Marvis client, verify that those processes have run correctly. Ensure that your device is connected to the Mist Wi-Fi network.

To verify the installation:

  • Confirm that the secret token value is applied correctly. Navigate to the About or Configuration (if you're in the non-production mode) page on the HPE Marvis client app and verify that the secret token value is still stored in the field.

    If the data does not persist and the secret token field is empty, enter the secret token value manually. You might need to also configure the application deployment to retain the application data.

  • About 15 minutes after you onboard the HPE Marvis client, confirm that the HPE Marvis client data is available on the HPE Mist portal. You need to wait for a minimum of 10 to 15 minutes after onboarding the HPE Marvis client for the data to propagate to the HPE Mist cloud.

    The client data is not available on the HPE Mist portal when a problem occurs in the client workflow of collecting and sending data to the HPE Mist cloud. Contact the support team. You can access the logs in the HPE Marvis client app. See View Logs in the HPE Marvis Android Client. Alternatively, you can also use tools such as Logcat or Android Debug Bridge (ADB) to collect the HPE Marvis client logs and share the logs with the support team.

    For Zebra devices, you can use the RxLogger tool as an alternative method to collect logs.

    When you contact the support team, you must share the HPE Marvis client UUID. You can find the UUID on the About page of the HPE Marvis client app. The UUID is used to track the data flow from the HPE Marvis client to the HPE Mist cloud.

    About section of app showing version 1.3.0, UUID, device name, org name BLR-Lab, secret key, org ID, and privacy policy link. Top bar displays time, battery, and status icons.

View Logs in the HPE Marvis Android Client

The HPE Marvis client classifies the logs as:

  • Info—General information

  • Error—Critical issues

  • Debug—Detailed data that you can use to debug issues

To view the logs in the app, you'll need to enable debug mode on the app:
  1. Tap the hamburger icon and then tap the HPE Marvis Client icon 7 times.
    You'll be prompted for a password.
  2. Enter the password as AIDriven.

    You'll see the Logs option listed in the menu.

    HPE Marvis Client interface with options: Connection Status, Network Onboarding, Configuration, Logs, About, and an ADMIN toggle switched on in green with a dark theme.
  3. Tap Logs.
  4. Enable View Logs to view the logs captured by the HPE Marvis client. You can select the type of information you want to view from the Log Level drop-down list.
    You can click the Copy button to copy and send the log details to the support team for troubleshooting.
    Log viewer interface with a dropdown for log level set to Info, a toggle to view logs turned on, scrolling log entries with timestamps and system messages, and a red clipboard icon to copy logs.
    Note:

    If you contact the HPE support team to resolve any issue, you might be asked to provide details such as the organization ID, UUID, and organization name. You can find these details listed in the About page. Note that you'll need to access this page in Admin mode to view the information. See Admin Mode on the HPE Marvis Android Client.