HandyCafe Docs
owner it-admin

ゲートウェイのインストール

ここに書かれている作業は、店舗に初めてゲートウェイを導入するときに一度だけ行うものです。まだ読んでいない場合は、先にゲートウェイを読んでください。ゲートウェイとは何か、どこに設置するかを説明しています。


ステップ1: PCを選ぶ

ゲートウェイには、営業中ずっと起動しているWindows PCが1台必要です。選択肢は2つあり、どちらも一般的な構成です。

HandyCafe Serverを動かしているPCと同じPC。 追加で購入するものも置き場所も不要で、管理するPCも1台で済みます。その代わり、ServerのPCを再起動すると店舗のインターネットも一緒に止まり、そのPCには2つ目のネットワークアダプターが必要になります。

別のPC。 店舗のインターネットがServerのPCに左右されなくなります。Serverを再起動しても、更新しても、故障しても、全員オンラインのままです。古い事務用PCで十分です。PCを1台回せる店舗なら、こちらのほうがおすすめです。

どちらの場合も、ゲートウェイはHandyCafe Serverから管理します。セットアップが終われば、ゲートウェイPCの前に座る必要はありません。


ステップ2: ネットワークアダプターを2つ用意する

これだけは避けて通れない条件です。ゲートウェイは一方のアダプターでインターネットを受け取り、もう一方のアダプターで店内に配ります。アダプターが1つしかないPCではこれができません。

たいていのPCはマザーボードにアダプターが1つ載っているので、もう1つ追加することになります。

  • PCに空きスロットがあればPCIeのLANカード。最も安く、しっかり固定できる方法です。
  • 空きスロットがなければUSB有線LANアダプター。問題なく動作し、後から店舗全体を別のPCに移すよりはるかに手間がかかりません。

Wi-Fiは店内側のアダプターとしては使えません。店内側はすべての端末の通信を同時に処理する必要があるからです。


ステップ3: ケーブルを配線する

現在モデムから店内のスイッチへつながっているケーブルを探してください。この1本が2本になります。

  1. モデムを、ゲートウェイPCの1つ目のアダプターにつなぎます。
  2. ゲートウェイPCの2つ目のアダプターを、店内のスイッチにつなぎます。

ほかはすべてそのままです。端末もスイッチもモデムも動かしません。

店舗に複数のインターネット回線がある場合は、まず1本目だけをつなぎ、残りは後からWANタブで追加します。インターネット回線を参照してください。


ステップ4: ソフトウェアをインストールする

HandyCafe Serverで設定 > ゲートウェイを開きます。

このPCにインストールする場合

このPCにインストールをクリックします。そのPCが店舗全体のルーターになるため、Serverが一度だけ確認してきます。「はい」を選び、Windowsの許可確認に一度応じれば、あとは自動で進みます。所要時間は数分です。

別のPCにインストールする場合

別のPC用にダウンロードをクリックします。ダウンロードが終わると、ボタンの下にファイルの保存場所が表示されます。そのファイルをUSBメモリにコピーしてゲートウェイPCに持っていき、そこで実行してください。インストール中に入力する項目はありません。

インストールが終わったら

インストーラーはゲートウェイPCのブラウザで2つのページを開きます。Windowsの表示言語で書かれたこのガイドと、ゲートウェイ自身の管理ページです。この時点では、まだネットワークは何も変わっていません。ステップ6でアダプターを選ぶまで、ゲートウェイはネットワークアダプターに手を付けません。


ステップ5: ゲートウェイの管理ページにサインインする

ゲートウェイの管理ページは、ゲートウェイPC上のhttps://127.0.0.1:8443/にあります。通知領域のアイコンからも開けます。

最初にブラウザが証明書について警告します。 これは想定どおりの動作です。この証明書はゲートウェイが自分で署名したもので、自店のネットワーク上のPCを外部の誰かが保証することはできないからです。警告ページでブラウザの「詳細設定」などのオプションを開き、サイトへ進むことを選んでください。

初期のサインイン情報でサインインします。

ユーザー名 パスワード
admin handycafe

これはすべての新しいゲートウェイで共通の値で、意図的にここに記載しています。秘密の情報ではなく、あくまで出発点です。サインインすると、ほかの操作より先に独自のユーザー名とパスワードを設定するよう求められます。HandyCafe Serverは、別のPCから同じ情報でサインインします。初期パスワードを知っている人なら誰でも同じことができてしまいます。

