本页内容
 

Marvis macOS 客户端

完成预安装任务，然后选择要用于在 macOS 设备上安装 Marvis 客户端的方法。

macOS 版 Marvis 客户端可详细了解 macOS 设备如何与无线网络交互。通过洞察设备连接和性能，Marvis 客户端有助于优化网络性能、简化故障排除并提升整体用户体验。

Marvis macOS 客户端安装概述

您可以从瞻博网络 Mist 门户下载安装程序文件。要从瞻博网络 Mist 门户下载安装程序文件，请执行以下操作：

  1. 从左侧菜单中选择 组织 > 管理员 > 移动SDK 。

  2. 点击移动 SDK 页面顶部的 Marvis 客户端 。

  3. 在 MacOS 下，选择应用版本，然后单击 “下载安装程序”。

    您需要将 *.dmg 安装程序文件保存在设备上的文件夹中。

    Download interface for Marvis Client software with links for Windows, MacOS, and Android. Navigation menu on the left highlights Marvis Client tab.

先决条件

开始之前，你需要：

  • 用于载入 Marvis 客户端的秘密令牌

    要获取密码，请执行以下操作：

    1. 从瞻博网络Mist门户的左侧菜单 中选择组织 > 管理员 > 移动SDK 。

    2. 点击移动 SDK 页面顶部的 令牌 。

    3. 创建新令牌，或使用现有令牌：

      • 对于新令牌 - 点击 创建邀请。输入此邀请的名称，然后单击 “创建”。当令牌出现在页面上时，单击 查看 以查看二维码。

      • 对于现有令牌 - 请参阅令牌名称以查找您要使用的令牌。点击页面右侧的“ 查看” 链接即可查看二维码。

        Juniper Mist dashboard showing the Mobile SDK section with navigation menu and a token table listing name, secret, creation date, and options to view, send, or delete.

      注意：要使用 API 获取密钥令牌，请参阅 https://api.mist.com/api/v1/docs/Org#sdk-invite。

  • 设备上运行的 macOS 14.6 或更高版本

  • 安装所需的管理员权限

Marvis 客户端 （macOS） 的安装选项

您可以使用以下任一方法安装适用于 macOS 的 Marvis 客户端：

操作模式

Marvis 客户端在以下模式下运行：

安装适用于 macOS 的 Marvis 客户端（CLI 方法）

使用 CLI 方法安装 Marvis macOS 客户端时，Marvis 客户端将以遥测模式安装。要使用 CLI 安装适用于 macOS 的 Marvis 客户端：

  1. 从.dmg文件中提取.pkg文件。
  2. 按 Command + 空格键 打开 Spotlight 搜索窗口。
  3. 键入 Terminal。终端应用程序将显示在搜索结果中。
  4. 连按“终端” App。
  5. 执行以下命令：

    设置以下参数的值：

    必填参数：

    • token-value- 提供机密令牌。

    可选参数：

    • --ui-mode-enabled <true|false> or -ui <true|false>- 启用或禁用 UI 模式。默认情况下，UI 模式处于启用状态。

    • --auto-upgrade-allowed <true|false- 启用或禁用自动升级。默认情况下，此选项处于禁用状态。

    • --force or -f— 无论当前配置如何，都强制重启

  6. 出现提示时输入管理员密码。
  7. 验证安装是否成功。请参阅 验证安装。
    安装成功完成后，Marvis 客户端应用将打开。您还可以在状态栏中看到 Marvis 客户端图标。系统将提示您为 Marvis 客户端启用定位服务。请注意，此上下文中的定位服务是指 macOS 上可用的设备级位置设置。macOS 设备不支持客户端实时定位服务。
  8. 选择 “允许”。Marvis 客户端需要位置权限才能从客户端设备收集 Wi-Fi 遥测数据。

    如果安装 Marvis 客户端后未自动启用定位服务，请按照以下步骤操作：

    1. 导航到 系统设置 > 隐私 > 定位服务。

    2. 为 Marvis 客户端启用定位服务。

    Privacy and Security settings in macOS showing Location Services section with applications listed, MarvisClient highlighted in red and actively using location services.

安装适用于 macOS 的 Marvis 客户端（GUI 方法）

