Eski Bir Kurulumdan Nasıl Taşınır

Bu rehber, mevcut verilerinizi eski bir HandyCafe V3 veya V4 kurulumundan modern bir HandyCafe sunucusuna aktarır. Taşıma, kaynak için yıkıcı değildir: özgün dosyalar değiştirilmez veya silinmez.

Veritabanı taşıması yalnızca Windows'ta çalışır. Eski istemcilerin orijinal protokol üzerinden bağlanabilmesi için çalışma zamanı desteği her platformda çalışır (bkz. Eski İstemciler Ayarları).

Gerekecekler

• Hem eski kurulumun hem de modern HandyCafe sunucusunun aynı sistemde bulunduğu bir Windows makine veya eski veritabanı dosyasına erişim.
• HandyCafe Server'a yönetici erişimi.
• Durdurulmuş eski sunucu. Taşıma sırasında kaynak veritabanına aktif yazım yapılmamalıdır.
• Yeni HandyCafe veritabanı kopyası için eski veritabanı boyutuna en az eşit boş disk alanı.
• 10 ila 30 dakika kesintisiz zaman. Büyük veri kümelerinde taşıma birkaç dakika sürebilir. Çalışma sırasında HandyCafe'yi kapatmayın.

1. Adım: Eski Sunucuyu Durdurun

Eski HandyCafe sunucu uygulamasını açın. Tüm oturumları durdurun ve uygulamadan çıkın. Eski sunucu Windows servisi olarak çalışıyorsa servisi services.msc içinden durdurun.

Beklenen sonuç: Eski sunucu süreci artık çalışmıyordur. Veritabanı dosyası açık tutulmaz.

2. Adım: Eski İstemciler Ayarları Sayfasını Açın

1. HandyCafe'yi başlatın.
2. Kenar çubuğundan Settings bölümünü açın.
3. Legacy Clients öğesine tıklayın.
4. Database Migration bölümüne gidin.

Beklenen sonuç: Sistem bir eski kurulum algılarsa sayfa kurulum yolunu, veritabanı yolunu, sunucu sürümünü ve INI dosyası sayısını gösterir. Bir şey algılanmazsa sayfada "No legacy installation detected." yazar. Bu durumda eski dosyaların Program Files\\HandyCafe veya C:\\HandyCafe gibi standart bir konumda bulunduğunu doğrulayın.

3. Adım: Algılanan Kurulumu İnceleyin

Algılanan değerlerin bildiğiniz eski kurulumla eşleştiğini doğrulayın:

Herhangi bir alan yanlışsa HandyCafe'yi kapatın, kurulumu düzeltin ve yeniden açın.

4. Adım: Encoding Alanını Kontrol Edin

Taşıma işleminden önce, Runtime Protocol bölümündeki Encoding alanının kaynak veriniz için doğru ayarlandığından emin olun. Bu alan aynı ayar sayfasında daha yukarıdadır.

Kodlamayı değiştirirseniz devam etmeden önce Save'e tıklayın.

Beklenen sonuç: Kaynak dizeler taşıma sırasında temiz şekilde çözümlenir ve bu da completed_with_warnings sonucundan kaçınmanıza yardımcı olur.

5. Adım: Taşımayı Başlatın

1. Start Migration düğmesine tıklayın.
2. Bir ilerleme penceresi açılır. Geçerli aşamayı ve o ana kadar işlenen satır sayısını gösterir.
3. HandyCafe'yi kapatmayın veya bilgisayarı uykuya almayın.
4. Bitmesini bekleyin. Küçük veri kümeleri bir dakikadan kısa sürede tamamlanır. Büyük veri kümeleri 5 ila 10 dakika sürebilir.

Beklenen sonuç: İlerleme penceresi kapanır ve durum completed ya da completed_with_warnings olur. Çalışmanın tamamlandığını bildiren bir bildirim görünür.

6. Adım: Taşınan Sayıları İnceleyin

Tamamlandığında sayfa taşınan kayıt sayılarını gösterir:

Tam dökümü görmek için Details açılır bölümüne tıklayın. Sayıların beklentilerinize göre makul görünüp görünmediğini doğrulayın.

Beklenen sonuç: Kaynak tablolarında veri varsa dört ana kategori de (members, products, orders, transactions) sıfır olmayan sayılar gösterir.

7. Adım: Uyarıları Ele Alın (Varsa)

Durum completed_with_warnings ise uyarılar listesini genişletin ve atlanan kayıtları inceleyin.

Yaygın uyarılar ve çözümleri:

Beklenen sonuç: Ya uyarıları kabul edilebilir kayıplar olarak kabul edersiniz ya da altta yatan sorunu giderip işlemi yeniden çalıştırırsınız.

