Lewati ke konten
HNROS Pusat Bantuan
Bahasa Indonesia
Mulai gratis
Daftar isiDi mana dan siapa yang menggunakanSebelum memulaiLangkah 1 — Pemeriksaan FirebirdSQLLangkah 2 — Berkas sumberSiapkan cadangan UTF-8 dan hubungkan / Uji koneksiLangkah 3 — Inventaris tabel dan opsiLangkah 4 — Migrasi dan kemajuanLangkah 5 — Hasil dan rekonsiliasiPanel pemeliharaanKesalahan yang sering munculDi Linux

Migrasi data dari program lama (Firebird): Pengaturan › Migrasi data

Data program lama Anda (FirebirdSQL) — kartu pelanggan dan stok, faktur, surat jalan, cek, resep, gambar, dan dokumen — dipindahkan ke HNR setelah Anda masuk, melalui bagian Pengaturan › Migrasi data (dari program lama). Wizard Pengaturan Awal tidak lagi memindahkan data. Bagian ini hanya terlihat oleh administrator sistem; di ponsel (antarmuka Taman + Langkah) alur yang sama dibuka langkah demi langkah.

Buat perusahaan terlebih dahulu dengan wizard: data dipindahkan ke perusahaan yang sudah ada; bagian ini tidak membuat perusahaan baru. Buat cadangan perusahaan tujuan sebelum migrasi. Basis data program lama hanya dibaca: tidak satu baris pun berubah selama migrasi.

Di mana dan siapa yang menggunakan

Pengaturan › Migrasi data (dari program lama). Bagian ini hanya dilihat dan digunakan oleh administrator sistem; pengguna tanpa izin Administrator melihat pesan “Impor data hanya untuk administrator sistem.” Jika server dalam mode hanya-baca (gerbang tulis tertutup), migrasi tidak dimulai.

Tombol “Impor data dari perusahaan lama” di wizard Pengaturan Awal tidak lagi memindahkan data; tombol itu hanya menampilkan catatan informasi: buat perusahaan terlebih dahulu, lalu setelah masuk buka Pengaturan › Migrasi data.

Di ponsel (antarmuka Taman + Langkah) bagian yang sama dibuka langkah demi langkah: setiap langkah adalah layar tersendiri, tombolnya cukup besar untuk diketuk dengan nyaman, dan tabel tampil sebagai kartu.

Sebelum memulai

Langkah 1 — Pemeriksaan FirebirdSQL

Saat halaman dibuka, halaman memeriksa apakah FirebirdSQL terpasang di komputer ini, apakah berjalan, dan versinya. Data program lama dibaca dengan FirebirdSQL di komputer ini: server-nya adalah komputer ini (localhost), port 3050 (atau nilai RemoteServicePort di firebird.conf jika diubah saat pemasangan), dan penggunanya SYSDBA. Semua itu tidak ditanyakan; hanya kata sandi yang diminta.

SituasiYang harus dilakukan
Belum terpasang. Layar menampilkan “Pasang FirebirdSQL terlebih dahulu.” dan Anda tidak dapat melanjutkan.Pasang FirebirdSQL 3.0, 4.0, atau 5.0 dari tautan “Halaman unduhan FirebirdSQL” (firebirdsql.org) dengan pengaturan bawaan (port 3050, SYSDBA); lalu tekan “Periksa ulang”.
Terpasang tetapi layanannya tidak berjalan. Peringatan juga menampilkan versi dan port.Buka Layanan (Services) Windows dan jalankan layanan “Firebird Server - DefaultInstance”; lalu tekan “Periksa ulang”.
Versi tidak didukung. Muncul peringatan “Versi FirebirdSQL ini tidak didukung”.Pasang FirebirdSQL 3.0, 4.0, atau 5.0.
Siap. Bingkai hijau menampilkan “FirebirdSQL terpasang dan berjalan”, lengkap dengan versi, localhost:port, dan SYSDBA.Lanjut ke langkah 2 dengan “Lanjutkan”.

Langkah ini juga menampilkan peringatan “Buat cadangan perusahaan tujuan sebelum mengimpor.” Jika migrasi pernah dijalankan sebelumnya, tombol “Tampilkan hasil impor terakhir” membuka hasil tersebut.

Langkah 2 — Berkas sumber

Tombol Pilih berkas membuka jendela buka berkas Windows. Pilih cadangan (.FBK) atau basis data (.FDB) program lama; ekstensi .BAK dan .GDB juga diterima. Berkas dengan jenis lain ditolak (KAYNAK_DOSYA_TURU).

