Jak przeprowadzić migrację ze starszej instalacji
Ten przewodnik importuje istniejące dane ze starszej instalacji HandyCafe V3 lub V4 do nowoczesnego serwera HandyCafe. Migracja nie niszczy źródła: oryginalne pliki nie są modyfikowane ani usuwane.
Migracja bazy danych działa tylko na Windows. Obsługa czasu wykonywania dla starszych klientów do łączenia się przez oryginalny protokół działa na każdej platformie (zobacz Ustawienia starszych klientów).
Co będzie potrzebne
- Komputer z Windows z zainstalowaną zarówno starszą wersją, jak i nowoczesnym serwerem HandyCafe na tym samym systemie lub dostęp do pliku bazy danych starszej wersji.
- Dostęp administracyjny do serwera HandyCafe.
- Zatrzymany serwer starszej wersji. Źródłowa baza danych nie powinna być aktywnie zapisywana podczas migracji.
- Wolne miejsce na dysku co najmniej równe rozmiarowi bazy danych starszej wersji (na nową kopię bazy danych HandyCafe).
- 10 do 30 minut nieprzerwanego czasu. Migracje na dużych zbiorach danych mogą zająć kilka minut. Nie zamykaj HandyCafe podczas działania.
Krok 1: Zatrzymaj serwer starszej wersji
Otwórz aplikację serwera HandyCafe starszej wersji. Zatrzymaj wszystkie sesje i zamknij aplikację. Jeśli serwer starszej wersji działa jako usługa Windows, zatrzymaj usługę z services.msc.
Oczekiwany wynik: Proces serwera starszej wersji nie działa. Plik bazy danych nie jest otwarty.
Krok 2: Otwórz stronę ustawień starszych klientów
- Uruchom HandyCafe.
- Otwórz Ustawienia w pasku bocznym.
- Kliknij Starsze Klienty.
- Przewiń do sekcji Migracja Bazy Danych.
Oczekiwany wynik: Jeśli system wykryje starszą instalację, strona wyświetli ścieżkę instalacji, ścieżkę bazy danych, wersję serwera i liczbę plików INI. Jeśli nic nie zostanie wykryte, strona powie "Nie wykryto starszej instalacji". W takim przypadku upewnij się, że pliki starszej wersji istnieją w standardowej lokalizacji, takiej jak Program Files\HandyCafe lub C:\HandyCafe.
Krok 3: Przejrzyj wykrytą instalację
Zweryfikuj, czy wykryte wartości odpowiadają znanej instalacji starszej wersji:
| Pole | Co sprawdzić |
|---|---|
| Ścieżka instalacji | Wskazuje na poprawny folder HandyCafe. |
| Ścieżka bazy danych | Wskazuje na plik bazy danych starszej wersji w folderze instalacyjnym. |
| Wersja serwera | Odpowiada wersji twojego serwera starszej wersji (na przykład 3.4.01 lub 4.0.10). |
| Liczba plików INI | Większa niż zero. Zdrowa instalacja ma wiele plików INI dla różnych konfiguracji. |
Jeśli którekolwiek pole jest błędne, zamknij HandyCafe, napraw instalację i otwórz ponownie.
Krok 4: Sprawdź pole kodowania
Przed uruchomieniem migracji potwierdź, że pole Kodowanie w sekcji Protokół Czasu Wykonywania jest ustawione poprawnie dla twoich danych źródłowych. Znajduje się to na tej samej stronie ustawień, wyżej.
| Lokalizacja źródłowa | Zalecane kodowanie |
|---|---|
| Turecki | cp1254 |
| Zachodnioeuropejski (angielski, francuski, niemiecki, hiszpański, włoski, portugalski) | cp1252 |
| Inne | cp1254 (serwer akceptuje to jako domyślną rezerwę) |
Jeśli zmienisz kodowanie, kliknij Zapisz przed kontynuowaniem.
Oczekiwany wynik: Źródłowe ciągi znaków zostaną poprawnie zdekodowane podczas migracji, co zapobiega wynikowi completed_with_warnings.
Krok 5: Rozpocznij migrację
- Kliknij Rozpocznij migrację.
- Otwiera się modal postępu. Wyświetla bieżącą fazę i liczbę przetworzonych wierszy.
- Nie zamykaj HandyCafe ani nie usypiaj komputera.
- Poczekaj na zakończenie. Małe zbiory danych kończą się w mniej niż minutę. Większe zbiory mogą zająć 5 do 10 minut.
Oczekiwany wynik: Modal postępu zamyka się, a status zmienia się na completed lub completed_with_warnings. Pojawia się powiadomienie potwierdzające przebieg.
Krok 6: Przejrzyj zaimportowane liczby
Po zakończeniu strona wyświetla zaimportowane liczby rekordów:
| Liczba | Znaczenie |
|---|---|
| Członkowie | Zaimportowane rekordy klientów. |
| Cenniki | Zaimportowane tabele cenowe i wpisy harmonogramu. |
| Produkty | Zaimportowane wpisy katalogu produktów. |
| Zamówienia | Zaimportowane historyczne zamówienia. |
| Transakcje | Zaimportowane wpisy księgi. |
| Logi | Zaimportowane logi audytu i ostrzeżeń. |
| Ostrzeżenia | Rekordy, które zostały pominięte podczas importu. Pojawia się tylko, gdy status to completed_with_warnings. |
Kliknij rozwijacz Szczegóły, aby zobaczyć pełny podział. Zweryfikuj, czy liczby wyglądają rozsądnie w porównaniu do twoich oczekiwań.
Oczekiwany wynik: Wszystkie cztery kategorie (członkowie, produkty, zamówienia, transakcje) pokazują liczby większe niż zero, jeśli twoje źródło miało dane w tych tabelach.
Krok 7: Obsłuż ostrzeżenia (jeśli występują)
Jeśli status to completed_with_warnings, rozwiń listę ostrzeżeń i przejrzyj pominięte rekordy.
Typowe ostrzeżenia i ich rozwiązania:
| Ostrzeżenie | Przyczyna | Rozwiązanie |
|---|---|---|
| Błąd dekodowania kodowania | Tekst źródłowy zawiera bajty, które nie dekodują się w skonfigurowanym kodowaniu. | Uruchom Cofnięcie, zmień pole Kodowanie, aby dopasować do lokalizacji źródłowej, i ponownie uruchom migrację. |
| Nieprawidłowa data | Rekord starszej wersji ma nieprawidłowy znacznik czasu (na przykład 0000-00-00). |
Są one bezpiecznie pomijane. Nie jest wymagana żadna akcja. |
| Zduplikowany klucz | Rekord z tym samym identyfikatorem już istnieje w HandyCafe. | Jeśli była to niezamierzona druga migracja, uruchom Cofnięcie i ponownie uruchom. Jeśli łączysz bazy danych, zaakceptuj pominięcie. |
Oczekiwany wynik: Albo akceptujesz ostrzeżenia jako znane, akceptowalne straty, albo naprawiasz podstawowy problem i ponownie uruchamiasz.
Krok 8: Sprawdź zaimportowane dane
Przed wycofaniem serwera starszej wersji ręcznie zweryfikuj próbkę każdego typu rekordu.
- Otwórz Członkowie w pasku bocznym. Wyszukaj członka, którego znasz z systemu starszej wersji. Potwierdź imię, saldo i dane kontaktowe.
- Otwórz Ustawienia > Cenniki. Potwierdź, że stawki godzinowe odpowiadają harmonogramowi starszej wersji.
- Otwórz Produkty. Potwierdź nazwy i ceny produktów.
- Otwórz Raport Kasowy dla ostatniego dnia historycznego. Potwierdź, że sumy odpowiadają temu, czego oczekujesz z systemu starszej wersji.
Oczekiwany wynik: Losowe próbki odpowiadają źródłu starszej wersji. Jeśli konkretny rekord jest błędny, zanotuj problem. Drobne różnice w formatowaniu są normalne. Duże rozbieżności sugerują problem z kodowaniem lub integralnością danych, który warto zbadać przed uruchomieniem na żywo.
Krok 9: Włącz obsługę czasu wykonywania dla starszych klientów (opcjonalnie)
Jeśli chcesz, aby twoje istniejące maszyny klienckie V3 lub V4 nadal się łączyły podczas przejścia, włącz teraz protokół czasu wykonywania.
- Przewiń do góry strony ustawień Starszych Klientów.
- Przełącz Włącz obsługę starszych klientów na włączone.
- Potwierdź, że porty nasłuchu (UDP 710, TCP 712, transfer plików 717) nie kolidują z niczym innym w twojej sieci.
- Kliknij Zapisz.
Oczekiwany wynik: Starsi klienci w sieci LAN pojawiają się w Panelu Administracyjnym w ciągu 5 do 10 sekund. Zobacz Starsze Klienty, aby dowiedzieć się, jak nimi zarządzać z poziomu panelu.
Jak cofnąć migrację
Jeśli migracja przyniosła nieoczekiwane wyniki, możesz ją całkowicie cofnąć. Oryginalna baza danych starszej wersji pozostaje nietknięta.
- Otwórz Ustawienia > Starsze Klienty.
- Przewiń do sekcji Migracja Bazy Danych.
- Kliknij Cofnij Migrację.
- Potwierdź w dialogu.
Każdy zaimportowany wiersz jest usuwany z HandyCafe. Status wraca do nigdy. Możesz wtedy naprawić podstawowy problem (kodowanie, czyszczenie danych źródłowych itp.) i ponownie uruchomić Rozpocznij Migrację.
Jak ponownie uruchomić migrację
Ponowne uruchomienie zastępuje zaimportowane dane świeżymi danymi ze źródła.
- Otwórz Ustawienia > Starsze Klienty.
- Kliknij Ponownie uruchom migrację (przycisk zmienia nazwę z Rozpocznij Migrację po pierwszym zakończonym przebiegu).
- Przebieg jest identyczny jak przy pierwszym uruchomieniu.
Ponowne uruchomienie jest bezpieczne do użycia tyle razy, ile potrzebujesz. Nie duplikuje danych, ponieważ zastępuje istniejące wyniki migracji.
Typowe błędy do uniknięcia
- Uruchamianie migracji, gdy serwer starszej wersji jest aktywny. Źródłowa baza danych może być zablokowana lub zawierać częściowe zapisy. Zawsze najpierw zatrzymaj serwer starszej wersji.
- Ignorowanie pola Kodowanie. Uruchomienie z niewłaściwym kodowaniem uszkadza nazwy członków i wiadomości logów. Naprawienie tego po fakcie wymaga Cofnięcia i ponownego uruchomienia.
- Zamykanie HandyCafe podczas migracji. Przebieg jest przerwany i częściowe dane są zapisywane. Odzyskanie wymaga Cofnięcia. Zawsze pozwól, aby modal postępu zakończył się.
- Pomijanie kroku sprawdzania próbek. Zaufanie do liczby rekordów bez weryfikacji danych próbnych pomija subtelne problemy, takie jak niezgodności lokalizacji lub błędy zaokrągleń.
- Usuwanie instalacji starszej wersji zbyt wcześnie. Zachowaj pliki źródłowe przez co najmniej jeden pełny cykl płatności po migracji. Jeśli na miesięcznym raporcie pojawi się rozbieżność, możesz odwołać się do oryginalnych rekordów.
- Migracja bez kopii zapasowej. Skopiuj folder instalacyjny starszej wersji przed pierwszą migracją. Chociaż źródło nie jest modyfikowane przez migrację, mogą wystąpić problemy z dyskiem lub wypadki. Kopia zapasowa to tanie ubezpieczenie.