HandyCafe Docs
owner it-admin

ゲートウェイのアップデート

HandyCafe Gateway は自動で最新の状態を保ちます。新しいバージョンを自分で探し、バックグラウンドでダウンロードして、店内が空いているときにインストールします。新しいバージョンが正常に起動しなかった場合、ゲートウェイは以前のバージョンに戻ります。

アップデートをインストールするとゲートウェイが再起動します。その間、店内のすべてのPCと Wi-Fi 利用者は1〜2分間インターネットに接続できなくなります。このページでは、その1〜2分をいつにするかを決める方法を説明します。


確認する場所

アップデートの状態は3か所に表示されます。3か所ともゲートウェイから同じ状態を読み込みます。

場所 開き方 できること
HandyCafe Server 設定 > ゲートウェイ接続 > ゲートウェイのアップデート インストール済みと待機中のバージョンの確認、モードの変更、承認、今すぐアップデート、今すぐ確認。
ゲートウェイ自身のページ ゲートウェイPCの https://127.0.0.1:8443/、ステータス タブ、アップデート カード 同じ操作。HandyCafe Server からゲートウェイに接続できないときに便利です。
バージョン情報 設定 > バージョン情報 > バージョン インストール済みのバージョンとアップデートの待機有無を示す ゲートウェイ の行。

インターネットページの概要タブにも、実行中のバージョンが表示されます。

ゲートウェイのアップデート カードは、HandyCafe Server にゲートウェイ接続が保存されると表示されます。それまではインストールしか表示されません。ゲートウェイのインストールを参照してください。


要件

  • 権限: 設定 > ゲートウェイ接続 を開くには、キャッシャーに ゲートウェイ設定およびWi-Fiデバイスタブ の権限が必要です。
  • Windows: ゲートウェイが自動で更新されるのは、インストーラーが設定する Windows サービスとして実行されている場合だけです。そうでない場合、カードには手動での更新が必要と表示されます。

ゲートウェイのアップデートカード

設定 > ゲートウェイ接続 のカードは次の部分で構成されています。

部分 表示内容
インストール済み: {version} ゲートウェイで現在実行中のバージョン。
前回の確認: {time} ゲートウェイが最後に新しいバージョンを確認した日時。今すぐ確認 をクリックすると、すぐにもう一度確認させます。横に警告アイコンがある場合は、前回の確認がうまくいかなかったことを示します。マウスを重ねると理由が表示されます。
状態ラベル 最新の状態、アップデート準備完了、更新中、承認が必要、必須のアップデート、手動での更新が必要 のいずれか。横の情報ボタンで自動モードの説明が表示されます。
アップデートのインストール アップデートのモード。後述します。
バージョン{version}が利用可能です({size}) 新しいバージョンがダウンロード済みまたはダウンロード中です。リリースノートがある場合は、その下に表示されます。
{version}をダウンロード中: {percent}% ダウンロードの進捗とプログレスバー。
承認 承認モードで、承認待ちのバージョンがあるときに表示されます。
今すぐアップデート 警告の後、待機中のバージョンをすぐにインストールします。
前回の結果 前回のアップデートの結果: {from}から{version}に更新しました。、ロールバックのメッセージ、または失敗のメッセージ。マウスを重ねると実行日時が表示されます。

アップデートのインストール中、カードには インストール中です。インターネットは1〜2分後に復帰します。 と表示されます。その間ゲートウェイは応答しません。カードは接続が切れたと表示する代わりに、最大5分間インストール中の表示を続けます。

ゲートウェイがまったく応答しない場合、カードには ゲートウェイに接続できませんでした。 と もう一度試す ボタンが表示されます。


アップデートのモード

アップデートのインストール の一覧には2つの選択肢があります。

モード 動作
空いている時間に自動的に 既定のモードです。ダウンロードしたバージョンは、次に空いた時間か、次にゲートウェイが起動したときにインストールされます。
承認したときのみ ダウンロードしたバージョンは、誰かが 承認 をクリックするまで待機します。承認後も、空いた時間か次の起動を待ちます。ゲートウェイ自身のページでは、この選択肢は 承認後のみ と表示されます。

