Configuración de Clientes Legacy
HandyCafe se ejecuta junto con instalaciones de clientes más antiguas de V3 y V4 sin interrupciones. La página de configuración de Clientes Legacy controla el Runtime Protocol: los oyentes de red que permiten a los clientes V3 y V4 conectarse a este servidor en sus puertos originales.
La importación de datos desde una instalación anterior es un trabajo separado en su propia página de configuración. Ver Migración de Datos. Las dos características son independientes. El soporte de tiempo de ejecución funciona sin migrar ningún dato. Una migración funciona sin soporte de tiempo de ejecución. También puede usar ambos juntos.
Sección de Protocolo en Tiempo de Ejecución
Habilitar Soporte para Clientes Legacy
Un interruptor maestro en la parte superior de la sección. Cuando está activado, el servidor inicia tres escuchas de red:
- Un escucha UDP en el grupo de multidifusión configurado.
- Un escucha de comandos TCP en
UDP port + 2. - Un escucha de transferencia de archivos TCP en
UDP port + 7.
Apagar el interruptor detiene los tres escuchas de manera atómica. Puedes ajustar los números de puerto o la codificación mientras está desactivado, luego volver a habilitar para aplicar los cambios.
Campos de Configuración
| Campo | Predeterminado | Descripción |
|---|---|---|
| Clave de Autenticación | HANDYCAFE | Una clave compartida de 10 caracteres. Cada trama entrante y saliente lleva esta cadena. Las tramas que no coinciden se descartan. Todos tus clientes legacy deben usar la misma clave. |
| IP de Multidifusión UDP | 230.4.4.46 | El grupo de multidifusión utilizado para balizas de descubrimiento de clientes y para el envío de comandos basados en UDP. Codificado en la mayoría de las versiones de clientes legacy. |
| Puerto UDP del Servidor | 710 | El puerto UDP en el que el servidor escucha las balizas y comandos de los clientes. Los clientes legacy envían a este puerto. |
| Puerto UDP del Cliente | 711 | El puerto UDP en el que los clientes legacy escuchan. El servidor envía comandos de gestión unicast a este puerto en la IP del cliente descubierto. |
| Codificación | cp1254 | Codificación de caracteres para campos de cadena en formato de transmisión. Usa cp1254 para instalaciones en Turquía, cp1252 para Europa Occidental. Los valores desconocidos vuelven a cp1254 con una advertencia en el registro del servidor. |
| Versión del Servidor | 3.4.01 | La cadena de versión transmitida en cada baliza UDP. Algunos clientes legacy rechazan tramas de versiones que no reconocen. Establece esto para que coincida con la cadena de versión de tu servidor original. |
| Variante de Protocolo | STE | Selección de formato de transmisión. Ver la comparación de variantes a continuación. |
| Tiempo de Inactividad | 10 | Segundos. Un watchdog por MAC. Si no llega tráfico de un cliente dentro de este intervalo, el cliente se marca como desconectado. Un intervalo de 10 segundos es apropiado para clientes legacy que envían balizas cada 2 o 3 segundos. |
Puertos Derivados
Debajo del formulario, la página muestra una línea de solo lectura que muestra los puertos TCP derivados:
Puerto de Comando TCP: 712 Puerto de Transferencia de Archivos: 717
Estos puertos se calculan a partir del puerto UDP del servidor. No los configuras por separado. Si cambias el Puerto UDP del Servidor a un valor diferente, los puertos derivados se mueven con él.
Variante de Protocolo
El campo Variante de Protocolo selecciona el formato de transmisión utilizado por el servidor. Elige la variante que coincida con cómo se construyó tu servidor legacy.
| Variante | Cuándo Usar |
|---|---|
| STE (Smart/Turbo Edition) | La base de código legacy moderna. Agrega un prefijo de información de licencia de 70 bytes a la estructura de la trama. El tamaño de la trama es de 1337 bytes. Elige esto si tu instalación legacy usó la edición Smart o Turbo. |
| Estándar | La construcción legacy básica y sencilla. El tamaño de la trama es de 1267 bytes sin el prefijo de información de licencia. Elige esto solo si tu instalación legacy era una edición Estándar sin registro de licencia. |
Elegir la variante incorrecta provoca que las tramas se descarten o se lean incorrectamente. Los síntomas incluyen clientes que aparecen en línea pero ignoran cada comando, o datos de comandos desplazados por el offset de 70 bytes.
Coexistencia con Clientes Modernos
Los puertos legacy (710, 711, 712, 717) están completamente separados de los puertos de protocolo modernos de HandyCafe (TCP 5001, 5002, 5003, UDP 5004). Ambas pilas de protocolos funcionan simultáneamente sin conflicto. Puedes mezclar clientes antiguos y nuevos en la misma LAN y gestionarlos desde el mismo Panel de Administración.
Aplicación de Cambios
Cada campo en la sección de Protocolo en Tiempo de Ejecución se guarda con el botón Guardar global en la parte inferior de la página. Al guardar, el servidor:
- Detiene los tres escuchas legacy si estaban en funcionamiento.
- Valida la clave de autenticación (no debe estar vacía).
- Construye nuevas configuraciones de escucha a partir de los campos actualizados.
- Reinicia los escuchas de manera concurrente.
- Lanza una notificación cuando los tres están de nuevo en línea.
Si un puerto ya está en uso por otro proceso, el servidor informa un error y el interruptor vuelve a apagarse. Verifica tu firewall y otros servicios con netstat y elige un rango de puertos libre.
Migración de Bases de Datos
La importación de datos desde una instalación de HandyCafe 3.x o 4.x ya no se realiza en esta página. Se encuentra en la página de configuración de Migración de Datos bajo la fuente HandyCafe Legacy, junto con los importadores de EveryCafe y Pancafe.
Esa página cubre la detección de la antigua instalación, lo que se importa, la garantía de solo lectura en los archivos fuente, volver a ejecutar una importación y deshacerla. Para una guía paso a paso, consulte Cómo Migrar desde una Instalación Antigua.
Consejos
- Detén el servidor legacy antes de ejecutar una migración. Si el sistema legacy sigue escribiendo en su base de datos, la importación puede ver datos obsoletos o parciales.
- Asegúrate de que el campo de Codificación coincida con tu configuración regional legacy antes de la primera migración. Cambiarlo después de que los datos hayan sido importados no corregirá retroactivamente los nombres ya corruptos.
- Siempre realiza una migración de prueba primero. Verifica los conteos de registros bajo "Últimos Conteos" y revisa algunas filas de miembros y transacciones antes de comprometer al personal al nuevo sistema.
- Habilita el soporte en tiempo de ejecución y mantén tus clientes legacy conectados durante un período de transición. Esto te permite verificar que el nuevo servidor los atiende de manera idéntica antes de retirar el servidor antiguo.
- Si cambias el Puerto UDP del Servidor, recuerda que los puertos derivados de comando y transferencia de archivos se mueven con él. Las reglas del firewall necesitan actualizarse en consecuencia.