Ustawienia Klientów Legacy
HandyCafe działa równolegle z starszymi instalacjami klienckimi V3 i V4 bez zakłóceń. Strona ustawień Klientów Legacy kontroluje Runtime Protocol: nasłuchy sieciowe, które pozwalają klientom V3 i V4 łączyć się z tym serwerem na ich oryginalnych portach.
Importowanie danych z starszej instalacji jest osobnym zadaniem na własnej stronie ustawień. Zobacz Migracja danych. Te dwie funkcje są niezależne. Obsługa w czasie wykonywania działa bez migracji jakichkolwiek danych. Migracja działa bez obsługi w czasie wykonania. Możesz także używać obu funkcji jednocześnie.
Sekcja Protokół w Czasie Rzeczywistym
Włącz Wsparcie dla Klientów Legacy
Główny przełącznik na górze sekcji. Po włączeniu serwer uruchamia trzy nasłuchiwacze sieciowe:
- Nasłuchiwacz UDP na skonfigurowanej grupie multicast.
- Nasłuchiwacz poleceń TCP na
UDP port + 2. - Nasłuchiwacz transferu plików TCP na
UDP port + 7.
Wyłączenie przełącznika zatrzymuje wszystkie trzy nasłuchiwacze jednocześnie. Możesz dostosować numery portów lub kodowanie, gdy są wyłączone, a następnie ponownie włączyć, aby zastosować zmiany.
Pola Konfiguracyjne
| Pole | Domyślna wartość | Opis |
|---|---|---|
| Klucz Autoryzacji | HANDYCAFE | Wspólny klucz 10-znakowy. Każda przychodząca i wychodząca ramka zawiera ten ciąg. Ramki, które nie pasują, są odrzucane. Wszyscy Twoi klienci legacy muszą używać tego samego klucza. |
| IP Multicast UDP | 230.4.4.46 | Grupa multicast używana do sygnałów odkrywania klientów i do przesyłania poleceń opartych na UDP. Zakodowana na stałe w większości starszych wersji klientów. |
| Port UDP Serwera | 710 | Port UDP, na którym serwer nasłuchuje sygnałów i poleceń klientów. Klienci legacy wysyłają na ten port. |
| Port UDP Klienta | 711 | Port UDP, na którym nasłuchują klienci legacy. Serwer wysyła polecenia zarządzania unicast na ten port na odkrytym IP klienta. |
| Kodowanie | cp1254 | Kodowanie znaków dla pól ciągów w formacie przewodowym. Użyj cp1254 dla instalacji tureckich, cp1252 dla zachodnioeuropejskich. Nieznane wartości wracają do cp1254 z ostrzeżeniem w logu serwera. |
| Wersja Serwera | 3.4.01 | Ciąg wersji nadawany w każdym sygnale UDP. Niektórzy klienci legacy odrzucają ramki z wersji, których nie rozpoznają. Ustaw to, aby pasowało do ciągu wersji Twojego oryginalnego serwera. |
| Wariant Protokołu | STE | Wybór formatu przewodowego. Zobacz porównanie wariantów poniżej. |
| Limit Czasu Nieaktywności | 10 | Sekundy. Nadzór na MAC. Jeśli w tym czasie nie nadejdzie żaden ruch od klienta, klient jest oznaczany jako offline. Przerwa 10 sekund jest odpowiednia dla klientów legacy, które wysyłają sygnały co 2 lub 3 sekundy. |
Porty Pochodne
Poniżej formularza strona wyświetla linię tylko do odczytu, która pokazuje pochodne porty TCP:
Port Poleceń TCP: 712 Port Transferu Plików: 717
Te porty są obliczane na podstawie portu serwera UDP. Nie konfigurujesz ich osobno. Jeśli zmienisz Port UDP Serwera na inną wartość, porty pochodne zmienią się wraz z nim.
Wariant Protokołu
Pole Wariant Protokołu wybiera format przewodowy używany przez serwer. Wybierz wariant, który pasuje do tego, jak zbudowany był Twój serwer legacy.
| Wariant | Kiedy używać |
|---|---|
| STE (Smart/Turbo Edition) | Nowoczesna baza kodu legacy. Dodaje 70-bajtowy prefiks informacji o licencji do struktury ramki. Rozmiar ramki to 1337 bajtów. Wybierz to, jeśli Twoja instalacja legacy używała edycji Smart lub Turbo. |
| Standard | Zwykła podstawowa wersja legacy. Rozmiar ramki to 1267 bajtów bez prefiksu informacji o licencji. Wybierz to tylko, jeśli Twoja instalacja legacy była edycją Standard bez rejestracji licencji. |
Wybranie niewłaściwego wariantu powoduje odrzucenie lub błędne odczytanie ramek. Objawy obejmują klientów pojawiających się online, ale ignorujących każde polecenie lub dane poleceń przesunięte o 70-bajtowy offset.
Współistnienie z Nowoczesnymi Klientami
Porty legacy (710, 711, 712, 717) są całkowicie oddzielone od nowoczesnych portów protokołu HandyCafe (TCP 5001, 5002, 5003, UDP 5004). Oba stosy protokołów działają jednocześnie bez konfliktu. Możesz mieszać starych i nowych klientów w tej samej sieci LAN i zarządzać nimi z tego samego Panelu Administracyjnego.
Zastosowanie Zmian
Każde pole w sekcji Protokół w Czasie Rzeczywistym jest zapisywane przy użyciu globalnego przycisku Zapisz na dole strony. Po zapisaniu serwer:
- Zatrzymuje trzy nasłuchiwacze legacy, jeśli były uruchomione.
- Waliduje klucz autoryzacji (nie może być pusty).
- Buduje nowe konfiguracje nasłuchiwaczy z zaktualizowanych pól.
- Uruchamia ponownie nasłuchiwacze jednocześnie.
- Wywołuje powiadomienie, gdy wszystkie trzy są ponownie online.
Jeśli port jest już używany przez inny proces, serwer zgłasza błąd, a przełącznik wraca do pozycji wyłączonej. Sprawdź swoją zaporę i inne usługi za pomocą netstat i wybierz wolny zakres portów.
Database Migration
Importowanie danych z instalacji HandyCafe 3.x lub 4.x nie odbywa się już na tej stronie. Można to zrobić na stronie ustawień Migracja danych w sekcji HandyCafe Legacy, obok importerów EveryCafe i Pancafe.
Strona ta zawiera informacje na temat wykrywania starej instalacji, co zostaje zaimportowane, gwarancji tylko do odczytu na plikach źródłowych, ponownego uruchamiania importu oraz jego cofania. Szczegółowy przewodnik krok po kroku znajdziesz w artykule Jak przeprowadzić migrację ze starszej instalacji.
Wskazówki
- Zatrzymaj serwer legacy przed uruchomieniem migracji. Jeśli system legacy nadal zapisuje do swojej bazy danych, import może zobaczyć nieaktualne lub częściowe dane.
- Dopasuj pole Kodowanie do swojego lokalnego ustawienia legacy przed pierwszą migracją. Zmiana po zaimportowaniu danych nie naprawi już uszkodzonych nazw.
- Zawsze najpierw przeprowadź testową migrację. Sprawdź liczniki rekordów w "Ostatnie Liczniki" i przejrzyj kilka wierszy członków i transakcji przed zaangażowaniem personelu w nowy system.
- Włącz wsparcie w czasie rzeczywistym i utrzymuj połączenie swoich klientów legacy przez okres przejściowy. To pozwala zweryfikować, że nowy serwer obsługuje ich identycznie, zanim wycofasz stary serwer.
- Jeśli zmienisz Port UDP Serwera, pamiętaj, że pochodne porty poleceń i transferu plików zmieniają się wraz z nim. Zasady zapory muszą być odpowiednio zaktualizowane.