Mengatasi Masalah Error You must enter a relative path Pada WHM Backup

Halo Sobat JN, Saat mengkonfigurasi backup di WHM (Web Host Manager), Anda mungkin pernah menemui pesan error yang cukup membingungkan: “You must enter a relative path.” Pesan ini seringkali muncul ketika Anda mencoba menentukan direktori tujuan backup, terutama jika Anda secara intuitif memasukkan path yang dimulai dengan garis miring /, seperti /backup atau /mnt/backup. WHM dengan tegas menolak path seperti ini dan meminta Anda untuk memasukkan “relative path”. Lantas, apa sebenarnya yang dimaksud dengan “relative path” dalam konteks WHM backup ini? Dan bagaimana cara mengatasi error ini agar backup WHM Anda dapat berjalan dengan lancar, bahkan jika Anda ingin menyimpan backup di direktori level atas server?

Memahami “Relative Path” dalam Konteks WHM Backup: Tanpa Garis Miring di Depan

Pesan error “You must enter a relative path.” sebenarnya cukup jelas, namun mungkin konsep “relative path” tidak selalu dipahami oleh semua pengguna. Dalam konteks konfigurasi backup WHM, “relative path” berarti path direktori tujuan backup tidak boleh diawali dengan garis miring /. Path harus dimulai langsung dengan nama folder, dan dianggap relatif terhadap direktori home user sistem yang menjalankan proses backup. Sebagai contoh, path yang benar dan relatif adalah:

• backup
• backup/cpanel
• root/backup
• home/usercpanel/backup

Sedangkan path yang salah dan absolut (atau dianggap tidak relatif oleh WHM) adalah:

• /backup
• /mnt/backup
• /root/backup
• /home/usercpanel/backup

Perhatikan bahwa meskipun /root/backup dan /home/usercpanel/backup adalah path absolut yang valid dalam sistem file Linux, WHM tetap menganggapnya tidak relatif karena diawali dengan garis miring /. WHM mengharapkan path yang benar-benar relatif, seolah-olah Anda sedang berada di direktori home user dan menyebutkan subdirektori di dalamnya.

Mengapa WHM Meminta “Relative Path”? Alasan Desain dan Keamanan

Pembatasan penggunaan path relatif dalam konfigurasi backup WHM bukan tanpa alasan. Ada beberapa pertimbangan desain dan keamanan yang mendasarinya:

1. Konsistensi dan Prediktabilitas: Dengan mengharuskan path relatif, WHM memastikan bahwa lokasi backup selalu berada dalam konteks user sistem yang menjalankan backup. Ini membuat konfigurasi lebih konsisten dan mudah diprediksi, terutama dalam lingkungan server hosting dengan banyak akun cPanel.
2. Keamanan dan Isolasi User: WHM dirancang untuk mengelola banyak akun hosting secara terisolasi. Pembatasan path backup ke path relatif user membantu menjaga keamanan dan mencegah akses yang tidak sah antar akun atau ke sistem file secara keseluruhan. Meskipun proses backup dijalankan oleh WHM (yang memiliki akses root), prinsip isolasi user tetap dipertahankan pada level konfigurasi path.
3. Konvensi dan Kemudahan Penggunaan: Secara konvensi, banyak sistem dan aplikasi Linux menggunakan path relatif dalam konfigurasi untuk alasan fleksibilitas dan portabilitas. WHM mengikuti konvensi ini untuk kemudahan penggunaan dan kompatibilitas dengan praktik standar.

Solusi Efektif: Symbolic Link (Tautan Simbolik) untuk Mengarahkan Backup ke Direktori Level Atas

