SanzSkuy: Created page with "Panduan ini menjalankan '''Arch Linux ARM (ALARM)''' sebagai ''guest'' di dalam QEMU lewat '''emulasi penuh''' (''full-system emulation''), sehingga bisa dijalankan dari host arsitektur apa pun (x86_64, ARM, dll). {{Note|Arch Linux ARM '''tidak menyediakan ISO installer'''. Distronya dikirim sebagai ''rootfs tarball'' yang harus disiapkan ke dalam disk dari sisi host terlebih dahulu, baru di-boot. Karena itu langkahnya berbeda dari instalasi Arch x86 biasa.}} Terse..."

2026-06-14T04:40:10Z

Created page with "Panduan ini menjalankan '''Arch Linux ARM (ALARM)''' sebagai ''guest'' di dalam QEMU lewat '''emulasi penuh''' (''full-system emulation''), sehingga bisa dijalankan dari host arsitektur apa pun (x86_64, ARM, dll). {{Note|Arch Linux ARM '''tidak menyediakan ISO installer'''. Distronya dikirim sebagai ''rootfs tarball'' yang harus disiapkan ke dalam disk dari sisi host terlebih dahulu, baru di-boot. Karena itu langkahnya berbeda dari instalasi Arch x86 biasa.}} Terse..."

New page

Panduan ini menjalankan '''Arch Linux ARM (ALARM)''' sebagai ''guest'' di dalam [[QEMU]] lewat '''emulasi penuh''' (''full-system emulation''), sehingga bisa dijalankan dari host arsitektur apa pun (x86_64, ARM, dll).

{{Note|Arch Linux ARM '''tidak menyediakan ISO installer'''. Distronya dikirim sebagai ''rootfs tarball'' yang harus disiapkan ke dalam disk dari sisi host terlebih dahulu, baru di-boot. Karena itu langkahnya berbeda dari instalasi Arch x86 biasa.}}

Tersedia '''2 metode''':

* '''Metode A — Direct kernel boot''' ''(disarankan, paling sederhana)''. Kernel di-pass langsung lewat argumen QEMU. Tidak butuh firmware UEFI maupun bootloader.
* '''Metode B — UEFI boot''' ''(lebih realistis & mandiri)''. VM boot sendiri seperti mesin asli. Lebih banyak langkah.

Mulai dari Metode A. Pindah ke Metode B kalau sudah nyaman.

== Prasyarat ==

Kebutuhan di host:

* RAM cukup (alokasikan ≥ 2–4 GB untuk VM)
* Disk kosong ± 20 GB
* Akses <code>sudo</code>
* Emulasi murni (TCG) itu '''lambat''' di host non-ARM — ini normal. Di host Apple Silicon bisa pakai akselerasi HVF (lihat catatan di bagian boot).

=== Install paket QEMU ===

'''Arch / Manjaro:'''
<syntaxhighlight lang="bash">
sudo pacman -S --needed qemu-base qemu-system-aarch64 libarchive
# untuk Metode B (UEFI), tambahkan firmware:
sudo pacman -S edk2-aarch64
</syntaxhighlight>

'''Debian / Ubuntu:'''
<syntaxhighlight lang="bash">
sudo apt update
sudo apt install qemu-system-arm qemu-utils libarchive-tools
# untuk Metode B (UEFI):
sudo apt install qemu-efi-aarch64
</syntaxhighlight>

'''Fedora:'''
<syntaxhighlight lang="bash">
sudo dnf install qemu-system-aarch64 qemu-img libarchive
# untuk Metode B (UEFI):
sudo dnf install edk2-aarch64
</syntaxhighlight>

{{Tip|<code>libarchive</code> / <code>libarchive-tools</code> dibutuhkan untuk perintah '''<code>bsdtar</code>'''. Tarball ALARM '''wajib''' diekstrak pakai <code>bsdtar</code>, bukan <code>tar</code> GNU biasa, supaya permission & atribut file terjaga.}}

== Metode A — Direct Kernel Boot (disarankan) ==

=== Langkah 1: Download rootfs tarball ===

<syntaxhighlight lang="bash">
wget http://os.archlinuxarm.org/os/ArchLinuxARM-aarch64-latest.tar.gz
</syntaxhighlight>