モードはゲートウェイに保存されます。HandyCafe Server とゲートウェイのページのどちらで変更しても、両方に反映されます。

空いている時間とみなされる条件

次の2つの条件が5分間続けて満たされると、ゲートウェイは店内が空いているとみなします。

  • バウチャーや会員アカウントでゲスト Wi-Fi にサインインしている人がいない。
  • すべてのデバイスを合わせた通信量が1分あたり約 512 KB 未満である。

起動したばかりのゲートウェイは、空いているとはみなしません。まず5分間まるごとネットワークを監視します。

必須のアップデート

リリースは必須として指定される場合があります。必須のリリースには期限があり、リリースで別途指定されていなければ公開から72時間後です。カードには 必須のアップデート と、自動的にインストールされる日時が表示されます。

  • 期限前の必須のアップデートは、他のアップデートと同じように動作します。
  • 期限を過ぎると、次の空いた時間か次の起動時にインストールされます。これは承認の有無にかかわらず、どちらのモードでも同じです。
  • 期限の1時間後には、店内が混雑していてもインストールされます。そのときカードには 必須です。店内が混雑していても1時間以内にインストールされます。 と表示されます。

アップデートがインストールされる流れ

  1. ゲートウェイは数分ごとに新しいリリースを確認します。最初の確認はゲートウェイの起動から1分後に行われます。
  2. 新しいリリースがあればすぐにダウンロードします。ファイルのチェックサムが一致し、HandyCafe の署名がある場合にのみファイルを保持します。どちらかの確認に失敗したファイルは破棄されます。
  3. モードに応じて、適切なタイミングを待ちます。
  4. 別のプログラムであるゲートウェイアップデーターが処理を引き継ぎます。署名をもう一度確認し、現在のバージョンを退避します。
  5. アップデーターがインストーラーをサイレントで実行します。インストーラーはゲートウェイのサービスを停止し、ファイルを置き換えてから再び起動します。
  6. アップデーターは、新しいバージョンが応答するまで最大90秒待ちます。
  7. 新しいバージョンが応答すればアップデートは完了です。応答しなければ、アップデーターがサービスを停止し、退避したバージョンを戻して再び起動します。
  8. アップデーターは、サインインしている Windows ユーザーのためにゲートウェイの通知領域アイコンを再び起動します。

正常に起動しなかったバージョンが再び試されることはありません。カードの前回の結果には、そのバージョンと、ゲートウェイが戻ったバージョンが表示されます。さらに新しいリリースが公開されると、ゲートウェイはそれをインストールします。

再起動などでアップデートが途中で中断された場合、ゲートウェイは完了していないことを検知し、後で再試行します。1つのリリースにつき3回まで試行します。


操作手順

待機中のアップデートを承認する

  1. 設定 > ゲートウェイ接続 を開きます。
  2. ゲートウェイのアップデート で、状態が 承認が必要 になっていることを確認します。
  3. 承認 をクリックします。

アップデートは、次の空いた時間か、次にゲートウェイが起動したときにインストールされます。

今すぐゲートウェイをアップデートする

  1. インターネットが1〜2分間使えなくなっても問題ない時間を選びます。
  2. 設定 > ゲートウェイ接続 を開きます。
  3. ゲートウェイのアップデート で 今すぐアップデート をクリックします。
  4. 今すぐゲートウェイをアップデートしますか? の警告を読み、今すぐアップデート で確定します。

カードにインストールの状況が表示され、続いて結果が表示されます。ゲートウェイ自身のページでは、同じボタンを押すと はい、今すぐアップデート で確認を求められます。

アップデートごとに承認するよう切り替える

  1. 設定 > ゲートウェイ接続 を開きます。
  2. ゲートウェイのアップデート で アップデートのインストール の一覧を開きます。
  3. 承認したときのみ を選びます。