以前にパスワードを変更している場合は、そのパスワードでサインインしてください。


ステップ6: どちらのアダプターがどちら側かを指定する

ネットワークセットアップタブを開きます。PCのネットワークアダプターが、アドレスとケーブルが接続されているかどうかとともに一覧表示されます。どれがモデム側で、どれが店内側かの候補も提示されます。

  • インターネット側のアダプター: モデムからのケーブルが挿さっているアダプター。
  • カフェ側のアダプター: 店内のスイッチからのケーブルが挿さっているアダプター。

候補を受け入れる前に確認してください。2つのアダプターが同じ機種だと名前だけでは区別できませんが、片方のケーブルを一瞬抜けば区別できます。抜いたほうが「未接続」と表示されます。

適用をクリックします。

適用後の確認

どのアダプターをどちら側に使うかを変えると、そのPCのネットワーク構成が組み替えられます。選択を間違えると店舗のインターネットが切れ、元に戻すためにゲートウェイへ接続することも誰にもできなくなります。

そのため、ゲートウェイは変更をそのまま適用するのではありません。適用したうえで正常に動いているかを尋ね、1分以内に誰も応答しなければ自動で元の設定に戻します。

はい、この設定のままにすると答える前に、2つ確認してください。このPCがまだインターネットにつながること、そして店内のPCが1台でもインターネットにつながることです。どちらかがつながらない場合は、いいえ、元の設定に戻すと答えるか、何も答えずに1分が過ぎるのを待ってください。

その後、ステータスタブに両方のアダプター、店内ネットワークでのゲートウェイのアドレス(新規インストールでは192.168.10.1)、店内のPCにアドレスが割り当てられているかどうかが表示されます。何か問題があれば、このタブに内容と対処方法が表示されます。


ステップ7: HandyCafe Serverを接続する

HandyCafe Serverで設定 > ゲートウェイを開き、次の項目を入力します。

  • ゲートウェイアドレス: 店内ネットワークでのゲートウェイのアドレス。新規インストールでは192.168.10.1です。ゲートウェイがServerのPC上で動いている場合も、同じアドレスで接続できます。
  • ポート: 8443。
  • ユーザー名とパスワード: ステップ5でサインインに使ったもの。

接続をテストをクリックし、続けて接続をクリックします。Serverはゲートウェイの証明書を記憶し、証明書が変わった場合は接続を拒否します。


ステップ8: 動作を確認する

  • HandyCafe Serverのメインメニューにインターネットページが表示され、その概要タブで回線がつながっていると表示される。
  • 店内ネットワーク上の端末でウェブページが開ける。
  • 設定 > ゲートウェイで、ゲートウェイが接続済みと表示される。

これでインストールは完了です。ここから先は日々の運用で、すべてインターネットページで行います。


ゲートウェイの管理ページ

ステップ5でサインインした管理ページは、インストール後も役に立ちます。HandyCafe Serverが起動できないときや、ゲートウェイに接続できないときの入口になります。ステータスの確認、ネットワークセットアップのやり直し、ログの閲覧、サポート用の診断ファイルのダウンロード、ゲートウェイの再起動、パスワードの変更ができます。それ以外の操作はすべてHandyCafe Serverで行います。

このページはゲートウェイPCに対してのみ提供されます。ネットワーク上の別のPCからは何も表示されず、サインイン画面すら出ません。


パスワードを忘れた場合

ゲートウェイPCで管理者としてコマンドプロンプトを開き、次の3つのコマンドを順番に実行します。

net stop HandyCafeGateway /y
"C:\Program Files\HandyCafe\Gateway\gatewayd.exe" --config "C:\Program Files\HandyCafe\Gateway\gatewayd.toml" reset-admin-password
net start HandyCafeGateway

アカウントはadmin / handycafeに戻ります。これでサインインし、ゲートウェイの管理ページと設定 > ゲートウェイの両方で、独自のパスワードを設定し直してください。ゲートウェイが停止している間、店舗はインターネットに接続できません。この操作をネットワーク経由で行う方法はなく、これは意図的な仕様です。


ゲートウェイを別のPCに移す

新しいPCにインストールし、Serverを新しいアドレスに接続します。そのあと古いPCからアンインストールするか、少なくともサービスを停止してください。同じネットワーク上で2台のゲートウェイがアドレスを配ると、互いに衝突します。