开发者中心

Jasper控制中心

概览

“Jasper控制中心添加到QuarkIoE平台上”为你提供了一个在QuarkIoE设备管理应用上对连接管理的总览。QuarkIoE平台本身直接与设备通信并且显示设备上报的连接信息,Jasper控制中心在此基础上增加了移动网络上报的连接补充信息。

Jasper architecture

如果你已经有了Jasper控制中心账户,可以把账户和你在QuarkIoE上的租户直接相连,你可以进行如下操作:

  • 检查SIM卡的状态并且可以激活或者停用此卡。
  • 检查网络上报的设备在线状态
  • 检查数据/短信/语音使用情况
  • 查看流量或者SIM卡的变化的历史记录
  • 调用控制中心的诊断工具
  • 通过文本信息和设备通信,比如,设置APN参数

其他部分的描述

用户在Jasper平台创建账户并且用此账户在QuarkIoE平台进行配置,QuarkIoE通过此账户接入你在Jasper控制中心。从QuarkIoE平台访问Jasper控制中心都用此账户名,所以Jasper账户权限直接影响QuarkIoE平台的可用功能。

除了账户,你还需要一个API许可证以及API服务器网址,为了确定你的API许可证秘钥和API服务器网址,你需做如下操作:

  • 用控制中心管理员身份登录你的账户,在控制中心主页点击“API集成”
  • 你的API许可证秘钥和服务器URL都显示在页面上部左侧

我们强烈建议你在Jasper控制中心创建一个专有用户:

  • 权限还是管理员身份,导航到“管理员”和“用户”
  • 点击“创建新用户”按钮
  • 键入用户名和其它所需信息。
  • 如果你想从QuarkIoE平台激活或者停用SIM卡,或者从平台发送SMS信息,必须选择角色定位“账户用户”,如果你选择角色定义“账户只读”,你将无法进行上述操作。
  • 点击“OK”完成用户创建,然后键入密码,再次点击“OK”(你需要键入新密码而不是你得到的那个密码)
Jasper user management

用户已经创建,但还没有密码,根据给你的邮件的提示重设一个密码,然后进行如下操作把你Jasper控制中心账户和你的QuarkIoE平台账号链接在一起:

  • 使用QuarkIoE管理员权限登录QuarkIoE管理员应用
  • 点击“连接”选项。如果这个选项没有在页面上显示,请确认你是否具有管理员权限make sure that your user has the "admin" permission for option management。如果你确认有管理员权限但还是没法看到此选项,发邮件给support@quarkioe.com 把Jasper控制中心加到你的租户账号上去。
  • 然后输入秘钥,网址,用户名,密码,点击“保存”。
Jasper settings

现在我们切换到设备管理应用,导航到一个移动设备,此设备通过SIM连接并且受Jasper控制中心管理。你可以看到一个标签:连接。如果你没有看到此标签,那有可能:

  • 这个用户名没有“连接”权限
  • 这个设备没有连接到SIM卡
  • 设备连接到SIM卡,但是此SIM卡不受Jasper控制中心管理。

要分配权限,导航到管理应用界面,在“连接”页面选择“只读”或者“管理”权限

Connectivity permission settings

Jasper控制中心通过ICCID(集成电路卡标识符)来识别SIM卡,通常情况下,设备会把所用SIM卡的ICCID自动上报给QuarkIoE平台,如果ICCID没有显示,那么你需要:

  • 确认SIM卡的ICCID。 SIM卡背面会印上此ICCID并且在控制中心可以看到
  • 把ICCID输入到“信息”标签下,然后点击保存。
  • 然后单击浏览器上的“重新加载”按钮,让“连接”标签出现

注意:第一次操作时可能需要过几秒中此标签才能出现,因为QuarkIoE需要检查并确认此SIM卡是否受Jasper控制中心管理。

浏览“连接”标签

现在导航到“连接”标签,此标签含有几部分信息

  • 状态
  • 短信
  • 会话
  • 审计日志

有些部分可能不显示或者是空缺的,比如当没有发送过短信或者你没有权限发送短信,你就看不到短信部分。