Untuk EK1 (basis data gambar dan dokumen; misalnya HESAP_EK1.FBK atau HESAP.FDB_EK1.FBK) tidak ada pilihan kedua: berkas ini ditemukan otomatis di folder yang sama, dan di bawah pilihan Anda tertulis “EK1 ditemukan”. Jika tidak ditemukan, muncul peringatan “EK1 tidak ditemukan, hanya berkas utama yang akan diimpor (gambar dan dokumen tidak diimpor)”; letakkan EK1 di folder yang sama dengan berkas utama lalu pilih berkas itu lagi.

Saat HNR berjalan sebagai layanan Windows, berkas dipilih melalui jendela pemilih berkas milik peramban. Dalam kasus itu, pilih berkas EK1 bersama berkas utama (dengan tombol Ctrl) di jendela yang sama. Berkas yang dipilih disalin, dengan indikator persen, ke folder migrasi di komputer ini (aktarim\kaynak); berkas asli tidak disentuh.

Jalan pintas untuk berkas besar: untuk cadangan berukuran beberapa GB, salin dulu berkas utama dan berkas EK1 ke folder migrasi di komputer ini (aktarim\kaynak; jalur lengkapnya tertulis di bawah tombol sebelum berkas dipilih), lalu pilih hanya berkas utama dengan Pilih berkas. Berkas dengan nama dan ukuran yang sama yang sudah ada di folder tidak disalin lagi; layar menampilkan “Berkas sudah ada di folder impor; tidak disalin lagi.” dan EK1 ditemukan otomatis di folder yang sama. Berkas besar yang diunggah dari peramban dikirim per bagian.

Setelah memilih berkas, hanya kata sandi SYSDBA yang dimasukkan. SYSDBA / masterkey adalah nilai awal Firebird; jika kata sandi diubah saat Firebird dipasang, masukkan kata sandi Anda sendiri.

Siapkan cadangan UTF-8 dan hubungkan / Uji koneksi

Jika Anda memilih cadangan (.FBK), tombolnya menjadi Siapkan cadangan UTF-8 dan hubungkan. Cadangan dibuka di server (“Memulihkan cadangan…”), dikonversi ke UTF-8, dan isinya diverifikasi (“Konversi UTF-8 dan verifikasi isi…”); kemajuan ditampilkan dengan jumlah tabel dan baris. Salinan yang lolos verifikasi dipakai sebagai sumber, dan cadangan asli tetap utuh. Pekerjaan ini membutuhkan ruang disk kosong sekitar 4 kali ukuran cadangan.

Jika Anda memilih basis data (.FDB), tombolnya menjadi Uji koneksi: tombol ini menyambung ke sumber dan menampilkan versi, jumlah tabel, serta apakah EK1 ditemukan. Jika berhasil, tertulis “Terhubung · versi … · … tabel” dan tombol Baca inventaris menjadi aktif.

Langkah 3 — Inventaris tabel dan opsi

Baca inventaris menampilkan semua tabel di sumber; tidak ada yang dilewati secara diam-diam. Setiap tabel datang dengan salah satu dari empat keputusan:

KeputusanArtinya
objekKartu/dokumen dibuat dari tabel dan disimpan melalui jalur tulis perusahaan sendiri (mis. MUSTERI → kartu pelanggan).
salinJika tabel dengan nama yang sama ada di tujuan, kolom yang sama disalin baris demi baris.
turunanTidak disalin: nilai seperti saldo pelanggan dan stok tersedia dibuat ulang oleh jalur tulis.
lewatiTabel sistem atau log.

Opsi migrasi ditetapkan pada langkah yang sama:

Nomor dokumen dipertahankan: nomor faktur, cek, dan bukti di sumber tetap sama persis di tujuan. Jika sumber yang sama dimigrasikan untuk kedua kalinya, tidak ada catatan ganda yang ditulis; yang sudah ada dilewati.

Langkah 4 — Migrasi dan kemajuan

Mulai impor memulai migrasi di server. Layar menampilkan tahap, persentase, dan waktu berjalan, jumlah kartu/dokumen/tertulis/dilewati/gagal per tabel, jumlah berkas, serta baris terakhir log migrasi; jika mesin memakai beberapa thread, jumlah dan rinciannya juga ditampilkan.

Migrasi berjalan di server: pekerjaan tidak berhenti meskipun Anda menutup jendela ini atau peramban. Saat Anda membuka halaman lagi, migrasi yang sedang berjalan ditemukan dan kemajuannya ditampilkan. Hentikan menghentikan pekerjaan dan menampilkan “Impor dihentikan.”

