Cara Mengatasi Error Instalasi cPanel Ubuntu 24.04 – Troubleshooting Lengkap

Eh, pernah gak sih sampeyan lagi semangat-semangatnya mau install cPanel di VPS baru, eh pas proses instalasi udah jalan sekitar sejam, tiba-tiba muncul tulisan merah gede: The background process ‘SQL Databases and dependent apps’ failed with a fatal error: The subprocess reported error number 2 when it ended? Lha, jujur wae, pertama kali tak nemoni error iki, aku langsung garuk-garuk kepala. Server bentar lagi mau production, kok installer-nya malah ambrol. Piye iki carane? Ganti server? Nge-ticket provider? Tenang, sadurunge sampeyan bertindak ekstrem, baca dulu artikel iki – aku bakal share cara mengatasi error instalasi cPanel Ubuntu 24.04 iki secara tuntas.

Tenang, sampeyan ora mung dhewe kok. Kasus iki wis sering banget tak temui neng lapangan, bahkan aku dhewe pernah ngalamin pas lagi set up VPS buat client. Gampange gini: bayangno sampeyan mau masak nasi, tapi ternyata beras sing neng dapur iku wis basi. Ora peduli sehebat apa pun juru masaknya, nek bahan bakune sendiri rusak, hasilnya ya ora bakal mateng. Nah, di kasus iki, ‘bahan baku’-e ya repository APT sing lagi dipake server sampeyan. Kalau bahane apik, masakan mesthi sukses. Kali iki bahan bakune sing bermasalah, lan kita bakal ngurus iku bareng-bareng pelan-pelan.

Masalahe dudu mung sekedar ‘installer-nya error’ terus kelar. Dampak-e lumayan gede: proses instalasi bakal gagal total, sistem dadi setengah matang, lan sing paling menjengkelkan, waktu sampeyan kebuang berjam-jam mung kanggo bolak-balik ngecek log. Nek iki VPS sing lagi dikejar deadline project, wah, bisa-bisa sampeyan nerima telepon ‘apik-apik’ seko atasan. Common causes-e biasane: repository mirror lokal sing ora sinkron utowo ora lengkap pakete, sisa paket MySQL/MariaDB seko instalasi sadurunge sing bentrok, hostname sing durung FQDN, sampe resource server sing kurang. Tapi root cause paling utama neng kasus iki ya masalah repository mirror-e, lan iki sing bakal kita garap paling serius.

Sekarang kita bedah pelan-pelan. Error ‘subprocess reported error number 2’ iku sebenernya cuma cerita neng permukaan. Neng balik layar, angka 2 iku exit code seko dpkg sing gagal ngonfigurasi paket database. Lan dpkg gagal ora mergo server-e jelek, tapi mergo apt neng server sampeyan nyoba install paket seko mirror lokal sing ternyata paket-pakete ilang, versine ora konsisten, utowo index-nya basi. Coba bayangno maneh: mirror lokal iku ibarat warung sing rak-raknya setengah kosong. Sampeyan arep tuku bahan masakan, tapi sawetara barang ora ono. Ujung-ujungnya sampeyan mulih karo tangan kosong, lan panci neng kompor mung dadi pemanas ruangan.

Sing nggawe kasus iki makin menarik, error-e muncul ora neng awal proses, tapi pas tengah-tengah. cPanel iku ngelakoni instalasi liwat sawetara background process. Proses sing jenenge ‘SQL Databases and dependent apps’ iki khusus ngurusi MySQL/MariaDB. Pas dpkg nyerah ngatur pakete, background process iki langsung collapse, lan installer pun ikut berhenti total. Error pamungkase: ‘The system failed to run the /usr/local/cpanel/scripts/cpanel_initial_install script’. Iki dudu bug cPanel, iki kondisi lingkungan sing ora sehat – lan untunge, kabeh iso diperbaiki seko sisi sampeyan. Ing artikel iki, aku bakal nuntun sampeyan pelan-pelan, seko cek log sampe instalasi ulang sukses tanpa hambatan. Siap? Monggo kita mulai.

Gejala Error Instalasi cPanel Ubuntu 24.04 dan Lognya

Sadurunge masuk ke solusi, kita kudu paham dulu kayak apa bentuk musuhe. Secara umum, ana telung lapis error sing bakal sampeyan temoni, lan ketiganya saling berhubungan:

