HandyCafe Docs
owner it-admin

Instalação do Gateway

Tudo aqui acontece uma única vez, quando a lan house recebe o gateway pela primeira vez. Se ainda não leu, comece por Gateway: lá está o que é o gateway e onde ele fica.


Passo 1: Escolha o PC

O gateway precisa de um PC com Windows que fique ligado enquanto a lan house estiver aberta. Há duas opções, e as duas são comuns.

O mesmo PC que roda o HandyCafe Server. Nada extra para comprar nem para arrumar espaço, uma máquina só para cuidar. O preço é que reiniciar o PC do Server derruba junto a internet da lan house, e esse PC precisa de uma segunda placa de rede.

Um PC separado. A internet da lan house deixa de depender do PC do Server: você pode reiniciar o Server, atualizá-lo ou até vê-lo quebrar, e todo mundo continua online. Um PC antigo de escritório basta. É a melhor opção para uma lan house que tem uma máquina sobrando.

Em qualquer caso, o gateway é gerenciado pelo HandyCafe Server. Depois de configurado, você não precisa mais se sentar no PC do gateway.


Passo 2: Coloque duas placas de rede nele

Esse é o único requisito sem alternativa. O gateway recebe a internet por uma placa e a entrega para a lan house pela outra. Um PC com uma única placa não consegue fazer isso.

A maioria dos PCs tem uma placa na placa-mãe, então você vai adicionar uma segunda:

  • Uma placa de rede PCIe, se o PC tiver um slot livre. É a opção mais barata e a que não sai do lugar.
  • Um adaptador Ethernet USB, se não tiver. Funciona, e dá muito menos trabalho do que mudar a lan house para outro PC depois.

O Wi-Fi não serve como placa voltada para a lan house. O lado da lan house precisa atender todas as estações ao mesmo tempo.


Passo 3: Passe os cabos

Encontre o cabo que hoje vai do modem ao switch da lan house. Esse cabo vira dois.

  1. Do modem para a primeira placa do PC do gateway.
  2. Da segunda placa do PC do gateway para o switch da lan house.

Todo o resto fica onde está. As estações não mudam de lugar, o switch não muda, o modem não muda.

Se a lan house tiver mais de uma linha de internet, conecte a primeira agora e adicione as outras depois pela aba WAN. Veja Linhas de internet.


Passo 4: Instale o software

No HandyCafe Server, abra Configurações > Gateway.

Neste mesmo PC

Clique em Instalar neste PC. O Server pergunta uma vez se você tem certeza, porque esse PC passa a ser o roteador de toda a lan house. Confirme, deixe o Windows mostrar o pedido de permissão uma vez e o resto acontece sozinho. Leva alguns minutos.

Em outro PC

Clique em Baixar para outro PC. Quando terminar, o local do arquivo aparece abaixo do botão. Copie esse arquivo para um pendrive, leve-o até o PC do gateway e execute-o lá. Não é preciso digitar nada durante a instalação.

Quando terminar

O instalador abre duas páginas no navegador do PC do gateway: este guia no idioma do Windows e a página do próprio gateway. Nada mudou na rede ainda. O gateway não mexe nas placas de rede até você escolhê-las no Passo 6.


Passo 5: Entre na página do gateway

A página do gateway fica em https://127.0.0.1:8443/ no PC do gateway. O ícone na área de notificação também a abre.

Primeiro o navegador mostra um aviso sobre o certificado. Isso é esperado. O certificado foi assinado pelo próprio gateway, porque nada fora daquela máquina pode garantir a identidade de um PC da sua própria rede. Na página de aviso, abra os detalhes ou as opções avançadas do navegador e escolha continuar para o site.

Entre com os dados iniciais:

Nome de usuário Senha
admin handycafe