使用 GUI 方法安装 Marvis macOS 客户端时，Marvis 客户端将以入网模式安装。要安装适用于 macOS 的 Marvis 客户端：

  1. 双击.dmg文件，然后双击.pkg文件以开始安装过程。
  2. 单击继续。
  3. 单击 “同意” 以接受许可协议。
  4. 单击 安装。

    Marvis 客户端以入网模式安装。如果要切换到遥测模式，请继续执行以下步骤。

  5. 按 Command + 空格键 打开 Spotlight 搜索窗口。
  6. 键入 Terminal。
    终端应用程序将显示在搜索结果中。
  7. 连按“终端” App。
  8. 执行以下命令：

    设置以下参数的值：

    必填参数：

    • token-value- 提供机密令牌。

    可选参数：

    • --ui-mode-enabled <true|false> or -ui <true|false>- 启用或禁用 UI 模式。默认情况下，UI 模式处于启用状态。

    • --auto-upgrade-allowed <true|false- 启用或禁用自动升级。默认情况下，此选项处于禁用状态。

    • --force or -f— 无论当前配置如何，都强制重启

    • --yes 或 -y—跳过强制重启的确认提示。这在静默或 MDM 安装期间很有用。

  9. 验证安装是否成功。请参阅 验证安装。
    安装成功完成后，Marvis 客户端应用将打开。您还可以在状态栏中看到 Marvis 客户端图标。系统将提示您为 Marvis 客户端启用定位服务。
  10. 选择 “允许”。必须启用定位服务才能使 Marvis 客户端正常运行。

    如果安装 Marvis 客户端后未自动启用定位服务，请按照以下步骤操作：

    1. 导航到 系统设置 > 隐私 > 定位服务。

    2. 为 Marvis 客户端启用定位服务。

    Privacy and Security settings in macOS showing Location Services section with applications listed, MarvisClient highlighted in red and actively using location services.

配置 Marvis 客户端以进行上线运作

您可以通过自定义网络访问控制 （NAC） 门户，使用 Marvis 客户端应用将设备载入瞻博网络 Mist Access Assurance 网络。有关更多信息，请参阅 使用 Marvis 客户端应用通过 NAC 门户接入客户端。

将 Marvis 客户端配置为在遥测模式下运行

默认情况下，Marvis 客户端配置为在入网模式下运行。要使 Marvis 客户端在遥测模式下运行，请使用以下命令：

marvis-cli --token-value <token>

使用 MDM 在 macOS 设备上部署 Marvis 客户端

可以使用 SOTI、Intune 或 Jamf 移动设备管理 （MDM） 解决方案在 macOS 设备上部署 Marvis 客户端。有关使用 MDM 注册和管理设备的信息，您可以参考以下主题：

要部署 Marvis 客户端，请执行以下操作：

  1. 使用相应的 MDM 配置文件注册目标设备或设备组。

  2. 在 MDM 门户中配置必要的配置文件或应用程序策略。

  3. 将 Marvis 客户端.pkg安装程序文件上传到 MDM 门户，并将该文件分配给目标设备或设备组。

  4. 安装完成后，通过 MDM 门户向设备发送配置脚本：

使用 MDM 升级适用于 macOS 的 Marvis 客户端

若要升级到较新版本的 Marvis 客户端，请将更新的 .pkg 文件上传到 MDM 门户，然后将应用程序策略重新分配给目标设备或设备组。无需重新发送配置脚本。

使用 MDM 更新适用于 macOS 的 Marvis 客户端配置

要更新 Marvis 客户端配置参数，请使用更新的参数重新发送配置脚本：

使用 MDM 卸载适用于 macOS 的 Marvis 客户端

要使用 MDM 卸载 Marvis：

  1. 如果应用程序策略分配强制实施应用安装，请删除它。

  2. 将卸载脚本发送到设备：

    您可能仍会在某些 MDM 门户上看到该 App“已 安装” 。删除策略后，请稍等片刻，然后检查应用状态。

    注意：

    卸载过程可能不会删除所有日志文件和文件夹。如果需要，可以选择手动删除文件。要完全删除 Marvis 客户端以及所有日志和配置文件，请使用以下命令：

连接状态

Marvis 客户端状态由以下可视指示器和连接状态指示。请注意，只有当 Marvis 客户端处于遥测模式时，才能查看这些状态。

Status indicators showing: Connected with green light, Disconnected with red light, Sleep with blue light.

  • 断开连接 — 客户端未连接到瞻博网络 Mist 云。

  • 已连接 — 客户端已连接到瞻博网络 Mist 云。

  • 休眠 — 客户端通过非瞻博网络 接入点连接到瞻博网络 Mist 云。

验证安装

