Impostazioni Client Legacy
HandyCafe funziona insieme alle installazioni dei client più vecchie V3 e V4 senza interruzioni. La pagina delle impostazioni dei Client Legacy controlla il Runtime Protocol: i listener di rete che permettono ai client V3 e V4 di connettersi a questo server sulle loro porte originali.
L'importazione dei dati da un'installazione più vecchia è un'attività separata nella sua pagina delle impostazioni. Vedi Migrazione dei Dati. Le due funzionalità sono indipendenti. Il supporto runtime funziona senza dover migrare alcun dato. Una migrazione funziona senza il supporto runtime. Puoi anche usarle entrambe insieme.
Sezione Protocollo Runtime
Abilita Supporto Client Legacy
Un interruttore principale in cima alla sezione. Quando attivo, il server avvia tre listener di rete:
- Un listener UDP sul gruppo multicast configurato.
- Un listener di comando TCP su
UDP port + 2. - Un listener di trasferimento file TCP su
UDP port + 7.
Disattivando l'interruttore si fermano tutti e tre i listener in modo atomico. Puoi regolare i numeri di porta o la codifica mentre sono disabilitati, quindi riattivare per applicare le modifiche.
Campi di Configurazione
| Campo | Predefinito | Descrizione |
|---|---|---|
| Chiave Auth | HANDYCAFE | Una chiave condivisa di 10 caratteri. Ogni frame in entrata e in uscita trasporta questa stringa. I frame che non corrispondono vengono scartati. Tutti i tuoi client legacy devono usare la stessa chiave. |
| IP Multicast UDP | 230.4.4.46 | Il gruppo multicast utilizzato per i beacon di scoperta dei client e per l'invio di comandi basati su UDP. Codificato nella maggior parte delle build client legacy. |
| Porta UDP Server | 710 | La porta UDP su cui il server ascolta i beacon e i comandi dei client. I client legacy inviano a questa porta. |
| Porta UDP Client | 711 | La porta UDP su cui i client legacy ascoltano. Il server invia comandi di gestione unicast a questa porta sull'IP del client scoperto. |
| Codifica | cp1254 | Codifica dei caratteri per i campi stringa nel formato wire. Usa cp1254 per installazioni turche, cp1252 per quelle dell'Europa occidentale. Valori sconosciuti ricadono su cp1254 con un avviso nel log del server. |
| Versione Server | 3.4.01 | La stringa di versione trasmessa in ogni beacon UDP. Alcuni client legacy rifiutano frame da versioni che non riconoscono. Imposta questo valore per corrispondere alla stringa di versione del tuo server originale. |
| Variante Protocollo | STE | Selezione del formato wire. Vedi il confronto delle varianti sotto. |
| Timeout Inattività | 10 | Secondi. Un watchdog per MAC. Se non arriva traffico da un client entro questo intervallo, il client viene segnato come offline. Un intervallo di 10 secondi è appropriato per i client legacy che inviano beacon ogni 2 o 3 secondi. |
Porte Derivate
Sotto il modulo, la pagina mostra una riga di sola lettura che indica le porte TCP derivate:
Porta Comando TCP: 712 Porta Trasferimento File: 717
Queste porte sono calcolate dalla porta UDP del server. Non le configuri separatamente. Se cambi la Porta UDP Server a un valore diverso, le porte derivate si spostano di conseguenza.
Variante Protocollo
Il campo Variante Protocollo seleziona il formato wire utilizzato dal server. Scegli la variante che corrisponde a come è stato costruito il tuo server legacy.
| Variante | Quando Usarla |
|---|---|
| STE (Smart/Turbo Edition) | Il moderno codice legacy. Aggiunge un prefisso di informazioni sulla licenza di 70 byte alla struttura del frame. La dimensione del frame è di 1337 byte. Scegli questa opzione se la tua installazione legacy utilizzava l'edizione Smart o Turbo. |
| Standard | La build legacy di base. La dimensione del frame è di 1267 byte senza il prefisso delle informazioni sulla licenza. Scegli questa opzione solo se la tua installazione legacy era un'edizione Standard senza registrazione della licenza. |
Scegliere la variante sbagliata provoca il drop o la lettura errata dei frame. I sintomi includono client che appaiono online ma ignorano ogni comando, o dati di comando spostati di 70 byte.
Coesistenza con Client Moderni
Le porte legacy (710, 711, 712, 717) sono completamente separate dalle porte del protocollo moderno di HandyCafe (TCP 5001, 5002, 5003, UDP 5004). Entrambi gli stack di protocollo funzionano simultaneamente senza conflitti. Puoi mescolare client vecchi e nuovi sulla stessa LAN e gestirli dallo stesso Pannello Amministrativo.
Applicazione delle Modifiche
Ogni campo nella sezione Protocollo Runtime viene salvato con il pulsante Salva globale in fondo alla pagina. Al salvataggio, il server:
- Ferma i tre listener legacy se erano in esecuzione.
- Valida la chiave auth (non deve essere vuota).
- Costruisce nuove configurazioni di listener dai campi aggiornati.
- Riavvia i listener contemporaneamente.
- Invia una notifica quando tutti e tre sono di nuovo online.
Se una porta è già in uso da un altro processo, il server segnala un errore e l'interruttore torna a off. Controlla il tuo firewall e altri servizi con netstat e scegli un intervallo di porte libero.
Database Migration
L'importazione dei dati da un'installazione HandyCafe 3.x o 4.x non avviene più su questa pagina. Si trova sulla pagina delle impostazioni Migrazione dei Dati sotto la fonte HandyCafe Legacy, accanto agli importatori EveryCafe e Pancafe.
Quella pagina copre il rilevamento della vecchia installazione, cosa viene importato, la garanzia di sola lettura sui file sorgente, come ripetere un'importazione e annullarne una. Per una guida passo-passo vedere Come Migrare da un'Installazione Legacy.
Consigli
- Ferma il server legacy prima di eseguire una migrazione. Se il sistema legacy sta ancora scrivendo nel suo database, l'importazione potrebbe vedere dati obsoleti o parziali.
- Abbina il campo Codifica alla tua localizzazione legacy prima della prima migrazione. Cambiarlo dopo che i dati sono stati importati non correggerà retroattivamente i nomi già corrotti.
- Esegui sempre una migrazione di prova prima. Controlla i conteggi dei record sotto "Ultimi Conteggi" e verifica alcuni record di membri e transazioni prima di impegnare il personale nel nuovo sistema.
- Abilita il supporto runtime e mantieni i tuoi client legacy connessi per un periodo di transizione. Questo ti permette di verificare che il nuovo server li serva in modo identico prima di ritirare il vecchio server.
- Se cambi la Porta UDP Server, ricorda che le porte derivate di comando e trasferimento file si spostano con essa. Le regole del firewall devono essere aggiornate di conseguenza.