Langkah 5 — Hasil dan rekonsiliasi

Saat migrasi selesai, tertulis “Impor selesai.” dan tabel rekonsiliasi membandingkan sumber dengan tujuan: saldo pelanggan, stok tersedia, cek, faktur, resep, dan berkas. Setiap baris menampilkan item, sumber, tujuan, selisih, dan status (Cocok / Penyimpangan / Penyimpangan yang diketahui); hasil per tabel, durasi, contoh kesalahan baris, dan jumlah koreksi otomatis juga ditampilkan.

Jika rekonsiliasi menunjukkan penyimpangan, layar menampilkan “Impor selesai — TETAPI rekonsiliasi menunjukkan penyimpangan.” dan mencantumkan ukuran yang menyimpang. Periksa tabel rekonsiliasi sebelum memakai perusahaan hasil migrasi; Anda dapat mengambil laporan sebagai PDF dengan tombol Laporan rekonsiliasi sistem lama · PDF, atau mencetaknya dengan Cetak.

Contoh baris yang menimbulkan kesalahan dicantumkan di bawah “Contoh kesalahan baris”; jika migrasi tidak dapat diselesaikan, lihat log migrasi untuk rinciannya.

Panel pemeliharaan

Panel Pemeliharaan di bawah langkah 2 menyediakan dua operasi:

Kesalahan yang sering muncul

Pesan kesalahan menampilkan rincian dari server dan, dalam tanda kurung, sebuah kode kesalahan; misalnya “Alat persiapan cadangan belum dikonfigurasi di server. — gbak/gfix not found (KAYNAK_HAZIRLIK_AYAR)”. Sebutkan kode tersebut saat menghubungi dukungan.

KodeArti dan solusi
FIREBIRD_KURULU_DEGIL“FirebirdSQL tidak terpasang di komputer ini.” Pasang FirebirdSQL 3.0, 4.0, atau 5.0 lalu tekan “Periksa ulang”.
FIREBIRD_CALISMIYORFirebirdSQL terpasang tetapi servernya tidak berjalan. Jalankan layanan “Firebird Server - DefaultInstance” dari Layanan Windows lalu periksa ulang.
KAYNAK_KIMLIK“Nama pengguna atau kata sandi database sumber ditolak.” Masukkan lagi kata sandi SYSDBA; jika kata sandi diubah saat Firebird dipasang, masukkan kata sandi itu (bawaan masterkey).
KAYNAK_HAZIRLIK_AYAR“Alat persiapan cadangan belum dikonfigurasi di server.” Jika rinciannya berbunyi gbak/gfix not found, FirebirdSQL belum terpasang; jika berbunyi Firebird server not running, jalankan layanan Firebird. Periksa pemasangan dan layanannya lalu coba lagi; jika berlanjut, teruskan kode ke tim dukungan.
KAYNAK_HAZIRLIK_DISK“Ruang disk tidak cukup untuk memulihkan cadangan dan membuat salinan UTF-8.” Kosongkan ruang sekitar 4 kali ukuran cadangan pada disk tempat folder migrasi berada, lalu coba lagi.
KAYNAK_YEDEK_GECERSIZ“Berkas bukan cadangan Firebird FBK/BAK yang valid.” Berkas mungkin rusak atau berjenis lain; buat ulang cadangan dari program lama lalu pilih, atau pilih berkas FDB.
KAYNAK_DOSYA_TURU“Hanya berkas basis data atau cadangan Firebird yang dapat dipilih (.fbk, .fdb, .bak, .gdb).” Pilih berkas dengan ekstensi yang sesuai; jangan memilih berkas EK1 sebagai berkas utama.
HEDEF_DOLU“Perusahaan tujuan sudah berisi data.” Jika perusahaan sudah pernah dipakai, membuat perusahaan baru lebih aman; jika Anda sengaja melanjutkan, buat cadangan terlebih dahulu dan centang “Lanjutkan meski tujuan sudah berisi data” pada langkah 3.

Hanya satu migrasi yang dapat berjalan dalam satu perusahaan pada satu waktu (“Impor data sedang berjalan untuk perusahaan ini.”). Jika server dalam mode hanya-baca (“Gerbang tulis nonaktif: server sedang hanya-baca”), migrasi tidak dimulai.

Di Linux

FirebirdSQL dipasang dari pengelola paket distribusi Anda atau dari firebirdsql.org. Alat gbak dan gfix harus ada di PATH atau di bawah /opt/firebird; langkah selanjutnya sama seperti di Windows.

Panduan terkait: Pemasangan, Pengaturan, Pembersihan data.

Panduan terkait