Eles são iguais em todo gateway novo e estão impressos aqui de propósito: não são segredo, são um ponto de partida. Em seguida, a página pede que você defina seu próprio nome de usuário e sua própria senha antes de qualquer outra coisa. O HandyCafe Server entra com os mesmos dados a partir de outro PC. Qualquer pessoa que conheça a senha inicial poderia fazer o mesmo.

Se a senha já foi trocada antes, entre com a senha atual.


Passo 6: Diga qual placa é qual

Abra a aba Configuração de rede. Ela lista as placas de rede do PC com os respectivos endereços e mostra se há um cabo conectado. Também sugere qual delas fica voltada para o modem e qual fica voltada para a lan house.

  • Placa voltada para a internet: a placa em que entra o cabo do modem.
  • Placa voltada para o café: a placa em que entra o cabo do switch da lan house.

Confira a sugestão antes de aceitá-la. Se as duas placas forem do mesmo modelo, só os nomes não vão diferenciá-las, mas desconectar uma por um instante resolve: a que você desconectar aparece como sem conexão.

Clique em Aplicar.

A pergunta que ele faz depois

Mudar qual placa fica voltada para onde refaz toda a configuração de rede desse PC. Se a escolha estiver errada, a lan house fica sem internet e ninguém consegue chegar ao gateway para desfazer.

Por isso o gateway não aplica a alteração e pronto. Ele aplica, pergunta se está tudo funcionando e restaura sozinho as configurações anteriores se ninguém responder em um minuto.

Antes de responder Sim, manter estas configurações, verifique duas coisas: se este PC ainda chega à internet e se um PC da lan house também chega. Se algum dos dois não chegar, responda Não, voltar para as anteriores, ou simplesmente não responda e deixe o minuto passar.

A aba Estado mostra então as duas placas, o endereço do gateway na rede da lan house (192.168.10.1 em uma instalação nova) e se os PCs da lan house estão recebendo seus endereços. Se algo estiver errado, a aba diz o que é e o que fazer.


Passo 7: Conecte o HandyCafe Server

No HandyCafe Server, abra Configurações > Gateway e preencha:

  • Endereço do gateway: o endereço do gateway na rede da lan house, 192.168.10.1 em uma instalação nova. Se o gateway roda no próprio PC do Server, o mesmo endereço funciona.
  • Porta: 8443.
  • Nome de usuário e Senha: os que você usou para entrar no Passo 5.

Clique em Testar ligação e depois em Conectar. O Server guarda o certificado do gateway e se recusa a conectar se ele mudar algum dia.


Passo 8: Confira

  • A página Internet aparece no menu principal do HandyCafe Server, e a aba Visão geral mostra a linha como ativa.
  • Uma estação na rede da lan house abre uma página da web.
  • Configurações > Gateway mostra o gateway como conectado.

Pronto, a instalação terminou. Tudo o que vem depois é trabalho do dia a dia e fica na página Internet.


A página do próprio gateway

A página em que você entrou no Passo 5 continua útil depois da instalação. Ela é uma porta de entrada quando o HandyCafe Server não consegue iniciar ou não alcança o gateway: ver o estado, refazer a configuração de rede, ler o registro, baixar um arquivo de diagnóstico para o suporte, reiniciar o gateway, trocar a senha. Todo o resto continua no HandyCafe Server.

A página só é servida para o próprio PC do gateway. Outra máquina da sua rede não recebe nada, nem mesmo um formulário de login.


Se a senha for perdida

No PC do gateway, abra um Prompt de Comando como administrador e execute estes três comandos, um depois do outro:

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

A conta volta para admin / handycafe. Entre com ela e defina sua própria senha de novo, na página do gateway e em Configurações > Gateway. Enquanto o gateway estiver parado, a lan house fica sem internet. Não há como fazer isso pela rede, e isso é proposital.


Mudando o gateway para outro PC

Instale-o no novo PC e conecte o Server ao novo endereço. Depois, desinstale-o do PC antigo ou pelo menos pare o serviço: dois gateways distribuindo endereços na mesma rede vão brigar por ela.