Lewati ke konten utama

Mentransfer Pengguna Antar FASTPANEL

Pendahuluan​

Artikel ini menjelaskan proses transfer akun pengguna dan data terkaitnya (situs web, basis data, email, dll.) dari satu server FASTPANEL ke server lainnya menggunakan utilitas migrasi bawaan.

Istilah Utama​

  • Server sumber - Server asal data ditransfer.
  • Server tujuan - Server tempat data ditransfer.

Catatan Penting​

  • Secara default, migrasi hanya berfungsi dengan benar untuk situs dengan konfigurasi FASTPANEL standar.

  • Situs dengan perubahan konfigurasi manual hanya dapat ditransfer jika flag -m digunakan untuk pemetaan alamat IP.

  • Jika kata sandi terenkripsi untuk pemilik basis data tidak tersedia, basis data tidak akan ditransfer.

  • Jika sebuah situs web tidak ditransfer, basis data terkaitnya juga tidak akan ditransfer.

  • Hanya basis data lokal yang dapat ditransfer.

Proses Migrasi​

Koneksi​

Server tujuan terhubung ke server sumber melalui SSH. Saat koneksi pertama, server tujuan memasang kunci SSH di server sumber (baik yang telah disediakan sebelumnya atau yang dibuat dari kata sandi).

Langkah Migrasi​

  • Instalasi modul
  • Mengumpulkan informasi tentang objek yang dapat ditransfer
  • Membuat pengguna
  • Mentransfer sertifikat SSL
  • Membuat situs web, akun FTP, domain email, dan akun email
  • Membuat basis data dan pengguna basis data
  • Mentransfer file situs web dan kotak surat email
  • Mentransfer tugas cron

Transfer file dijalankan menggunakan rsync. Basis data ditransfer dengan membuat dump melalui tunnel SSH.

Perintah untuk Memulai Migrasi​

Perintah dijalankan di server tujuan sebagai pengguna dengan hak akses root:

/usr/local/fastpanel2/fastpanel transfer run [SSH_PARAMETERS] [IP_PARAMETERS] [ADDITIONAL_OPTIONS]

Flag Baris Perintah​

Koneksi SSH​

  • --remote_host="SOURCE_IP" - Alamat IP server sumber.
  • --remote_port="SSH_PORT" - Port SSH.
  • --remote_username="SSH_USER" - Pengguna (harus root).
  • --remote_password="USER_PASSWORD" - Kata sandi untuk pengguna SSH yang ditentukan.
  • --ssh_key_path="PATH_TO_KEY" - Jalur ke kunci SSH privat di server tujuan untuk terhubung ke server sumber. Jika kunci digunakan, kata sandi (--remote_password) tidak diperlukan.

Alamat IP​

Anda harus menggunakan hanya satu dari flag berikut untuk mengelola alamat IP situs selama transfer. Flag -m memiliki prioritas.

  • -i "IP_ADDRESS_ON_DESTINATION" - Menetapkan alamat IP yang ditentukan ke semua situs yang ditransfer di server tujuan. Untuk menentukan beberapa IP (misalnya, jika ada beberapa di sumber), ulangi flag untuk setiap IP sumber yang perlu ditransfer.

  • -m "SOURCE_IP,DESTINATION_IP" - Metode yang direkomendasikan. Membuat pemetaan langsung: semua situs yang menggunakan SOURCE_IP di server sumber akan menggunakan DESTINATION_IP di server tujuan. Flag ini dapat ditentukan beberapa kali untuk pasangan IP yang berbeda. Wajib untuk mentransfer situs dengan pengeditan konfigurasi manual, karena memungkinkan penggantian alamat IP yang benar dalam directive listen.

Pengaturan Tambahan​

  • --users="USER_LIST" - Hanya mentransfer pengguna yang ditentukan (dipisahkan dengan koma). Jika tidak ditentukan, semua pengguna akan ditransfer.
  • --disable_disk_quota - Menonaktifkan transfer kuota disk pengguna.
  • --with_user_data - Termasuk penyalinan seluruh isi direktori home pengguna (kecuali subdirektori logs/). Gunakan dengan hati-hati, karena ini dapat meningkatkan waktu transfer dan jumlah data yang ditransfer secara signifikan.
  • --only_data - Hanya mentransfer data (file situs web, file email, dump basis data). Berguna jika migrasi struktur awal (pengguna, situs, DB, dll.) berhasil, tetapi terjadi kesalahan selama tahap penyalinan file atau dump. Memungkinkan untuk menjalankan ulang hanya bagian penyalinan data.
  • --transfer_timeout - Menetapkan batas waktu operasi (default adalah 60 menit).

Contoh Perintah​

Transfer semua pengguna dari server 11.22.33.44 ke server saat ini. Di server lama, situs menggunakan IP 11.22.33.44 dan 11.22.33.55; di server baru, masing-masing harus menggunakan 99.88.77.66 dan 99.88.77.67. Koneksi melalui SSH dengan kata sandi.

/usr/local/fastpanel2/fastpanel transfer run \
--remote_host=11.22.33.44 \
--remote_username=root \
--remote_password=YourSourceRootPassword \
-m 11.22.33.44,99.88.77.66 \
-m 11.22.33.55,99.88.77.67

Kemungkinan Masalah dan Jenis Kesalahan​

Kesalahan dalam log migrasi tidak selalu menunjukkan masalah kritis, tetapi dapat mengarah pada alasan mengapa objek tertentu tidak ditransfer.

  • Konflik: Terjadi ketika transfer suatu objek tidak mungkin dilakukan karena konfigurasi server tujuan saat ini (misalnya, pengguna atau situs dengan nama yang sama sudah ada) atau jika konfigurasi situs di server sumber tidak dikenali oleh panel (misalnya, karena pengeditan manual yang ekstensif).

  • Kata Sandi Tersimpan Hilang: Seperti disebutkan sebelumnya, pengguna basis data MySQL tanpa kata sandi yang tersimpan di FASTPANEL pada server sumber tidak dapat ditransfer.

  • Pengaturan Manual dan Alamat IP: Jika sebuah situs di server sumber memiliki pengeditan konfigurasi server web manual dan flag -m tidak digunakan selama migrasi untuk memetakan alamat IP-nya, situs tersebut tidak akan ditransfer karena panel tidak mengetahui IP mana yang harus ditentukan dalam konfigurasi di server tujuan.