{{Tip|'''Kecepatan dari Indonesia:''' mirror Jepang/Taiwan biasanya lebih cepat, mis. <code>http://jp.mirror.archlinuxarm.org/os/ArchLinuxARM-aarch64-latest.tar.gz</code> atau <code>http://tw2.mirror.archlinuxarm.org/os/ArchLinuxARM-aarch64-latest.tar.gz</code>.}}

=== Langkah 2: Buat disk image ===

<syntaxhighlight lang="bash">
qemu-img create -f qcow2 alarm.qcow2 16G
</syntaxhighlight>

(<code>16G</code> = batas maksimum; file qcow2 tumbuh sesuai pemakaian, tidak langsung memakan 16 GB.)

=== Langkah 3: Siapkan partisi via qemu-nbd ===

Sambungkan image qcow2 sebagai ''network block device'' agar bisa dipartisi dari host:

<syntaxhighlight lang="bash">
sudo modprobe nbd max_part=8
sudo qemu-nbd --connect=/dev/nbd0 alarm.qcow2
</syntaxhighlight>

Buat satu partisi root ext4 (cukup untuk Metode A):

<syntaxhighlight lang="bash">
sudo parted -s /dev/nbd0 mklabel gpt
sudo parted -s /dev/nbd0 mkpart primary ext4 1MiB 100%
sudo mkfs.ext4 /dev/nbd0p1
</syntaxhighlight>

=== Langkah 4: Mount & ekstrak rootfs ===

<syntaxhighlight lang="bash">
sudo mount /dev/nbd0p1 /mnt
sudo bsdtar -xpf ArchLinuxARM-aarch64-latest.tar.gz -C /mnt
sudo sync
</syntaxhighlight>

Cek isi <code>/boot</code> — pastikan ada kernel & initramfs:

<syntaxhighlight lang="bash">
ls -lh /mnt/boot
</syntaxhighlight>

Harus muncul <code>Image</code> dan <code>initramfs-linux-fallback.img</code> (juga <code>initramfs-linux.img</code>). Kalau initramfs tidak ada, gunakan Metode B yang me-regenerate-nya saat boot pertama.

=== Langkah 5: Salin kernel + initramfs ke host ===

Metode A mem-boot kernel dari sisi host, jadi salin keluar:

<syntaxhighlight lang="bash">
sudo cp /mnt/boot/Image ./Image
sudo cp /mnt/boot/initramfs-linux-fallback.img ./initramfs.img
sudo chown $USER:$USER Image initramfs.img
</syntaxhighlight>

{{Note|Pakai <code>initramfs-linux-fallback.img</code> (berisi semua modul, termasuk <code>virtio</code>) supaya boot pertama pasti mengenali disk.}}

=== Langkah 6: (Opsional) atur fstab ===

<syntaxhighlight lang="bash">
echo '/dev/vda1 / ext4 defaults 0 1' | sudo tee /mnt/etc/fstab
</syntaxhighlight>

=== Langkah 7: Lepas mount & putuskan nbd ===

<syntaxhighlight lang="bash">
sudo umount /mnt
sudo qemu-nbd --disconnect /dev/nbd0
sudo rmmod nbd # opsional
</syntaxhighlight>

=== Langkah 8: Jalankan VM ===

<syntaxhighlight lang="bash">
qemu-system-aarch64 \
-M virt \
-cpu cortex-a72 \
-smp 4 \
-m 4G \
-kernel Image \
-initrd initramfs.img \
-append "root=/dev/vda1 rw console=ttyAMA0" \
-drive if=virtio,file=alarm.qcow2,format=qcow2 \
-nic user,model=virtio-net-pci,hostfwd=tcp::2222-:22 \
-nographic
</syntaxhighlight>

Penjelasan opsi:

{| class="wikitable"
|-
! Opsi !! Arti
|-
| <code>-M virt</code> || Mesin virtual ARM generik standar QEMU
|-
| <code>-cpu cortex-a72</code> || CPU yang diemulasi (alternatif: <code>-cpu max</code>)
|-
| <code>-smp 4</code> / <code>-m 4G</code> || 4 vCPU, RAM 4 GB
|-
| <code>-kernel</code> / <code>-initrd</code> / <code>-append</code> || Boot kernel langsung + argumen kernel
|-
| <code>-drive if=virtio,...</code> || Disk muncul sebagai <code>/dev/vda</code> di dalam VM
|-
| <code>-nic user,...,hostfwd=tcp::2222-:22</code> || Jaringan user-mode + forward port host 2222 → guest 22 (SSH)
|-
| <code>-nographic</code> || Output serial langsung ke terminal
|}

{{Tip|'''Keluar dari <code>-nographic</code>:''' tekan {{ic|Ctrl-A}} lalu {{ic|X}}.<br>'''Apple Silicon (host ARM):''' tambahkan <code>-accel hvf -cpu host</code> untuk kecepatan jauh lebih tinggi (ganti <code>-cpu cortex-a72</code>).}}

{{Warning|'''Catatan Metode A:''' karena kernel berada di host, kalau nanti update kernel di dalam VM (<code>pacman -Syu</code>), salin ulang <code>Image</code> & initramfs yang baru dari <code>/boot</code>, atau pindah ke Metode B agar update kernel otomatis ke-boot.}}

== Login pertama & konfigurasi awal ==

Akun default Arch Linux ARM:

{| class="wikitable"
|-
! User !! Password
|-
| <code>alarm</code> || <code>alarm</code>
|-
| <code>root</code> || <code>root</code>
|}

Login sebagai <code>root</code> untuk setup.

=== Inisialisasi keyring pacman (WAJIB sebelum update) ===

<syntaxhighlight lang="bash">
pacman-key --init
pacman-key --populate archlinuxarm
</syntaxhighlight>

=== Update sistem ===

<syntaxhighlight lang="bash">
pacman -Syu
</syntaxhighlight>

=== Konfigurasi dasar ===

<syntaxhighlight lang="bash">
# Ganti password root
passwd

# Zona waktu (Bandung = WIB)
ln -sf /usr/share/zoneinfo/Asia/Jakarta /etc/localtime
hwclock --systohc

# Locale
sed -i 's/#en_US.UTF-8/en_US.UTF-8/' /etc/locale.gen
sed -i 's/#id_ID.UTF-8/id_ID.UTF-8/' /etc/locale.gen
locale-gen
echo 'LANG=en_US.UTF-8' > /etc/locale.conf

# Hostname
echo 'archarm' > /etc/hostname

# Buat user baru + sudo
pacman -S --needed sudo
useradd -m -G wheel namauser
passwd namauser
EDITOR=nano visudo # hapus tanda # pada baris: %wheel ALL=(ALL:ALL) ALL
</syntaxhighlight>

=== SSH dari host ===

ALARM sudah menyertakan <code>sshd</code>. Dari terminal '''host''':

<syntaxhighlight lang="bash">
ssh -p 2222 alarm@localhost
</syntaxhighlight>

(Kalau koneksi ditolak: di dalam VM jalankan <code>systemctl enable --now sshd</code>.)

Selesai — sistem Arch Linux ARM siap dipakai.

== Metode B — UEFI Boot (mandiri, lebih realistis) ==

Di sini VM boot sendiri lewat firmware UEFI (edk2), tanpa perlu pass kernel dari host. Update kernel di dalam VM otomatis ke-boot. Pendekatan paling andal di QEMU adalah lewat '''<code>startup.nsh</code>''' di EFI System Partition (ESP).

Ulangi '''Langkah 1–3''' dari Metode A (download tarball, buat qcow2, modprobe + connect nbd), lalu lanjut:

=== B1. Partisi: ESP + root ===

<syntaxhighlight lang="bash">
sudo parted -s /dev/nbd0 mklabel gpt
sudo parted -s /dev/nbd0 mkpart ESP fat32 1MiB 513MiB
sudo parted -s /dev/nbd0 set 1 esp on
sudo parted -s /dev/nbd0 mkpart primary ext4 513MiB 100%
sudo mkfs.fat -F32 /dev/nbd0p1
sudo mkfs.ext4 /dev/nbd0p2
</syntaxhighlight>

=== B2. Mount & ekstrak ===

<syntaxhighlight lang="bash">
sudo mount /dev/nbd0p2 /mnt
sudo bsdtar -xpf ArchLinuxARM-aarch64-latest.tar.gz -C /mnt
sudo mkdir -p /mnt/boot/efi
sudo mount /dev/nbd0p1 /mnt/boot/efi
</syntaxhighlight>

=== B3. Siapkan kernel + startup.nsh di ESP ===

<syntaxhighlight lang="bash">
# Ambil PARTUUID partisi root
ROOT_PARTUUID=$(sudo blkid -s PARTUUID -o value /dev/nbd0p2)
echo "Root PARTUUID = $ROOT_PARTUUID"

# Salin kernel + initramfs ke ESP
sudo cp /mnt/boot/Image /mnt/boot/efi/
sudo cp /mnt/boot/initramfs-linux-fallback.img /mnt/boot/efi/

# Buat startup.nsh (UEFI Shell otomatis menjalankannya)
printf 'Image initrd=initramfs-linux-fallback.img root=PARTUUID=%s rw console=ttyAMA0\n' "$ROOT_PARTUUID" \
| sudo tee /mnt/boot/efi/startup.nsh
</syntaxhighlight>

=== B4. fstab ===

<syntaxhighlight lang="bash">
ESP_UUID=$(sudo blkid -s UUID -o value /dev/nbd0p1)
sudo tee /mnt/etc/fstab >/dev/null <<EOF
PARTUUID=$ROOT_PARTUUID / ext4 defaults 0 1
UUID=$ESP_UUID /boot/efi vfat defaults 0 2
EOF
</syntaxhighlight>

=== B5. Lepas mount & putuskan nbd ===

<syntaxhighlight lang="bash">
sudo umount /mnt/boot/efi
sudo umount /mnt
sudo qemu-nbd --disconnect /dev/nbd0
</syntaxhighlight>

=== B6. Siapkan firmware UEFI ===

Variabel NVRAM perlu file yang bisa ditulis — salin templatenya:

<syntaxhighlight lang="bash">
# Arch (edk2-aarch64):
cp /usr/share/edk2/aarch64/QEMU_VARS.fd ./QEMU_VARS.fd
CODE=/usr/share/edk2/aarch64/QEMU_CODE.fd

# Debian/Ubuntu (qemu-efi-aarch64) — pakai ini sebagai gantinya:
# cp /usr/share/AAVMF/AAVMF_VARS.fd ./QEMU_VARS.fd
# CODE=/usr/share/AAVMF/AAVMF_CODE.fd
</syntaxhighlight>

=== B7. Jalankan VM (UEFI) ===

<syntaxhighlight lang="bash">
qemu-system-aarch64 \
-M virt \
-cpu cortex-a72 \
-smp 4 \
-m 4G \
-drive if=pflash,format=raw,readonly=on,file="$CODE" \
-drive if=pflash,format=raw,file=QEMU_VARS.fd \
-drive if=virtio,file=alarm.qcow2,format=qcow2 \
-nic user,model=virtio-net-pci,hostfwd=tcp::2222-:22 \
-nographic
</syntaxhighlight>

Firmware akan gagal menemukan bootloader standar, jatuh ke UEFI Shell, lalu menjalankan <code>startup.nsh</code> yang mem-boot kernel. Setelah masuk, lanjutkan dari bagian [[#Login pertama & konfigurasi awal|Login pertama & konfigurasi awal]].

{{Tip|Setelah update kernel di dalam VM, salin ulang kernel/initramfs ke ESP, atau (lebih baik) install bootloader sungguhan seperti <code>systemd-boot</code>/<code>grub</code> dari dalam VM agar tidak perlu <code>startup.nsh</code>.}}

== Troubleshooting ==

; Kernel panic "Unable to mount root fs" / "VFS: Cannot open root device"
: Disk tidak terbaca. Pastikan pakai <code>initramfs-linux-fallback.img</code> (bukan yang biasa), dan <code>root=/dev/vda1</code> cocok dengan layout disk (<code>/dev/vda</code> = drive virtio pertama).

; Layar diam / tidak ada output
: Pastikan ada <code>console=ttyAMA0</code> di <code>-append</code> dan pakai <code>-nographic</code>. Untuk Metode B, console diatur di <code>startup.nsh</code>.

; <code>bsdtar: command not found</code>
: Install <code>libarchive</code> (Arch/Fedora) atau <code>libarchive-tools</code> (Debian/Ubuntu).

; <code>Could not access KVM kernel module</code> / sangat lambat
: Normal di host non-ARM: kamu memang sedang '''mengemulasi''' ARM (TCG), bukan virtualisasi. Tidak ada KVM. Untuk percepatan, jalankan di host ARM (Apple Silicon: <code>-accel hvf -cpu host</code>).

; <code>/dev/nbd0</code> sibuk / tidak bisa connect
: <syntaxhighlight lang="bash">
sudo qemu-nbd --disconnect /dev/nbd0
sudo rmmod nbd && sudo modprobe nbd max_part=8
</syntaxhighlight>

; Permission saat ekstrak
: Selalu pakai <code>sudo bsdtar -xpf ...</code> (flag <code>-p</code> mempertahankan permission).

== Tips lanjutan ==

* '''GUI/desktop:''' ganti <code>-nographic</code> dengan <code>-device virtio-gpu-pci -display gtk</code> (atau <code>-display sdl</code>), lalu install desktop di dalam VM (mis. <code>pacman -S xfce4</code>). Emulasi grafis terasa berat.
* '''Folder bersama host↔guest:''' paling praktis lewat SSH/<code>scp</code> ke port 2222, atau pakai <code>virtfs</code>/<code>9p</code>.
* '''Perbesar disk nanti:''' <code>qemu-img resize alarm.qcow2 +10G</code>, lalu perluas partisi dari dalam VM.
* '''Snapshot:''' <code>qemu-img snapshot -c nama alarm.qcow2</code> (buat), <code>-a nama</code> (kembalikan), <code>-l</code> (daftar).
* '''Bikin skrip launcher:''' simpan perintah <code>qemu-system-aarch64 ...</code> di file <code>.sh</code> agar tidak ketik ulang.

[[Category:QEMU]]
[[Category:Arch Linux ARM]]
[[Category:Virtualization]]

Install Arch Linux ARM di QEMU - Revision history