Configurações de Clientes Legados
HandyCafe opera juntamente com instalações mais antigas dos clientes V3 e V4 sem interrupções. A página de configurações dos Clientes Legados controla o Runtime Protocol: os listeners de rede que permitem aos clientes V3 e V4 se conectarem a este servidor em suas portas originais.
Importar dados de uma instalação mais antiga é uma tarefa separada em sua própria página de configurações. Veja Migração de Dados. As duas funcionalidades são independentes. O suporte de tempo de execução funciona sem migrar nenhum dado. Uma migração funciona sem suporte de tempo de execução. Você também pode usar ambos juntos.
Seção do protocolo em tempo de execução
Ativar suporte a clientes legados
Um alternador principal no topo da seção. Quando ativado, o servidor inicia três listeners de rede:
- Um listener UDP no grupo multicast configurado.
- Um listener TCP de comandos em
porta UDP + 2. - Um listener TCP de transferência de arquivos em
porta UDP + 7.
Desativar o alternador interrompe os três listeners de forma atômica. Você pode ajustar números de porta ou a codificação enquanto ele estiver desligado e depois reativar para aplicar as mudanças.
Campos de configuração
| Campo | Padrão | Descrição |
|---|---|---|
| Chave de autenticação | HANDYCAFE | Uma chave compartilhada de 10 caracteres. Cada quadro de entrada e saída carrega essa string. Quadros que não coincidirem são descartados. Todos os clientes legados devem usar a mesma chave. |
| IP multicast UDP | 230.4.4.46 | O grupo multicast usado para beacons de descoberta do cliente e para o despacho de comandos via UDP. Na maioria das compilações legadas, esse valor é fixo no código. |
| Porta UDP do servidor | 710 | Porta UDP na qual o servidor escuta beacons e comandos dos clientes. Os clientes legados enviam para esta porta. |
| Porta UDP do cliente | 711 | Porta UDP na qual os clientes legados escutam. O servidor envia comandos de gerenciamento unicast para esta porta no IP do cliente descoberto. |
| Codificação | cp1254 | Codificação de caracteres para os campos de string do formato de rede. Use cp1254 para instalações turcas e cp1252 para europeias ocidentais. Valores desconhecidos voltam para cp1254 com um aviso no log do servidor. |
| Versão do servidor | 3.4.01 | A string de versão transmitida em cada beacon UDP. Alguns clientes legados rejeitam quadros de versões que não reconhecem. Ajuste para corresponder à versão do seu servidor original. |
| Variante de protocolo | STE | Seleção do formato de rede. Veja a comparação de variantes abaixo. |
| Tempo limite de inatividade | 10 | Segundos. Um watchdog por MAC. Se nenhum tráfego chegar de um cliente dentro dessa janela, o cliente é marcado como offline. Uma folga de 10 segundos funciona bem para clientes legados que enviam beacons a cada 2 ou 3 segundos. |
Portas derivadas
Abaixo do formulário, a página mostra uma linha somente leitura com as portas TCP derivadas:
Porta TCP de comandos: 712 Porta de transferencia de arquivos: 717
Essas portas são calculadas a partir da porta UDP do servidor. Elas não são configuradas separadamente. Se você mudar a Porta UDP do Servidor para outro valor, as portas derivadas acompanham essa mudança.
Variante de protocolo
O campo Variante de protocolo seleciona o formato de rede usado pelo servidor. Escolha a variante que corresponde à forma como seu servidor legado foi construído.
| Variante | Quando usar |
|---|---|
| STE (Smart/Turbo Edition) | A base de código legada mais moderna. Adiciona um prefixo de informações de licença de 70 bytes à estrutura do quadro. O tamanho do quadro é 1337 bytes. Use esta opção se sua instalação legada era das edições Smart ou Turbo. |
| Standard | A compilação legada básica. O tamanho do quadro é 1267 bytes sem o prefixo de informações de licença. Use esta opção apenas se sua instalação legada era uma edição Standard sem registro de licença. |
Escolher a variante errada faz com que quadros sejam descartados ou lidos incorretamente. Os sintomas incluem clientes aparecendo online, mas ignorando todos os comandos, ou dados de comando deslocados pelo offset de 70 bytes.
Coexistência com clientes modernos
As portas legadas (710, 711, 712, 717) são completamente separadas das portas do protocolo moderno do HandyCafe (TCP 5001, 5002, 5003, UDP 5004). As duas pilhas de protocolo rodam ao mesmo tempo sem conflito. Você pode misturar clientes antigos e novos na mesma LAN e gerenciá-los pelo mesmo Painel Administrativo.
Aplicando as mudanças
Cada campo da seção Protocolo em tempo de execução é salvo com o botão global Salvar na parte inferior da página. Ao salvar, o servidor:
- Interrompe os três listeners legados se eles estiverem em execução.
- Valida a chave de autenticação (não pode estar vazia).
- Monta novas configurações de listener a partir dos campos atualizados.
- Reinicia os listeners em paralelo.
- Dispara uma notificação quando os três voltarem a ficar online.
Se uma porta já estiver em uso por outro processo, o servidor mostra um erro e o alternador volta para desligado. Verifique firewall e outros serviços com netstat e escolha uma faixa de portas livre.
Migração de Banco de Dados
A importação de dados de uma instalação HandyCafe 3.x ou 4.x não ocorre mais nesta página. Ela está localizada na página de configurações de Migração de Dados sob a fonte HandyCafe Legacy, juntamente com os importadores EveryCafe e Pancafe.
Essa página cobre a detecção da instalação antiga, o que é importado, a garantia de somente leitura nos arquivos de origem, a reexecução de uma importação e seu desfazer. Para um passo-a-passo, veja Como Migrar de uma Instalação Legada.
Dicas
- Pare o servidor legado antes de executar uma migração. Se o sistema legado ainda estiver gravando no banco, a importação pode enxergar dados antigos ou parciais.
- Ajuste o campo Codificação para a localidade do seu legado antes da primeira migração. Alterar isso depois que os dados já foram importados não corrige nomes que já tenham sido corrompidos.
- Sempre rode primeiro uma migração de teste. Confira as contagens em "Contagens finais" e revise algumas linhas de membros e transações antes de liberar a equipe para o novo sistema.
- Habilite o suporte em tempo de execução e mantenha seus clientes legados conectados durante o período de transição. Isso permite verificar se o novo servidor os atende da mesma forma antes de aposentar o servidor antigo.
- Se você mudar a Porta UDP do Servidor, lembre-se de que as portas derivadas de comando e transferência de arquivos também mudam. As regras de firewall precisam ser atualizadas de acordo.