ゲートウェイのバージョンを確認する

設定 > バージョン情報 を開きます。バージョン セクションの、サーバーとクライアントの下に ゲートウェイ の行があります。インストール済みのバージョンと、最新です、更新があります、インストール中 のいずれかが表示されます。更新を確認 はゲートウェイからこの行の情報を再取得するだけで、ゲートウェイに新しいリリースを探させるものではありません。新しいリリースを探すには、ゲートウェイのアップデートカードの 今すぐ確認 を使います。


手動でのインストールとアップグレード

ゲートウェイが接続されると、ダウンロードカードは 設定 > ゲートウェイ接続 の下部にある 手動でインストール・アップグレード セクションに移ります。初回インストールと同じインストーラーが用意されており、ゲートウェイPCで実行すると既存のインストールがアップグレードされます。

カードに このゲートウェイは自動更新できません。下記の手動インストールをご利用ください。 と表示されたときに使います。これは次の2つの場合に起こります。

  • ゲートウェイが Windows サービスとして実行されていない。
  • 新しいリリースが、インストール済みのものより新しい開始バージョンを必要としている。自動アップデートではそこに到達できません。

通知領域のアイコン

ゲートウェイPCでは、サインインしているユーザーの Windows 通知領域に HandyCafe Gateway のアイコンが表示されます。アイコンは5秒ごとにゲートウェイを確認します。パスワードは保持せず、設定も変更しません。

項目 動作
アイコンをクリック ブラウザーでゲートウェイ自身のページを開きます。
ゲートウェイページを開く アイコンのメニューから同じ操作を行います。
ゲートウェイを再起動... 再起動の確認を表示した状態でゲートウェイのページを開きます。ゲートウェイが実行されていない間はグレー表示になります。
状態の行 稼働中、セットアップが必要、パスワード設定が必要、停止中 のいずれか。
終了 アイコンを閉じます。ゲートウェイは実行を続けます。

ゲートウェイの再起動

ゲートウェイ自身のページの ステータス タブに ゲートウェイを再起動 ボタンがあります。

  1. ゲートウェイを再起動 をクリックします。
  2. 警告を読みます。すべてのPCと Wi-Fi 利用者が最大1分間インターネットに接続できなくなることがあります。
  3. はい、今すぐ再起動 をクリックします。

ページはゲートウェイが復帰するのを待ち、ゲートウェイが再起動しました。続けるにはもう一度サインインしてください。 と表示してサインインフォームに戻ります。再起動により、ゲートウェイに依存する Windows サービスも停止してから再び起動します。

アップデートのインストール中は再起動できません。ページには ゲートウェイはアップデートをインストール中です。完了してからもう一度お試しください。 と表示されます。


トラブルシューティング

カードに「ゲートウェイに接続できませんでした。」と表示される。 HandyCafe Server がゲートウェイに接続できません。数分以内にアップデートを開始した場合は、完了するまで待ってください。そうでない場合はゲートウェイのトラブルシューティングを参照してください。

アップデートが長い間「アップデート準備完了」のままになっている。 店内が5分間続けて空いた状態になっていません。都合のよい時間に 今すぐアップデート をクリックしてください。待機中のアップデートはゲートウェイの起動時にインストールされるため、ゲートウェイを再起動しても構いません。

カードの「前回の確認」の横に警告アイコンが表示される。 新しいバージョンの前回の確認に失敗しました。多くの場合、その時点でゲートウェイPCがインターネットに接続できなかったことが原因です。アイコンにマウスを重ねると理由が表示されます。再試行するには 今すぐ確認 をクリックします。

前回の結果にバージョンをインストールできなかったと表示される。 ゲートウェイは以前のバージョンのまま動作を続けています。対応は不要です。さらに新しいリリースが公開されると、それがインストールされます。

再起動後、ゲートウェイのページにゲートウェイが復帰していないと表示される。 ページを開いたままにしてください。再試行を続けます。数分たっても変化がない場合は、ゲートウェイPCを再起動してください。