HandyCafe Docs
owner it-admin

网关更新

HandyCafe Gateway 会自动保持最新。它自行检查新版本,在后台下载,并在网咖空闲时安装。如果新版本无法正常启动,网关会退回到之前的版本。

安装更新会重启网关。在此期间,网咖内所有电脑和 Wi-Fi 访客都会断网 1 到 2 分钟。本页的全部内容,就是帮您决定这一两分钟落在什么时候。


入口位置

更新状态显示在三个地方,三者读取的是网关上的同一状态。

位置 路径 可执行的操作
HandyCafe Server 设置 > 网关连接 > 网关更新 查看已安装版本和待安装版本,更改模式,批准,立即更新,立即检查。
网关自身的页面 网关电脑上的 https://127.0.0.1:8443/,状态标签页,更新卡片 相同的控件。HandyCafe Server 无法连接网关时很有用。
关于 设置 > 关于 > 版本 网关一行,显示已安装版本以及是否有待安装的更新。

互联网页面的概览标签页也会显示正在运行的版本。

HandyCafe Server 保存了网关连接后,才会出现网关更新卡片。在此之前,页面只提供安装入口。参见安装网关。


要求

  • 权限:收银员需要网关设置和 Wi-Fi 设备选项卡权限才能打开设置 > 网关连接。
  • Windows:只有当网关以安装程序设置的 Windows 服务方式运行时,才会自动更新。否则卡片会提示需要手动更新。

网关更新卡片

设置 > 网关连接中的卡片包含以下部分。

部分 显示内容
已安装:{version} 网关上当前运行的版本。
上次检查时间 {time} 网关上次检查新版本的时间。立即检查会让它马上重新检查。旁边出现警告图标表示上次检查失败,鼠标悬停即可查看原因。
状态标签 已是最新、更新已就绪、正在更新、需要批准、必需更新或需要手动更新。旁边的信息按钮会解释自动模式。
安装更新 更新模式,见下文。
版本 {version} 可下载({size}) 新版本已下载或正在下载。如果该版本附有发行说明,会显示在下方。
正在下载 {version}:{percent}% 下载进度,带进度条。
批准 在需要批准的模式下,有版本等待批准时显示。
立即更新 显示警告后立即安装待安装的版本。
上次结果 上一次更新的结果:已从 {from} 更新到 {version}。、回滚消息或失败消息。鼠标悬停可查看发生时间。

安装更新期间,卡片显示正在安装,网络将在 1 到 2 分钟后恢复。 此时网关不会响应。卡片最多会在五分钟内一直显示为正在安装,而不会报告连接中断。

如果网关完全没有响应,卡片会显示无法连接到网关。 以及重试按钮。


更新模式

安装更新列表有两个选项。

模式 结果
在空闲时段自动安装 默认模式。已下载的版本会在下一个空闲时段或网关下次启动时安装。
仅在我批准后安装 已下载的版本会一直等待,直到有人点击批准。批准后仍会等到空闲时段或下次启动时安装。在网关自身的页面上,此选项显示为仅在批准后安装。

模式保存在网关上。在 HandyCafe Server 或网关页面上更改模式,两处会同时改变。

什么算空闲时段

以下两个条件连续五分钟同时满足时,网关才认为网咖处于空闲状态:

  • 没有人用兑换券或会员账户登录访客 Wi-Fi。
  • 所有设备的总流量每分钟少于约 512 KB。

刚启动的网关不算空闲,它会先完整观察网络五分钟。

必需更新

某个版本可以被标记为必需更新。它带有截止时间,除非版本另有规定,否则为出现后 72 小时。卡片会显示必需更新以及它自动安装的时间。

  • 截止时间之前,必需更新与其他更新的行为相同。
  • 截止时间之后,它会在下一个空闲时段或下次启动时安装。两种模式下都是如此,无论是否经过批准。
  • 截止时间过后一小时,即使网咖繁忙也会安装。此时卡片显示必需更新,即使网吧繁忙也将在一小时内安装。

