Cara Instalasi
Versi saat ini menggunakan format restore backup untuk deployment. Pada versi mendatang, kami mungkin akan beralih ke format migrasi inkremental, untuk memudahkan integrasi solusi ke sistem yang sudah ada.
Plugin Backup Manager kini open-source: plugin "Backup Manager" yang dibutuhkan untuk me-restore solusi kini sudah open-source dan tersedia untuk semua versi (termasuk Community). Kami menyarankan untuk me-restore langsung melalui plugin ini.
Sebelum memulai, pastikan:
- Anda sudah memiliki lingkungan NocoBase yang berjalan. Untuk instalasi sistem utama, silakan merujuk ke dokumentasi instalasi resmi yang lebih detail.
- Versi NocoBase v2.1.0-beta.2 atau lebih tinggi
- Anda telah mengunduh file backup untuk sistem CRM: nocobase_crm_v2_backup_260523.nbdata
Catatan Penting:
- Solusi ini dibuat berdasarkan database PostgreSQL 16, pastikan lingkungan Anda menggunakan PostgreSQL 16.
- DB_UNDERSCORED tidak boleh true: Periksa file
docker-compose.ymlAnda, pastikan environment variableDB_UNDERSCOREDtidak diatur ketrue, jika tidak akan konflik dengan backup solusi dan menyebabkan kegagalan restore.
Restore dengan Backup Manager
Metode ini menggunakan plugin "Backup Manager" bawaan NocoBase untuk restore satu klik, paling sederhana untuk dilakukan. Plugin ini kini sudah open-source dan tersedia untuk semua versi (termasuk Community).
Karakteristik Inti
- Kelebihan:
- Mudah dioperasikan: Dapat diselesaikan melalui antarmuka UI, dapat me-restore semua konfigurasi termasuk Plugin secara lengkap.
- Restore lengkap: Dapat me-restore semua file sistem, termasuk file Template print, file yang diupload di field file di tabel, dll., memastikan kelengkapan fungsi.
- Keterbatasan:
- Persyaratan lingkungan ketat: Membutuhkan lingkungan database Anda (versi, pengaturan case sensitivity, dll.) yang sangat kompatibel dengan lingkungan saat backup dibuat.
- Ketergantungan Plugin: Jika solusi mengandung Plugin komersial yang tidak ada di lingkungan lokal Anda, restore akan gagal.
Langkah-langkah Operasi
Langkah 1: [Sangat Disarankan] Gunakan image full untuk menjalankan aplikasi
Untuk menghindari kegagalan restore karena tidak ada client database, kami sangat menyarankan Anda menggunakan Docker image versi full. Image ini sudah berisi semua program pendukung yang diperlukan, sehingga Anda tidak perlu konfigurasi tambahan.
Contoh perintah pull image:
Lalu gunakan image ini untuk menjalankan layanan NocoBase Anda.
Catatan: Jika tidak menggunakan image
full, Anda mungkin perlu menginstal client databasepg_dumpsecara manual di dalam container, prosesnya rumit dan tidak stabil.
Langkah 2: Aktifkan Plugin "Backup Manager"
- Login ke sistem NocoBase Anda.
- Masuk ke
Plugin Management. - Cari dan aktifkan Plugin
Backup Manager.
Langkah 3: Restore dari File Backup Lokal
- Setelah plugin diaktifkan, refresh halaman.
- Masuk ke menu kiri
System Management->Backup Manager. - Klik tombol
Restore from Local Backupdi pojok kanan atas. - Drag file backup yang sudah diunduh ke area upload.
- Klik
Submit, tunggu dengan sabar hingga sistem menyelesaikan restore, proses ini dapat memakan waktu beberapa puluh detik hingga beberapa menit.
Perhatian
- Kompatibilitas Database: Ini adalah hal paling penting dalam metode ini. Versi, character set, pengaturan case sensitivity PostgreSQL Anda harus cocok dengan file sumber backup. Khususnya nama
schemaharus sama. - Pencocokan Plugin Komersial: Pastikan Anda sudah memiliki dan mengaktifkan semua Plugin komersial yang dibutuhkan oleh solusi, jika tidak restore akan terhenti.
FAQ
Apakah versi Pro dapat digunakan? Apakah akan error?
Dapat langsung digunakan, tidak akan error. Demo menggunakan beberapa Plugin Enterprise (seperti email manager, audit log, dll.), saat versi Pro kekurangan Plugin ini, entry point fungsi yang sesuai tidak akan ditampilkan, tetapi tidak akan memengaruhi fungsi lain dari sistem. Misalnya entry email akan menghilang, tetapi modul inti seperti Lead, Peluang, Pesanan akan berfungsi normal.
Versi mana yang harus dipilih setelah restore?
Direkomendasikan menggunakan image versi beta-full terbaru (seperti nocobase/nocobase:beta-full). Image full sudah berisi dependency seperti client database, menghindari kegagalan saat restore karena tidak ada tool.
Logo tidak ditampilkan setelah restore?
Logo Demo di situs resmi memiliki batasan domain, domain lokal tidak dapat memuatnya. Masuk ke System Settings dan upload Logo Anda sendiri.
Bagaimana dengan upgrade inkremental?
Saat ini upgrade versi adalah penggantian penuh, modifikasi kustom akan ditimpa. Pastikan untuk backup sebelum upgrade. Solusi migrasi inkremental sedang direncanakan, akan diprioritaskan untuk Pro/Enterprise. Community sulit didukung sementara karena tidak memiliki plugin migration management.
Semoga tutorial ini membantu Anda men-deploy sistem CRM 2.0 dengan lancar. Jika Anda mengalami masalah dalam proses operasi, jangan ragu untuk menghubungi kami!
Last updated: 2026-04-02