1. Error utama: The background process ‘SQL Databases and dependent apps’ failed with a fatal error: The subprocess reported error number 2 when it ended
2. Error pamungkas: The system failed to run the /usr/local/cpanel/scripts/cpanel_initial_install script
3. Error tersembunyi: Error dpkg/apt sing sebenarnya, sing anyar ketahuan nek kita buka log detail-e

Nah, error nomor 3 iki sing paling penting. Iki contoh log sing bakal sampeyan temu nek sampeyan buka file log instalasi cPanel:

[2026-07-15 03:12:41] Installation step 4 of 18: SQL Databases and dependent apps
[2026-07-15 03:12:41] Running: apt-get install -y mariadb-server mariadb-client
[2026-07-15 03:12:44] E: Unable to locate package mariadb-server
[2026-07-15 03:12:44] E: Package 'mariadb-server' has no installation candidate
[2026-07-15 03:12:45] W: Failed to fetch http://mirror.local.example/ubuntu/dists/noble-updates/main/binary-amd64/Packages.gz 404 Not Found
[2026-07-15 03:12:45] E: Sub-process /usr/bin/dpkg returned an error code (2)
[2026-07-15 03:12:45] E: Unable to correct problems, you have held broken packages.
[2026-07-15 03:12:46] dpkg: error processing package mariadb-server-10.11 (--configure):
[2026-07-15 03:12:46]  installed mariadb-server-10.11 package post-installation script subprocess returned error exit status 2
[2026-07-15 03:12:47] dpkg: dependency problems prevent configuration of mariadb-server:
[2026-07-15 03:12:47]  mariadb-server depends on mariadb-server-core-10.11; however:
[2026-07-15 03:12:47]   Package mariadb-server-core-10.11 is not installed.
[2026-07-15 03:12:48] FATAL: The background process 'SQL Databases and dependent apps' failed with a fatal error: The subprocess reported error number 2 when it ended
[2026-07-15 03:12:48] FATAL: The system failed to run the /usr/local/cpanel/scripts/cpanel_initial_install script

Mari kita trace log iki baris demi baris, soalnya iki inti seko kabeh masalah-e:

• Baris 1-2 (symptom): Installer cPanel memasuki tahap 4 seko 18, lan mulai ngeksekusi apt-get install kanggo paket MariaDB. Iki tahapan sing normal lan harus-e lancar wae.
• Baris 3-4 (pattern mulai katon): apt gagal nemokke paket mariadb-server. Gatekna tembung kunci ‘Unable to locate package’ lan ‘has no installation candidate’. Iki tanda nek index repo neng server ora nduwe paket iku, utowo mirror-e ora lengkap.
• Baris 5 (pattern kedua lan jejak paling penting): apt nyoba fetch index seko http://mirror.local.example/ubuntu/... lan oleh balasan 404 Not Found. Mirror lokal sampeyan ora nduwe file index kanggo suite noble-updates. Iki bukti kuat nek mirror-e durung sinkron utowo setengah jadi.
• Baris 6-7: Mergo fetch gagal, dpkg lan apt nyerah. ‘Unable to correct problems, you have held broken packages’ artine ana paket sing posisine nggantung (broken).
• Baris 8-10: dpkg nyoba ngonfigurasi paket mariadb sing setengah ke-install (seko percobaan sadurunge), nanging gagal mergo dependensi mariadb-server-core-10.11 ora ketemenan. Iki root cause teknis sing sebenarnya: rantai dependensi putus.
• Baris 11-12: Background process ‘SQL Databases’ nyerah, lan installer gagal total karo error pamungkas sing mau.

Dadi polane jelas: symptom (installer gagal neng tahap SQL) -> pattern (apt ora iso fetch index seko mirror lokal) -> root cause (repository mirror lokal ora sinkron utowo ora lengkap, nggawe rantai dependensi MariaDB putus). Nek neng log sampeyan muncul baris kayak ‘404 Not Found’ utowo ‘Unable to locate package’, selamat – sampeyan wis nemokke biang keladine.

Root Cause: Kenapa Error Instalasi cPanel Ubuntu 24.04 Bisa Terjadi?

Biar sampeyan ora mung nuruti instruksi tanpa paham, kita bahas dulu akar masalah-e. cPanel nduwe persyaratan ketat: sistem kudu bersih, ora ana web stack liyane, lan repository kudu bisa diandalkan. Nek sampeyan nganggo mirror APT pihak ketiga (contohe mirror bawaan seko provider hosting, kaya cermin.rumahweb.id utowo mirror lokal liyane), ana sawetara hal sing bisa melenceng:

