Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
本页内容
 

Marvis Android 客户端

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

Android 版 Marvis 客户端可以详细查看 Android 设备与无线网络的交互方式。它通过提供对设备连接和性能的洞察，帮助优化网络性能、简化故障排除并增强整体用户体验。

以下设备支持 Marvis Android 客户端：

  • 运行 Android 8.0 及更高版本的 Android 手持设备和智能手机

  • 运行 Android 8.0 及更高版本的斑马设备

Marvis Android 客户端安装概述

您可以使用以下任何一种方法来安装应用程序：

  • 手动 - 直接从 Google Play 商店或 Juniper Mist 门户下载并安装 Marvis 客户端应用。

    要从Juniper Mist门户下载客户端，请执行以下作：

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

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

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

  • Android 调试桥 （ADB） - 使用 ADB 安装应用，ADB 是一种命令行工具，开发者可以使用该工具与 Android 设备通信，以调试问题并安装/卸载应用。

  • 移动设备管理 （MDM） - 使用以下任一 MDM 解决方案安装应用：

    • AirWatch 或 VMware Workspace ONE

    • SOTI

    注意：

    我们仅测试了与上面列出的 MDM 的互作性。

要求

开始安装之前：

  • 为应用启用 表 1 中列出的强制权限。

    表 1：Android 版 Marvis 客户端应用所需的权限

    许可

    描述

    必需或可选

    位置 - 始终设置为允许

    使 Marvis 客户端应用能够获取 Wi-Fi 漫游数据并按预期运行。

    命令的

    蓝牙

    允许应用获取位置的 x 和 y 坐标。

    命令的

    附近的设备

    使应用能够确定附近设备的相对位置。Android 12 需要启用此权限才能在移动设备上运行定位服务。

    命令的

    通知

    如果您希望在 Marvis 客户端在后台主动运行时收到通知，则启用通知。

    自选

    相机 - 设置为 允许一次

    允许您在注册过程中扫描二维码。如果您通过 ADB 或 MDM 安装应用程序，则无需启用此权限。

    自选

  • 配置您的网络防火墙设置，以允许 Marvis 客户端连接到您的组织。

    如果您的组织驻留在 Amazon Web Services （AWS） 云中（默认），请使用以下设置：

    • wss://client-terminator.mistsys.net:443/ws 或协议 WSS （websocket） 端口 443（用于域/路径）

    • https://api.mist.com 或域的 HTTPS 协议端口 443

    如果您的单位位于 Google Cloud Platform （GCP） 云中，请使用以下设置：

    • wss://client-terminator.gc1.mist.com/ws 或协议 WSS （websocket） 端口 443（用于域/路径）

    • https://api.gc1.mist.com/ 或域的 HTTPS 协议端口 443

    注意：

    如果您的组织驻留在 AWS 或 GCP 以外的云中，请与支持团队联系，获取相应的 URL 以配置防火墙设置。

  • 获取您的密钥或二维码以加载 Marvis 客户端。

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

    2. 单击移动 SDK 页面顶部的 Token 。

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

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

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

    注意：要使用 API 获取 Secret Token，请参阅 创建 SDK 邀请。

最佳做法是，建议禁用随机 MAC 地址。这样就避免了每次设备连接到网络时都要重新注册的需要。要禁用随机 MAC 地址：

  1. 导航到设备上的“设置”页面。

  2. 点击 “网络和互联网 ”或 “连接 ”，然后点击 “Wi-Fi”。

  3. 点击无线连接旁边的齿轮（设置）图标。

  4. 点击MAC地址类型，然后点击电话MAC。

作模式

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

  • 生产模式 - 可以在安装过程中使用命令行参数设置的实时环境的标准作模式。

  • 概念验证 （POC） 模式 - 用于测试和评估的作模式，也是默认模式。

  • GUI 或非 GUI 模式 - 启用或限制对 Marvis 客户端的可视访问的模式。在非 GUI 模式下，您无法访问任务栏中的用户界面或 Marvis 客户端图标。

  • 调试模式 — 访问日志的模式。您无法在此模式下编辑配置。

注意：

  • 如果要在生产模式下查看配置设置，则需要切换到调试模式。但是，这些设置是不可编辑的。

  • 在 POC 模式下，您可以查看和编辑配置设置，而无需依赖调试模式。

连接状态

Marvis 客户端状态由可视指示器和以下连接状态指示：

  • 断开连接 — 客户端未连接到Juniper Mist云。

  • 已连接 — 客户端已连接到Juniper Mist云。

  • 正在连接 — 客户端请求连接到Juniper Mist云。

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

使用 SOTI MDM 部署 Marvis 客户端

要使用移动设备管理 （MDM） 解决方案部署 Marvis 客户端，您必须自定义 Android 软件包工具包 （APK） 软件包部署。您可以使用意图作自定义 APK 部署，以在安装时设置密钥软件开发工具包 （SDK） 令牌。当您启动自定义应用程序包时，客户端将完全预配置并载入作。

您可以使用 SOTI MDM 将 Marvis 客户端上线。

注意：

我们不会使用 SOTI 介绍整个通用 Android 应用部署过程。我们仅提供自定义 Android 应用程序以完成 Marvis 客户端部署所需的信息。

开始之前：

  1. 确保您有 Windows 设备或虚拟机 （VM）。你将运行仅在 Windows 设备上运行的 Package Studio。

  2. 下载 SOTI 的 MobiControl Package Studio （McStudio.exe）。