Meskipun WHM mengharuskan “relative path” tanpa garis miring di depan, bukan berarti Anda terpaksa menyimpan backup di dalam direktori home user. Anda tetap bisa menyimpan backup di direktori level atas seperti /backup atau /mnt/backup dengan menggunakan solusi cerdas: symbolic link atau tautan simbolik. Symbolic link adalah fitur sistem operasi Linux yang memungkinkan Anda membuat “jalan pintas” dari satu direktori ke direktori lain. Dalam kasus ini, kita akan membuat symbolic link di dalam direktori home user root (misalnya /root/backup) yang menunjuk ke direktori tujuan absolut yang Anda inginkan (misalnya /backup). Dengan demikian, saat Anda mengkonfigurasi WHM backup dengan path tujuan root/backup (tanpa garis miring di depan, sehingga dianggap relatif oleh WHM), WHM akan menerima path ini. Namun, berkat symbolic link yang telah kita buat, setiap data backup yang dikirim ke /root/backup akan secara otomatis diarahkan dan disimpan di direktori /backup yang sebenarnya.

Langkah-langkah Implementasi mount –bind Link untuk WHM Backup

Berikut adalah langkah-langkah detail untuk menerapkan solusi symbolic link dan mengatasi error “You must enter a relative path.” pada WHM backup:

1. Akses Server via SSH sebagai Root: Login ke server Anda melalui SSH sebagai user root. Gunakan aplikasi SSH client seperti PuTTY atau Terminal.

   ssh root@alamat_ip_server_anda
   

   Ganti alamat_ip_server_anda dengan alamat IP server Anda dan masukkan password root.
2. Pastikan Direktori Tujuan Absolut Tersedia: Periksa apakah direktori tujuan backup level atas yang Anda inginkan (misalnya /backup) sudah ada. Jika belum, buat direktori tersebut.

   ls -ld /backup
   

   Jika direktori belum ada, buat dengan perintah:

   mkdir -p /backup
   

3. Buat Link: Gunakan perintah mount --bind untuk membuat symbolic link. Sintaksnya adalah:

   mount --bind /backup /root/backup
   

   • ln -s: Perintah untuk membuat symbolic link.
   • /backup: Direktori tujuan absolut di level atas server (lokasi penyimpanan backup sebenarnya).
   • /root/backup: Direktori sumber tautan yang berada di dalam direktori home user root. Ini adalah path relatif yang akan Anda masukkan di konfigurasi WHM (tanpa / di depan).
   Verifikasi pembuatan symbolic link dengan perintah:

   ls -ld /root/backup`
   
   Output yang benar akan menunjukkan `/root/backup` sebagai symbolic link yang menunjuk ke `/backup`, contohnya:
   

   lrwxrwxrwx 1 root root 7 Okt 26 10:00 /root/backup -> /backup

4. Konfigurasi WHM Backup dengan Path Relatif: Login ke WHM dan navigasikan ke pengaturan konfigurasi backup Anda. Pada bagian “Destinasi Backup” atau yang serupa, masukkan root/backup (tanpa garis miring di depan) sebagai direktori tujuan. WHM akan menerima path ini karena dianggap sebagai path relatif yang valid.Proses backup yang berjalan akan mengirim data ke /root/backup, namun berkat symbolic link, data tersebut akan secara otomatis dialihkan dan disimpan di direktori /backup yang sebenarnya.

Keuntungan Menggunakan Symbolic Link

Solusi symbolic link ini memberikan banyak keuntungan:

• Sederhana dan Cepat: Implementasi sangat mudah dan cepat, hanya dengan satu baris perintah.
• Memenuhi Persyaratan WHM: Memenuhi ekspektasi WHM untuk path relatif tanpa garis miring di depan.
• Aman: Tidak melanggar prinsip keamanan WHM.
• Efisien: Symbolic link tidak memakan ruang disk tambahan.
• Fleksibel: Mudah mengubah direktori tujuan absolut jika diperlukan.

Kesimpulan

Error “You must enter a relative path.” pada WHM backup seringkali disebabkan oleh kesalahan dalam memahami konsep path relatif yang diharapkan WHM. Dengan memahami bahwa path harus relatif (tanpa garis miring di depan) dan memanfaatkan symbolic link, Anda dapat dengan mudah mengatasi error ini dan mengarahkan backup WHM ke direktori level atas server Anda atau lokasi penyimpanan eksternal yang diinginkan. Solusi ini tetap menjaga keamanan dan sangat mudah diterapkan. Selamat mencoba, Sobat JN! Jika Anda memiliki pertanyaan lebih lanjut atau mengalami kendala, jangan ragu untuk menghubungi tim support kami.