• Mirror ora sinkron penuh. Mirror lokal biasane disinkronkan seko repo utama secara berkala. Nek proses sinkron-e durung rampung, sebagian arsip lan file index-nya ono sing ilang. Hasile: apt kadang nemu paket, kadang ora, lan sering muncul 404.
• Versi paket ora konsisten. Index sing basi nggawe apt ndeleng versi paket sing wis ora ono maneh neng arsip. Pas dpkg arep ngonfigurasi, dependensi sing dirujuk wis ilang, jadine error exit code 2.
• Paket dibusak seko mirror. Sawetara provider ngethok arsip paket lawas kanggo ngirit bandwidth. Padahal cPanel butuh paket-paket tartamtu sing mungkin wis ke-pangkas iku.

Ditambah maneh loro faktor pendukung: hostname sing durung FQDN nggawe cPanel kadang nolak neruske neng tahap awal, lan resource (RAM/disk) sing kurang nggawe proses apt/dpkg di-kill neng tengah jalan karo OOM killer. Kombinasi seko beberapa faktor iki sing nggawe instalasi gagal total neng tahap SQL Databases. Tenang, solusine jelas, lan kita bakal jalan siji-siji.

Solusi Step-by-Step: Cara Mengatasi Error Instalasi cPanel Ubuntu 24.04

Oke, saiki kita masuk neng bagian sing paling penting: langkah-langkah perbaikane. Ikuti urutane, aja ono sing dilewati. Aku nggawe urut seko diagnosis paling jero sampe eksekusi akhir, soale nek ana langkah sing dilompati, error-e iso muncul maneh. Sakwise sampeyan ngerti masalah-e, eksekusine dadi gampang banget.

Langkah 1: Cek Log Detail untuk Menemukan Error yang Sebenarnya

Pertama, kita kudu ngerti persis ono opo sing salah. Aja tau nebak-nebak. Bukak log instalasi cPanel lan goleki baris error dpkg sing sebenarnya:

ls -la /var/cpanel/updatelogs/
ls -la /var/log/cpanel-install-*.log

Biasane file log sing terbaru ono neng /var/cpanel/updatelogs/ karo format jeneng kayak install.2026-07-15_03.12. Kanggo log install awal cPanel, iso uga ditemoni neng /var/log/ karo prefix cpanel-install-. Cek sing paling anyar:

ls -lat /var/cpanel/updatelogs/ | head -20
ls -lat /var/log/ | grep cpanel-install

Sakwise ketemu, tail file-e lan goleki baris sing ngandhut error:

tail -n 200 /var/cpanel/updatelogs/install.2026-07-15_03.12
grep -iE "error|fatal|fail|404|dpkg" /var/cpanel/updatelogs/install.2026-07-15_03.12

Apa sing kudu digoleki? Baris karo E: utowo FATAL, sarta jejak 404 Not Found seko fetch apt. Nek ketemu 404 Not Found utowo Unable to locate package sing nunjuk URL mirror, maka diagnosis sampeyan wis 90% pasti: masalah repository. Sakwise iki, langsung lanjut neng langkah 2.

Langkah 2: Bersihkan Sisa Paket MySQL/MariaDB yang Bentrok

mysqldump --all-databases > /root/backup-mysql-$(date +%Y%m%d).sql
cp -a /var/lib/mysql /root/backup-mysql-dir-$(date +%Y%m%d)

Sakwise backup (utowo nek memang server fresh), cek dhisik ono opo wae paket MySQL/MariaDB sing tersisa neng sistem:

dpkg -l | grep -Ei "mysql|mariadb"

Nek ana output, berarti ana sisa paket sing iso bentrok. Bersihno kabeh paket database sing lawas:

apt purge -y 'mysql-*' 'mariadb-*' 'php-mysql*'
apt autoremove -y
apt autoclean

Sakwise paket bersih, hapus uga direktori konfigurasi lan data database sing tersisa. Eling, direktori iki wis dibackup mau, dadi aman:

rm -rf /etc/mysql
rm -rf /var/lib/mysql
rm -rf /var/log/mysql

Terakhir, pastikno ora ana paket sing nggantung (broken). Iki penting biar dpkg mulai seko kondisi bersih:

dpkg --configure -a
apt --fix-broken install -y

Langkah 3: Ganti Repository APT ke Repo Resmi Ubuntu

