网关更新
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 小时。卡片会显示必需更新以及它自动安装的时间。
- 截止时间之前,必需更新与其他更新的行为相同。
- 截止时间之后,它会在下一个空闲时段或下次启动时安装。两种模式下都是如此,无论是否经过批准。
- 截止时间过后一小时,即使网咖繁忙也会安装。此时卡片显示必需更新,即使网吧繁忙也将在一小时内安装。
更新的安装过程
- 网关每隔几分钟检查一次新版本。第一次检查在网关启动一分钟后进行。
- 发现更新的版本后立即下载。只有文件校验和匹配且文件由 HandyCafe 签名时才会保留,任一检查不通过的文件都会被丢弃。
- 根据模式等待合适的时机。
- 由一个单独的程序,即网关更新程序接手。它会再次检查签名,并把当前版本另存一份副本。
- 更新程序静默运行安装程序。安装程序停止网关服务,替换其文件,然后重新启动服务。
- 更新程序最多等待 90 秒,看新版本是否响应。
- 如果新版本有响应,更新即完成。如果没有,更新程序会停止服务,放回之前复制的版本,再重新启动。
- 更新程序为已登录的 Windows 用户重新启动网关的通知区域图标。
没能正常启动的版本永远不会再次尝试。卡片上的上次结果会写明该版本以及网关退回到的版本。有更新的版本发布时,网关会安装那个版本。
如果更新中途被打断(例如重启电脑),网关会发现更新没有完成,并在稍后重试。每个版本最多尝试三次。
操作步骤
批准待安装的更新
- 打开设置 > 网关连接。
- 在网关更新中,确认状态显示为需要批准。
- 点击批准。
更新会在下一个空闲时段或网关下次启动时安装。
立即更新网关
- 选择一个可以接受断网 1 到 2 分钟的时间。
- 打开设置 > 网关连接。
- 在网关更新中,点击立即更新。
- 阅读警告现在更新网关吗?,然后点击立即更新确认。
卡片会先显示安装过程,再显示结果。在网关自身的页面上,同一按钮会通过是,立即更新请求确认。
改为每次更新都需批准
- 打开设置 > 网关连接。
- 在网关更新中,打开安装更新列表。
- 选择仅在我批准后安装。
查看网关版本
打开设置 > 关于。版本区域中,服务器和客户端下方有一行网关,显示已安装版本以及已是最新、有可用更新或正在安装。检查更新会从网关刷新这一行,但不会让网关去检查新版本。要检查新版本,请使用网关更新卡片上的立即检查。
手动安装或升级
网关连接后,下载卡片会移到设置 > 网关连接底部的手动安装或升级区域。它提供与首次安装相同的安装程序。在网关电脑上运行它,即可升级现有安装。
当卡片显示此网关无法自动更新,请使用下方的手动安装。 时,请使用此方法。这会在两种情况下出现:
- 网关没有以 Windows 服务方式运行。
- 新版本要求的起始版本比已安装的版本新,自动更新无法直接升级到该版本。
通知区域图标
网关电脑会为已登录的用户在 Windows 通知区域中显示 HandyCafe Gateway 图标。它每五秒检查一次网关,不保存任何密码,也不更改任何设置。
| 项目 | 作用 |
|---|---|
| 点击图标 | 在浏览器中打开网关自身的页面。 |
| 打开网关页面 | 作用相同,从图标菜单中打开。 |
| 重启网关... | 打开网关页面并显示重启确认。网关未运行时显示为灰色。 |
| 状态行 | 运行中、需要设置、需要设置密码或未运行。 |
| 退出 | 关闭图标,网关继续运行。 |
重启网关
网关自身页面的状态标签页中有一个重启网关按钮。
- 点击重启网关。
- 阅读警告:所有电脑和 Wi-Fi 访客可能断网最多一分钟。
- 点击是,立即重启。
页面会等待网关恢复,然后回到登录表单,并显示网关已重启。请重新登录以继续。 重启还会停止并重新启动所有依赖网关的 Windows 服务。
安装更新期间会拒绝重启,页面显示网关正在安装更新。请在安装完成后重试。
故障排查
卡片显示“无法连接到网关。” HandyCafe Server 无法连接到网关。如果最近几分钟内开始过更新,请等待其完成。否则请参见网关故障排查。
更新长时间停留在“更新已就绪”。 网咖没有连续五分钟处于空闲状态。请在方便的时候点击立即更新。重启网关也可以,因为待安装的更新会在网关启动时安装。
卡片上“上次检查时间”旁边有警告图标。 上次检查新版本失败,通常是因为网关电脑当时没有联网。鼠标悬停在图标上可查看原因,点击立即检查可重试。
上次结果显示该版本无法安装。 网关仍在运行之前的版本,并且工作正常,无需任何操作。有更新的版本发布后会自动安装。
网关页面提示重启后网关没有恢复。 保持页面打开,它会持续重试。如果几分钟后仍无变化,请重启网关电脑。