使用以下任一选项验证 Marvis 客户端是否已安装成功：

  • 验证 Marvis 客户端是否存在于您的应用程序目录中。

    Grid of application icons on a computer screen, including Microsoft Office apps, Slack, Google Chrome, Xcode, Android Studio, Avast Security, OpenVPN Connect, and others.

  • 验证后台服务：

    1. 打开终端应用程序并执行以下命令：

    2. 出现提示时提供您的管理员密码。

    3. 验证服务条目是否存在。

      Terminal output showing Marvis Client service status: Version 1.1.0; main service running; privileged helper running; application files installed; configuration available; token and UUID partially redacted; UI mode true; started from CLI false; auto upgrade allowed true. Service operational and configured.

  • 验证 Marvis 客户端是否列在活动监视器的服务选项卡中。

    如果您未看到列出的 Marvis 客户端，请重新安装 Marvis 客户端。如果这不能解决问题，请联系支持团队。

    Activity Monitor in macOS showing CPU tab with process Marvis Cl using 2.4 percent CPU, 9 threads, 2 idle wake-ups, categorized as Apple, and PID 2125.

安装后，您将在系统托盘或菜单栏中看到 Marvis 图标。您可以单击该图标打开 Marvis 客户端并查看连接状态。

管理服务

以下是可用于管理以下主要 Marvis 客户端系统服务的命令：

  • 主服务：com.mist.MarvisClient

  • 权限助手：com.mist.MarvisClient.MarvisPrivilegedHelper

  • 启动服务：

  • 重启服务：

  • 日志服务：

  • 版本服务：

在 Marvis macOS 客户端中查看日志

Marvis macOS 客户端将日志分类为：

  • 信息 - 常规信息

  • 错误 - 关键问题

  • 调试 - 可用于调试问题的详细数据

    • 要在
Marvis macOS 客户端中查看日志，您需要启用调试模式：
  1. 单击汉堡包图标，选择“关于”，然后点击版本号 7 次。

    您将看到菜单中列出了日志选项。

    Marvis Client interface showing connection status, configuration, logs, about section, and debug toggle switched on with a dark-themed design.

  2. 选择 日志。从 日志级别 下拉列表中选择日志类别。
    你将看到基于所选日志级别的最近日志。您可以单击 “复制” 按钮复制日志详细信息，并将信息发送给支持团队进行故障排除。

    Log viewer interface showing system logs, options to set log level, view logs in native window, connection issues, and system information like OS version and hardware data.

  3. 单击 “查看 ”，即可在操作系统本机窗口中查看 Marvis 客户端捕获的日志。
    注意：

    如果您联系瞻博网络 Mist 支持团队来解决任何问题，系统可能会要求您提供详细信息，例如组织 ID、UUID 和组织名称。您可以在 “关于” 页面中找到列出的这些详细信息，您可以从汉堡菜单访问该页面。

    关于页面中的信息因操作模式而异：

    • 载入模式 - 应用版本和 UUID、用户信息、组织名称
    • 遥测模式 — 应用版本和 UUID、用户信息、组织名称
    • 调试模式 - 应用版本和UUID、用户信息、组织名称、组织ID

卸载 Marvis macOS 客户端

您可以使用 Finder （GUI） 或 CLI 卸载 Marvis macOS 客户端。CLI 方法提供了一个全新卸载选项来删除残留文件和配置。

卸载 Marvis macOS 客户端 （GUI）

GUI 方法提供了一种用户友好的方式来卸载 Marvis 客户端。

  1. 打开 Marvis 客户端 应用。

  2. 导航至 “关于” 页面。

  3. 点击卸 载 以卸载 Marvis 客户端。

    注意：卸载选项在 Marvis macOS 客户端版本 1.1.0 及更高版本中可用。

    Confirmation dialog to uninstall Marvis Client, warning that the action is permanent and cannot be undone, with Cancel in blue and Uninstall in red options.

使用 CLI 卸载 Marvis macOS 客户端

CLI 方法为高级用户提供了灵活性，可以同时配置 Marvis 客户端的标准卸载和全新卸载。此过程需要管理权限。出现提示时输入您的管理员密码。

标准卸载

要仅删除应用程序（不带配置文件）：

  1. 打开 终端。

  2. 运行以下命令：

    • 对于标准卸载：

    • 对于全新卸载：

全新卸载

要完全移除 Marvis 客户端，包括所有残留文件和配置：

  1. 通过在“关于”页面上点击版本号 7 次来启用调试模式。

  2. 点按 卸载。

    注意：卸载选项在 Marvis macOS 客户端版本 1.1.0 及更高版本中可用。

  3. 启用这两个选项并点击 卸载 继续。

    • 移除配置文件

    • 全新卸载

    Uninstall dialog for Marvis Client with options to remove configuration profiles and clean uninstall enabled. Cancel and Uninstall buttons are at the bottom. Warning states uninstalling is permanent.