Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

Marvis macOS Client

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

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

Marvis macOS Client Installation Overview

You can download the installer file from the Juniper Mist portal. To download the installer file from the Juniper Mist portal:

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

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

  3. Under MacOS, select the app version, and then click Download Installer.

    You'll need to save the *.dmg installer file in a folder on your device.

Prerequisites

Before you begin, you'll need:

  • The secret token to onboard your Marvis client

    To obtain the secret code:

    1. Select Organization > Admin > Mobile SDK from the left menu on the Juniper Mist portal.

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

    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 https://api.mist.com/api/v1/docs/Org#sdk-invite.

  • macOS 14.6 or a later release running on your device

  • Administrator rights required for installation

Installation Options for the Marvis Client (macOS)

You can install the Marvis client for macOS by using any of the following methods:

Operational Modes

The Marvis client operates in the following modes:

Install the Marvis Client for macOS (CLI Method)

When you install the Marvis macOS client using the CLI method, the Marvis client is installed in Telemetry mode. To install the Marvis client for macOS using the CLI:

  1. Extract the .pkg file from the .dmg file.
  2. Press the Command + Space keys to open the Spotlight search window.
  3. Type Terminal. The Terminal app is displayed in the search results.
  4. Double-click the Terminal app.
  5. Execute the following command:

    Set the values for the following parameters:

    Mandatory parameter:

    • token-value—Provide the secret token.

    Optional parameters:

    • --ui-mode-enabled <true|false> or -ui <true|false>—Enable or disable UI mode. By default, the UI mode is enabled.

    • --auto-upgrade-allowed <true|false—Enable or disable automatic upgrades. By default, this option is disabled.

    • --force or -f—Force restart irrespective of the current configuration

  6. Enter the administrator password when prompted.
  7. Verify that the installation is successful. See Verify the Installation.
    After the installation is completed successfully, the Marvis client app opens. You can also see the Marvis client icon listed in the status bar. You will be prompted to enable Location Services for the Marvis client. Note that Location Services in this context refer to the device-level location settings available on macOS. Client real-time location services are not supported on macOS devices.
  8. Select Allow. Location permission is needed for the Marvis client to collect Wi-Fi telemetry from the client device.

    If Location Services is not enabled automatically after you install the Marvis Client, follow these steps:

    1. Navigate to System Settings > Privacy > Location Services.

    2. Enable location services for the Marvis Client.

Install the Marvis Client for macOS (GUI Method)

When you install the Marvis macOS client using the GUI method, the Marvis client is installed in the Onboarding mode. To install the Marvis client for macOS:

  1. Double-click the .dmg file and then double-click the .pkg file to start the installation process.
  2. Click Continue.
  3. Click Agree to accept the license agreement.
  4. Click Install.

    The Marvis client is installed in the Onboarding mode. If you want to switch to Telemetry mode, proceed with the following steps.

  5. Press the Command + Space keys to open the Spotlight search window.
  6. Type Terminal.
    The Terminal app is displayed in the search results.
  7. Double-click the Terminal app.
  8. Execute the following command:

    Set the values for the following parameters:

    Mandatory parameter:

    • token-value—Provide the secret token.

    Optional parameters:

    • --ui-mode-enabled <true|false> or -ui <true|false>—Enable or disable UI mode. By default, the UI mode is enabled.

    • --auto-upgrade-allowed <true|false—Enable or disable automatic upgrades. By default, this option is disabled.

    • --force or -f—Force restart irrespective of the current configuration

    • --yes or -y—Skip the confirmation prompt for a forced restart. This is useful during silent or MDM installation.

  9. Verify that the installation is successful. See Verify the Installation.
    After the installation is completed successfully, the Marvis client app opens. You can also see the Marvis client icon listed in the status bar. You will be prompted to enable Location Services for the Marvis client.
  10. Select Allow. Location services must be enabled for the Marvis client to function correctly.

    If Location Services is not enabled automatically after you install the Marvis Client, follow these steps:

    1. Navigate to System Settings > Privacy > Location Services.

    2. Enable location services for the Marvis Client.

Configure Marvis Client for Onboarding

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

Configure Marvis Client to Operate in Telemetry Mode

The Marvis client is configured to operate in Onboarding mode by default. To enable the Marvis client to operate in Telemetry mode, use the following command:

marvis-cli --token-value <token>

Deploy the Marvis Client on macOS Devices Using an MDM