Iki langkah kuncine. Mirror lokal (apalagi sing seko pihak katelu) iku biang keladi utama neng kasus iki. Ganti kabeh repository neng repo resmi Ubuntu: archive.ubuntu.com kanggo paket utama lan security.ubuntu.com kanggo update keamanan. Tanpa langkah iki, sampeyan bakal nemu error sing padha maneh.

Neng Ubuntu 24.04, sumber repo ono neng file /etc/apt/sources.list.d/ubuntu.sources karo format deb822. Pertama, backup dhisik file sing ono:

cp /etc/apt/sources.list.d/ubuntu.sources /etc/apt/sources.list.d/ubuntu.sources.bak
ls /etc/apt/sources.list.d/

Terus isi file ubuntu.sources karo konfigurasi repo resmi ing ngisor iki. Hapus utowo mateni kabeh baris sing ngarah neng mirror liyane (karo menehi tanda # neng ngarep baris ‘Types: deb’ sing lawas):

Types: deb
URIs: http://archive.ubuntu.com/ubuntu/
Suites: noble noble-updates noble-backports
Components: main restricted universe multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg

Types: deb
URIs: http://security.ubuntu.com/ubuntu/
Suites: noble-security
Components: main restricted universe multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg

Catatan penting: nek VPS sampeyan arsitekture ARM (aarch64), ganti URIs-e karo http://ports.ubuntu.com/ubuntu-ports/. Nek sampeyan isih nganggo format sources.list klasik (baris deb http://...), sesuaike uga isine karo URL resmi neng ndhuwur lan pastikno ora ana baris mirror sing tersisa.

Sakwise iku, verifikasi sumber repo sing aktif:

apt update
apt-cache policy | head -40

Cek neng output apt-cache policy nek kabeh Candidate paket ngarah neng archive.ubuntu.com, dudu neng mirror lokal. Nek isih ana jejak mirror, ulangi proses edit file-e.

Kenapa kudu repo resmi, ora mirror wae? Mergo repo resmi Ubuntu guaranteed lengkap, versine konsisten, lan di-update rutin. Mirror lokal sing ora dikelola apik iku sumber ketidakpastian sing ora perlu. Kanggo instalasi cPanel sing butuh ratusan paket dependensi, sumber paket sing stabil iku setengah perang.

Langkah 4: Sinkronkan Sistem dengan Repo Resmi

Saiki kita pastikno sistem bersih lan sinkron penuh karo repo resmi:

apt update
apt upgrade -y
apt full-upgrade -y

Gatekno output-e. Pastikno ora ana error 404, ora ana paket sing ‘held’, lan proses upgrade rampung tanpa pesan merah. Nek ana paket sing ‘held back’, prikso karo:

apt-mark showhold

Nek output-e kosong, artine ora ana paket sing ditahan. Sistem wis siap kanggo instalasi ulang. Langkah iki uga nggarap sisa-sisa konfigurasi lawas sing iso ganggu proses cPanel.

Langkah 5: Pastikan Hostname Server Sudah FQDN

cPanel mensyaratke hostname server kudu berupa Fully Qualified Domain Name (FQDN), contone server-01.client-a.com. Cek dhisik hostname saiki:

hostnamectl
hostname -f
hostname -d

Nek hostname isih cendek (contone mung vps12345) utowo durung nduwe domain suffix, set dhisik:

hostnamectl set-hostname server-01.client-a.com

Aja nganggo domain sing padha karo domain utama cPanel sing arep sampeyan gunakke mengko. Hostname kudu unique lan ora oleh dadi bagian seko nama domain account. Sakwise set, verifikasi maneh:

hostname -f
hostname -d

Pastikno loro-lorone nampilke FQDN lengkap. Nek hostname -d kosong, cek file /etc/hosts lan tambahke mapping hostname neng IP server.

Langkah 6: Pastikan Resource Server Cukup

Instalasi cPanel iku haus resource. Nek RAM utowo disk ora cukup, proses apt/dpkg iso di-kill neng tengah jalan karo OOM killer, lan hasile error sing padha maneh. Cek dhisik:

free -m
df -h
nproc

• RAM: minimal 2GB, disaranke 4GB+. Nek kurang, tambah swap sementara: fallocate -l 4G /swapfile && chmod 600 /swapfile && mkswap /swapfile && swapon /swapfile. Nanging eling, swap dudu pengganti RAM.
• Disk kosong: minimal 20GB kanggo instalasi cPanel. Cek karo df -h /. Pastikno partisi / sing paling gedhe, dudu /home utowo sing liyane.
• CPU: minimal 2 core kanggo lingkungan production.

Nek resource kurang, sebaik-e sampeyan upgrade dhisik neng paket VPS sing luwih gedhe sadurunge neruske instalasi. Instalasi setengah jalan mergo OOM iku luwih nyiksa tinimbang nunda sedilut.

Langkah 7: Jalankan Ulang Installer cPanel

Sakwise kabeh langkah neng ndhuwur beres, saat-e eksekusi. Mergo instalasi cPanel iso ngongso wektu 45-90 menit, jalankno neng njero screen supaya nek koneksi SSH putus, proses tetep jalan:

apt install -y screen
screen -S cpanel-install

Neng njero sesi screen, download lan jalankno installer resmi cPanel:

cd /root
curl -o latest -L https://securedownloads.cpanel.net/latest
sh latest

Biarkno proses jalan. Nek arep lepas seko sesi screen tanpa ngendekke instalasi, pencet Ctrl+A terus D. Kanggo bali, ketik screen -r cpanel-install. Sakwise instalasi rampung, akses WHM liwat https://IP-SERVER:2087 nganggo akun root.

Tips Agar Instalasi Ulang cPanel Tidak Kena Masalah Mirror Lagi

Ngalamin sepisan wae wis cukup, ta? Nih sawetara kebiasaan sing tak terapke biar kasus kaya ngene ora tau muncul maneh:

• Selalu reset neng repo resmi sakwise provisioning. Akeh provider VPS ngatur mirror lokal otomatis pas server pertama digawe. Sakwise server aktif, langsung cek /etc/apt/sources.list.d/ lan pastikno ora ana mirror pihak katelu sadurunge install opo-opo.
• Nek terpaksa nganggo mirror, pilih sing tanggung jawab. Mirror seko provider gedhe sing rutin sync (kaya sing nyedhiakke halaman status mirror) isih iso ditoleransi. Nanging kanggo instalasi cPanel, paling aman tansah nganggo repo resmi.
• Verifikasi sakwise saben apt update. Biasakne cek apt-get update tanpa error 404. Nek muncul 404, perbaiki sadurunge neruske. Aja ditunda.
• Instalasi cPanel neng VPS fresh iku wajib. Aja tau install cPanel neng server sing wis ana Apache/nginx/php-fpm/MySQL manual. Stack liyane iki meh mesthi bentrok karo sing dibutuhke cPanel, lan hasile error instalasi sing angel dilacak. Nek memang wis terlanjur ke-install, fresh install OS wae biar bersih – kadang reset VPS luwih murah tinimbang berjam-jam debugging. Kanggo referensi migrasi/rebuild server, sampeyan iso cek panduan lengkap migrasi VPS KVM zero-downtime iki.
• Catet proses sing sampeyan jalanne. Simpen log instalasi sing sukses dadi referensi. Iki bakal banget mbantu nek suatu dina instalasi ulang diperlukan.

Tabel Troubleshooting Cepat

Kanggo sing pengene langsung oleh jawaban tanpa maca detail, nih tabel ringkase:

FAQ Seputar Error Instalasi cPanel Ubuntu 24.04

Artikel Terkait

Mau dalam-in maneh soal server? Cek artikel-artikel liyane neng Syslog Solutions:

• Cara Mengatasi High Load di Server cPanel
• Migrasi VPS KVM: Panduan Lengkap Zero-Downtime 2026
• 10 Cara Mengamankan SSH Server Linux
• Monitoring Server dengan Prometheus dan Grafana

Kesimpulan

Error ‘The background process SQL Databases and dependent apps failed’ neng instalasi cPanel Ubuntu 24.04 iku menakutke nek pertama kali ketemu, nanging akar masalah-e meh tansah sederhana: lingkungan server sing ora sehat. Karo cek log detail, bersihno sisa paket MySQL/MariaDB, ganti repository neng repo resmi Ubuntu, pastikno hostname FQDN, cek resource, lan jalankno ulang installer neng njero screen, instalasi cPanel sampeyan bakal mlaku mulus sampe rampung.

Pernah ngalamin kasus sing mirip nanging solusine beda? Utowo nemu trik sing luwih cepet? Drop neng kolom komentar ya, sopo ngerti iso mbantu kanca-kanca liyane. Monggo dipraktekno step neng ndhuwur neng server sampeyan, lan nek isih stuck, tinggal cek log-e maneh lan bandingno karo pola sing tak sebutno neng artikel iki. Piye, gampang ta? Sip, mugi sukses nggih!