8. Adım: İçe Aktarılan Verileri Örnekleyin

Eski sunucuyu emekliye ayırmadan önce her kayıt türünden bir örnek el ile doğrulayın.

1. Kenar çubuğunda Members bölümünü açın. Eski sistemden bildiğiniz bir üyeyi arayın. Adı, bakiyeyi ve iletişim bilgilerini doğrulayın.
2. Settings > Pricing bölümünü açın. Saatlik ücretlerin eski takvimle eşleştiğini doğrulayın.
3. Products bölümünü açın. Ürün adlarını ve fiyatlarını doğrulayın.
4. Yakın tarihli bir gün için Cash Report açın. Toplamların eski sistemden beklediğinizle eşleştiğini doğrulayın.

Beklenen sonuç: Rastgele örnekler eski kaynakla eşleşir. Belirli bir kayıt yanlışsa not alın. Küçük biçim farkları normaldir. Büyük değer uyuşmazlıkları, canlıya geçmeden önce incelenmesi gereken bir kodlama veya veri bütünlüğü sorunu olduğunu gösterir.

9. Adım: Eski İstemci Çalışma Zamanı Desteğini Etkinleştirin (İsteğe Bağlı)

Mevcut V3 veya V4 istemci makinelerinizin geçiş sürecinde bağlanmaya devam etmesini istiyorsanız, şimdi çalışma zamanı protokolünü etkinleştirin.

1. Eski İstemciler ayar sayfasının üst kısmına gidin.
2. Enable Legacy Client Support anahtarını açın.
3. Dinleyici portlarının (UDP 710, TCP 712, file transfer 717) ağınızdaki başka hiçbir şeyle çakışmadığını doğrulayın.
4. Kaydet'e tıklayın.

Beklenen sonuç: LAN'daki eski istemciler 5 ila 10 saniye içinde Admin Panel'de görünür. Onları panelden nasıl yöneteceğiniz için Eski İstemciler sayfasına bakın.

Taşımayı Geri Alma

Taşıma beklenmedik sonuçlar verdiyse, onu tamamen geri alabilirsiniz. Orijinal eski veritabanı etkilenmez.

1. Settings > Legacy Clients bölümünü açın.
2. Database Migration bölümüne gidin.
3. Undo Migration düğmesine tıklayın.
4. İletişim kutusunda onaylayın.

Taşınan her satır HandyCafe'den silinir. Durum never olarak geri döner. Ardından alttaki sorunu (kodlama, kaynak veri temizliği vb.) düzeltebilir ve Start Migration'ı tekrar çalıştırabilirsiniz.

Taşımayı Yeniden Çalıştırma

Yeniden çalıştırma, taşınan verileri kaynaktan alınan yeni verilerle değiştirir.

1. Settings > Legacy Clients bölümünü açın.
2. Re-run Migration düğmesine tıklayın (ilk başarılı çalıştırmadan sonra düğme etiketi Start Migration'dan değişir).
3. Akış ilk çalıştırmayla aynıdır.

Re-run, gerektiği kadar kullanmak için güvenlidir. Mevcut taşıma çıktısını değiştirdiği için veri çoğaltmaz.

Kaçınılması Gereken Yaygın Hatalar

• Eski sunucu aktifken taşıma çalıştırmak. Kaynak veritabanı kilitli olabilir veya yarım kalmış yazımlar içerebilir. Önce eski sunucuyu mutlaka durdurun.
• Encoding alanını önemsememek. Yanlış kodlama ile çalıştırmak üye adlarını ve günlük mesajlarını bozar. Bunu sonradan düzeltmek Undo ve Re-run gerektirir.
• Taşıma sırasında HandyCafe'yi kapatmak. Çalışma kesilir ve kısmi veri yazılır. Kurtarma için Undo gerekir. İlerleme penceresinin tamamlanmasına her zaman izin verin.
• Örnekleme adımını atlamak. Kayıt sayılarına güvenip örnek verileri doğrulamamak, yerel ayar uyuşmazlıkları veya yuvarlama hataları gibi ince sorunları kaçırmanıza neden olur.
• Eski kurulumu çok erken silmek. Taşıma sonrası en az bir tam ödeme döngüsü boyunca kaynak dosyaları saklayın. Aylık raporda fark ortaya çıkarsa özgün kayıtlara başvurabilirsiniz.
• Yedek almadan taşımak. İlk taşımadan önce eski kurulum klasörünü kopyalayın. Kaynak taşıma ile değiştirilmez, ancak disk sorunları veya kazalar olabilir. Yedek ucuz bir sigortadır.