You can deploy the Marvis client on macOS devices by using the SOTI, Intune, or Jamf mobile device management (MDM) solution. You can refer to the following topics for information about enrolling and managing devices using MDMs:

To deploy the Marvis client:

  1. Enroll the target devices or device groups with the appropriate MDM profile.

  2. Configure the necessary profiles or application policies within your MDM portal.

  3. Upload the Marvis client .pkg installer file to your MDM portal and assign the file to the target devices or device groups.

  4. After the installation is complete, send a configuration script to the devices through the MDM portal:

Upgrade the Marvis Client for macOS Using MDM

To upgrade to a newer version of the Marvis client, upload the updated .pkg file to the MDM portal and reassign the application policies to the target devices or device groups. You need not resend the configuration script.

Update the Marvis Client Configuration for macOS Using MDM

To update the Marvis client configuration parameters, resend the configuration script with the updated parameters:

Uninstall Marvis Client for macOS Using an MDM

To uninstall the Marvis using an MDM:

  1. Remove the application policy assignment if it enforces mandatory app installation.

  2. Send the uninstallation script to the devices:

    You might still see the app as Installed on some MDM portals. After you remove the policy, wait for a while, and then check the app status.

    Note:

    The uninstall process might not remove all log files and folders. You can choose to delete the files manually if required. To completely remove Marvis client along with all the logs and configuration files, use the following command:

Connection States

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

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

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

  • Sleep —Client is connected to the Juniper Mist cloud through a non-Juniper AP.

Verify the Installation

Use any of the following options to verify that the Marvis client was installed successfully:

  • Verify that the Marvis client is present in your Applications directory.

  • Verify the background services:

    1. Open the Terminal app and execute the following command:

    2. Provide your administrator password when prompted.

    3. Verify that a service entry is present.

  • Verify that Marvis Client is listed in the Services tab in Activity Monitor.

    If you do not see Marvis Client listed, reinstall the Marvis client. If that does not resolve the issue, contact the support team.

After the installation, you’ll see the Marvis icon in your system tray or menu bar. You can click the icon to open the Marvis client and view the connection status.

Manage Services

Here are the commands that you can use to manage the following main Marvis client system services:

  • Main Service: com.mist.MarvisClient

  • Privileged Helper: com.mist.MarvisClient.MarvisPrivilegedHelper

  • Start services:

  • Restart services:

  • Logs services:

  • Version services:

View Logs in the Marvis macOS Client

The Marvis macOS 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 Marvis macOS client, you'll need to enable debug mode:
  1. Click the hamburger icon, select About, and then tap the version number 7 times.

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

  2. Select Logs. Select the log category from the Log Level drop-down list.
    You'll see recent logs based on the selected log level. You can click the Copy button to copy the log details and send the information to the support team for troubleshooting.

  3. Click View to see the logs captured by the Marvis client in your OS native window.
    Note:

    If you contact the Juniper Mist 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, which you can access from the hamburger menu.

    The information in the About page varies based on the operational mode:

    • Onboarding mode—Application version and UUID, user information, organization name
    • Telemetry mode—Application version and UUID, user information, organization name
    • Debug mode- Application version and UUID, user information, organization name, organization ID

Uninstall the Marvis macOS Client

You can uninstall the Marvis macOS client by using the Finder (GUI) or the CLI. The CLI method offers a clean uninstall option to remove residual files and configurations.

Uninstall the Marvis macOS Client (GUI)

The GUI method provides a user-friendly way to uninstall the Marvis client.

  1. Open the Marvis Client application.

  2. Navigate to the About page.

  3. Tap Uninstall to uninstall the Marvis client.

    Note: The Uninstall option is available in Marvis macOS client version 1.1.0 and later.

Uninstall the Marvis macOS Client Using the CLI

The CLI method provides flexibility for advanced users with the provision of both standard and clean uninstallation of the Marvis client. You'll need administrative privileges for this procedure. Enter your admin password when prompted.

Standard Uninstall

To remove the application only (without configuration files):

  1. Open Terminal.

  2. Run the following command:

    • For standard uninstall:

    • For clean uninstall:

Clean Uninstall

To completely remove the Marvis client, including all residual files and configurations:

  1. Enable Debug mode by tapping the version number 7 times on the About page.

  2. Tap Uninstall.

    Note: The Uninstall option is available in Marvis macOS client version 1.1.0 and later.

  3. Enable both these options and tap Uninstall to proceed.

    • Remove Configuration Profile

    • Clean Uninstall