状态部分列出了SIM卡的信息汇总,如下截屏所示。第一行显示了是否这个设备正在运行数据会话,如果是,会话的开始和WAN IP地址都会显示出来。

这部分的左侧显示了更多信息,比如SIM卡的ICCID, 激活状态,以及如果设置了,分配给SIM卡的固定IP地址。如果针对“连接”你有管理员权限,你可以通过下拉菜单来修改激活状态。

这部分的右侧显示了当前月份的使用信息,即从本月的第一次使用开始到今天为止。工具提示显示了覆盖了的时间段,包括过去一个月的使用情况。

Status section

“短信”部分显示了设备发送和接收到的文本信息,包括:

  • 文本信息发送和接收的时间
  • 文本信息是从哪里发来的已经发去哪里
  • 信息的发送状态:
    • 对发给设备的信息,如果设备尚未接收,则显示:待定;如果设备端已经接收,则显示:送达。
    • 对从设备端发送的信息:如果控制中心已收到,则显示:接收;如果控制中心还没收到,则显示:取消。
  • 信息的方向:控制中心向终端发送的,显示;MT;如果是从终端向控制中心发送的,显示:MO.

如果你对“连接”有管理员权限,你可以在平台上输入文本信息并点击“发送短信”把信息发到设备上。

SMS section

“会话部分”显示了设备端数据会话的日志。列出了会话开始的时间,持续时长以及消耗了多少数据流量。

Sessions section

最后,这设计日志部分列出了SIM卡和费用的改变。日志显示改变的类型,改变前后的值,以及此改变由谁发起,何时发起,是否成功等信息。

Audit logs section

此标签不会实时更新。点击顶部的“重新加载”来显示最新状况。

管理连接

如果你怀疑设备没有正确上报给QuarkIoE平台,或者没有从平台正确接收信息,你可以使用“连接”标签来验证该设备连接状态。检查如下信息:

  • 此SIM是否激活。假如SIM卡尚未激活,你可以从状态栏的下拉菜单里选择“激活”选项来激活此SIM卡。SIM卡在网络侧激活可能需要一点时间。也许还会需要对设备进行重置,让设备再次拨号。
  • 设备是否连接到网络。如果没有连接到网络,可能有如下几个原因:
    • 设备所处位置没有网络覆盖。如果设备上报了网络质量参数,你可以导航到设备的“测量” "Measurements" tab选项来认证最后上报的信号强度和错误率参数。
    • 网络或者硬件(天线/调制解调器等)问题。 选择右上角的齿轮图标,点击“SIM卡详情”, 然后打开Jasper控制中心的诊断工具。如果设备没有尝试连接到网络,可能设备有故障。
  • 设备是否有数据会话。如果没有,可能有如下原因:
    • 设备端配置的APN不正确
    • 流量超额
    • SIM卡漫游在异地但数据漫游选项被关闭
    • 在特定网络中的数据漫游不被允许
    • SIM配置被修改

可以通过几个方面对数据连接作分析:

  • 如果设备上报网络配置,导航到“网络”标签并进行认证,修改APN设置。
  • 如果设备支持“Shell”,导航到“Shell”"Shell" tab选项然后认证,编辑APN设置和漫游配置
  • 检查“连接”选项下的“会话”部分,看设备之前是否一直在通信以及消耗的流量。
  • 检查“连接”选项下的“审计日志”部分,看对SIM卡是否有最新的变更。
  • 最后,点击右上角的齿轮标记,选择“SIM卡详情”来查看Jasper控制中心上的SIM卡配置。

“SIM卡详情”菜单项要求你以管理员身份在Jasper控制中心单独登录。

最后,如果设备端还是无法上报信息给QuarkIoE平台,可能是设备端的配置问题或者软件问题。

  • 设备可能丢失了凭证, 比如说由于在现场重置或者完全掉电。这种情况下,你需要重新登记 re-register the device此设备。
  • 设备端可能是配置问题或者软件问题,这个需要对设备端进行具体分析。