更新的安装过程

  1. 网关每隔几分钟检查一次新版本。第一次检查在网关启动一分钟后进行。
  2. 发现更新的版本后立即下载。只有文件校验和匹配且文件由 HandyCafe 签名时才会保留,任一检查不通过的文件都会被丢弃。
  3. 根据模式等待合适的时机。
  4. 由一个单独的程序,即网关更新程序接手。它会再次检查签名,并把当前版本另存一份副本。
  5. 更新程序静默运行安装程序。安装程序停止网关服务,替换其文件,然后重新启动服务。
  6. 更新程序最多等待 90 秒,看新版本是否响应。
  7. 如果新版本有响应,更新即完成。如果没有,更新程序会停止服务,放回之前复制的版本,再重新启动。
  8. 更新程序为已登录的 Windows 用户重新启动网关的通知区域图标。

没能正常启动的版本永远不会再次尝试。卡片上的上次结果会写明该版本以及网关退回到的版本。有更新的版本发布时,网关会安装那个版本。

如果更新中途被打断(例如重启电脑),网关会发现更新没有完成,并在稍后重试。每个版本最多尝试三次。


操作步骤

批准待安装的更新

  1. 打开设置 > 网关连接。
  2. 在网关更新中,确认状态显示为需要批准。
  3. 点击批准。

更新会在下一个空闲时段或网关下次启动时安装。

立即更新网关

  1. 选择一个可以接受断网 1 到 2 分钟的时间。
  2. 打开设置 > 网关连接。
  3. 在网关更新中,点击立即更新。
  4. 阅读警告现在更新网关吗?,然后点击立即更新确认。

卡片会先显示安装过程,再显示结果。在网关自身的页面上,同一按钮会通过是,立即更新请求确认。

改为每次更新都需批准

  1. 打开设置 > 网关连接。
  2. 在网关更新中,打开安装更新列表。
  3. 选择仅在我批准后安装。

查看网关版本

打开设置 > 关于。版本区域中,服务器和客户端下方有一行网关,显示已安装版本以及已是最新、有可用更新或正在安装。检查更新会从网关刷新这一行,但不会让网关去检查新版本。要检查新版本,请使用网关更新卡片上的立即检查。


手动安装或升级

网关连接后,下载卡片会移到设置 > 网关连接底部的手动安装或升级区域。它提供与首次安装相同的安装程序。在网关电脑上运行它,即可升级现有安装。

当卡片显示此网关无法自动更新,请使用下方的手动安装。 时,请使用此方法。这会在两种情况下出现:

  • 网关没有以 Windows 服务方式运行。
  • 新版本要求的起始版本比已安装的版本新,自动更新无法直接升级到该版本。

通知区域图标

网关电脑会为已登录的用户在 Windows 通知区域中显示 HandyCafe Gateway 图标。它每五秒检查一次网关,不保存任何密码,也不更改任何设置。

项目 作用
点击图标 在浏览器中打开网关自身的页面。
打开网关页面 作用相同,从图标菜单中打开。
重启网关... 打开网关页面并显示重启确认。网关未运行时显示为灰色。
状态行 运行中、需要设置、需要设置密码或未运行。
退出 关闭图标,网关继续运行。

重启网关

网关自身页面的状态标签页中有一个重启网关按钮。

  1. 点击重启网关。
  2. 阅读警告:所有电脑和 Wi-Fi 访客可能断网最多一分钟。
  3. 点击是,立即重启。

页面会等待网关恢复,然后回到登录表单,并显示网关已重启。请重新登录以继续。 重启还会停止并重新启动所有依赖网关的 Windows 服务。

安装更新期间会拒绝重启,页面显示网关正在安装更新。请在安装完成后重试。


故障排查

卡片显示“无法连接到网关。” HandyCafe Server 无法连接到网关。如果最近几分钟内开始过更新,请等待其完成。否则请参见网关故障排查。

更新长时间停留在“更新已就绪”。 网咖没有连续五分钟处于空闲状态。请在方便的时候点击立即更新。重启网关也可以,因为待安装的更新会在网关启动时安装。

卡片上“上次检查时间”旁边有警告图标。 上次检查新版本失败,通常是因为网关电脑当时没有联网。鼠标悬停在图标上可查看原因,点击立即检查可重试。

上次结果显示该版本无法安装。 网关仍在运行之前的版本,并且工作正常,无需任何操作。有更新的版本发布后会自动安装。

网关页面提示重启后网关没有恢复。 保持页面打开,它会持续重试。如果几分钟后仍无变化,请重启网关电脑。