要使用 SOTI MDM 部署 Marvis 客户端，请执行以下作：

  1. 在 Windows 设备或 VM 上，启动 Package Studio 并使用以下设置创建包项目：

    • 处理器 —All （除非您针对的是特定 CPU 或设备类型）

    • 平台—Android

    • 作系统版本 - 8 或更高版本

    • 版本字符串 - 与 APK 版本相同

    • 供应商 — 瞻博网络

    • 可选空间要求规格

  2. 添加 Marvis 客户端 APK。
  3. 添加以下脚本文件：

    • 脚本引擎 - 传统版

    • 脚本类型 - 安装后

  4. 导入脚本文件。脚本文件必须包含以下内容：

    如果您在 Zebra 设备上配置了用于语音呼叫的特定端口，则脚本文件必须包含以下内容：

  5. 生成包。

使用 SOTI 部署定制软件包时，系统会预配置并载入 Marvis 客户端。

使用 AirWatch 或 VMware Workspace ONE 部署 Marvis 客户端

我们不介绍使用 AirWatch 部署整个通用 Android 应用的过程。我们仅介绍完成 Marvis 客户端部署所需的具体步骤。

使用以下 intent 命令部署客户端：

如果您在 Zebra 设备上配置了用于语音呼叫的特定端口，请使用以下 intent 命令：

您可以使用以下引用来部署 intent 命令：

使用其他 MDM 部署 Marvis 客户端

如果您使用的是任何其他 MDM，请验证该 MDM 是否支持意图执行。下面是基于Android Debug Bridge（ADB）（开发者/调试）部署的示例，可用于适应所选的MDM：

如果 MDM 解决方案不支持执行 Android 意图，则可能需要手动载入每个已部署的客户端设备。请参阅 载入和配置 Marvis 客户端。

验证安装

安装并载入 Marvis 客户端后，请验证这些进程是否已正确运行。确保您的设备已连接到Mist Wi-Fi 网络。

要验证安装，请执行以下作：

  • 确认已正确应用机密令牌值。导航到 Marvis 客户端应用上的“关于”或“配置”（如果您处于非生产模式）页面，并验证密钥令牌值是否仍存储在字段中。

    如果数据未保留且密钥令牌字段为空，请手动输入密钥令牌值。您可能还需要配置应用程序部署以保留应用程序数据。

  • 上线 Marvis 客户端约 15 分钟后，确认 Marvis 客户端数据已在Juniper Mist门户上可用。入网 Marvis 客户端后，您至少需要等待 10 到 15 分钟，数据才能传播到 Juniper Mist 云。

    当收集数据并将其发送到Juniper Mist云的客户端工作流中出现问题时，客户端数据在 Juniper Mist 门户上不可用。请联系支持团队。您可以在 Marvis 客户端应用中访问日志。请参阅 在 Marvis Android 客户端中查看日志。或者，您还可以使用 Logcat 或 Android Debug Bridge （ADB） 等工具收集 Marvis 客户端日志，并与支持团队共享日志。

    对于 Zebra 设备，您可以使用 RxLogger 工具作为收集日志的替代方法。

    联系支持团队时，必须共享 Marvis 客户端 UUID。您可以在 Marvis 客户端应用的 “关于” 页面上找到该 UUID。UUID 用于跟踪从 Marvis 客户端到 Juniper Mist 云的数据流。

载入并配置 Marvis 客户端

安装应用后，需要载入并配置应用。
  1. 转到Juniper Mist门户中的“组织>移动 SDK”页面，然后选择“令牌”选项卡以找到您的密钥令牌或二维码。单击“查看”以显示二维码。
  2. 打开 Marvis 客户端应用。
  3. 点击汉堡包图标，然后点击配置。
    此时将显示 Configuration 页面。

  4. 点击移动 SDK 密钥字段旁边的二维码图标。将设备摄像头对准Juniper Mist门户上显示的二维码。
    应用会扫描二维码，并在 Mobile SDK Secret 字段中插入匹配的 Secret 令牌值。
  5. 输入以下参数的值：

    • 位置可见性

      默认情况下，“位置可见性”设置为 “关闭”。如果启用位置可见性，设备将在Juniper Mist门户的 “客户端 ”> “应用客户端 ”页面中列为应用客户端 5 秒钟。您可以将显示频率设置为：

      • 低 - 每 10 分钟显示一次。

      • 标准（推荐）- 每 5 分钟显示一次。

      • 高 - 每分钟显示一次。

      注意：

      如果要启用位置可见性，则需要在接入点 （AP） 上启用 vBLE。您可以通过购买用户参与和/或资产可见性订阅来激活 vBLE（除了 Wireless Assurance 基本订阅之外）。

    • 移动客户端名称

    • 移动语音呼叫端口（仅适用于 Zebra 设备）

  6. 点击应用以保存配置。

    如果尚未设置权限，则会看到权限请求。启用 表 1 中列出的权限。确保将 “位置 ”权限设置为 “始终允许”。

  7. 点击汉堡包图标，然后点击连接状态以查看连接状态页面。

    验证状态是否显示为 “已连接”。

    Marvis 客户端现在已完成所有设置，可以向Juniper Mist门户发送数据。您需要等待大约 15 分钟，数据才会显示在Juniper Mist门户上。

在 Marvis Android 客户端中查看日志

Marvis 客户端将日志分类为：

  • 信息 - 一般信息

  • 错误 - 关键问题

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

若要在应用中查看日志，需要在应用上启用调试模式：
  1. 点击汉堡包图标，然后点击 Marvis 客户端图标 7 次。
    系统将提示您输入密码。
  2. 输入密码作为 AIDriven。

    您将在菜单中看到“日志”选项。

  3. 点按日志。
  4. 启用“查看日志”以查看 Marvis 客户端捕获的日志。您可以从日志级别下拉列表中选择要查看的信息类型。
    您可以单击 “复制 ”按钮复制日志详细信息，并将其发送给支持团队进行故障排除。
    注意：

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