Panduan Instalasi & Dasbor Konsol AwaniOS

AwaniOS adalah sistem operasi cloud tingkat produksi yang dirancang khusus untuk infrastruktur hyper-converged, manajemen mesin virtual (VM), dan jaringan berbasis perangkat lunak (SDN). AwaniOS dilengkapi dengan Wisaya Instalasi TUI interaktif dan Dasbor Konsol (os-tui) yang komprehensif untuk pemantauan node secara real-time, konfigurasi jaringan, manajemen Virtual Switch Open vSwitch (OVS), serta administrasi sistem.

---

1. Instalasi Sistem

1.1 Inisialisasi & Booting

• Booting: Masukkan media instalasi ISO AwaniOS ke dalam server bare-metal atau mesin virtual Anda, lalu jalankan sistem. Anda akan melihat urutan booting kernel dan inisialisasi layanan installer [00:10].
• Layar Selamat Datang: Setelah selesai, Wisaya Instalasi AwaniOS interaktif akan ditampilkan.
• Peringatan: Menginstal AwaniOS akan FORMAT DAN MENGHAPUS SEMUA DATA pada disk target yang dipilih. Tekan ENTER untuk melanjutkan [00:27].

1.2 Konfigurasi Disk & Jaringan

• Pilih Disk Target: Pilih perangkat penyimpanan fisik target (misalnya, /dev/sda atau /dev/vda). Gunakan tombol panah untuk menavigasi dan ENTER untuk memilih [00:34].
  • Tata Letak Penyimpanan: Installer akan membuat tabel partisi GPT yang sejajar, mencakup partisi BIOS Boot / EFI System, partisi boot (/boot), dan LVM Volume Group (awan-vg) yang berisi volume logis root, swap, dan home dengan cadangan GPT tail sebesar 32MB.
• Pilih Antarmuka Jaringan Utama: Pilih NIC fisik yang aktif untuk manajemen node (misalnya, enp1s0 atau eth0) [00:41].
• Pilih Mode Jaringan:
  • DHCP (Otomatis): Menerima alamat IP, gateway, dan server DNS secara otomatis dari server DHCP jaringan Anda [00:47].
  • Statis (Manual): Memerlukan pengisian alamat IP statis dengan notasi CIDR (misalnya, 192.168.1.100/24), default gateway (misalnya, 192.168.1.1), dan server DNS (misalnya, 1.1.1.1, 8.8.8.8).

1.3 Identitas Sistem & Kredensial

• Hostname: Masukkan nama unik untuk node Anda (misalnya, awanios-node-01).
• Kata Sandi Sistem: Masukkan kata sandi yang aman untuk akun administrator (awanio).
• Konfirmasi Kata Sandi: Masukkan kembali kata sandi untuk verifikasi. Tekan Tab untuk berpindah antar kolom dan ENTER untuk mengirimi [00:54].

1.4 Eksekusi Instalasi & Reboot

• Ringkasan Konfigurasi: Tinjau skema partisi, konfigurasi LVM, dan parameter jaringan [01:21].
• Eksekusi: Tekan ENTER untuk memulai proses instalasi otomatis Curtin. Sistem akan memformat partisi, mengekstrak gambar sistem berkas OS, dan menginstal bootloader GRUB [01:32].
• Reboot: Setelah selesai, tekan ENTER untuk mem-boot ulang node dan lepaskan media instalasi [01:52].

---

2. Dasbor Konsol (os-tui)

Setelah booting ke node AwaniOS yang telah terinstal, sistem akan menampilkan Dasbor Konsol AwaniOS pada tty1.

2.1 Autentikasi & Keamanan

Masuk menggunakan nama pengguna awanio dan kata sandi sistem yang Anda konfigurasikan saat instalasi. Autentikasi diverifikasi langsung terhadap kredensial shadow Linux melalui PAM (unix_chkpwd).

2.2 Tata Letak Dasbor & Navigasi

Dasbor dibagi menjadi tiga area utama:

1. Header Bar (Atas): Menampilkan Hostname Node, pengguna aktif (awanio), dan status koneksi.
2. Sidebar (Kiri): Menu vertikal yang mencantumkan seluruh tab manajemen beserta angka pintasan (1 hingga 6).
3. Panel Konten Utama (Tengah/Kanan): Area interaktif untuk melihat statistik dan melakukan tugas konfigurasi.

Pintasan Papan Ketik Global

Tombol	Tindakan
1 – 6	Pindah langsung ke tab tertentu (1: Ikhtisar, 2: Jaringan, 3: Penyimpanan, 4: Layanan, 5: Terminal, 6: Daya)
Tab / Shift+Tab	Berpindah maju / mundur antar tab
h / l atau ← / →	Berpindah tab ke kiri / kanan
j / k atau ↓ / ↑	Menavigasi daftar dan item menu
n	Membuka Wisaya Manajemen NIC Fisik (dari tab Jaringan)
m	Membuka Wisaya Manajemen Virtual Switch (VS) (dari tab Jaringan)
u	Membuka modal Pengbaru Dasbor TUI
q	Keluar dari Dasbor TUI ke prompt login

---

3. Modul Dasbor Detail

3.1 Tab Ikhtisar Sistem ([1])

Tab Ikhtisar Sistem menyediakan pemantauan kesehatan fisik node secara real-time:

• Informasi Sistem: Hostname, versi distribusi OS, versi release Kernel Linux, dan durasi Uptime.
• Sumber Daya Perangkat Keras: Arsitektur CPU, jumlah core CPU, Load Average (1m, 5m, 15m), dan Total/Penggunaan Memori.
• Bar Penggunaan Sumber Daya: Grafik progres dinamis yang menunjukkan persentase penggunaan CPU dan Memori secara langsung.
• Tombol Pintas [u]: Pintasan untuk membuka modal Pengbaru TUI.

---

3.2 Manajemen Jaringan & Antarmuka ([2])

Tekan 2 untuk membuka tab Jaringan. Bagian ini menampilkan antarmuka jaringan fisik, bridge Open vSwitch (OVS), dan virtual port (vPort).

3.2.1 Manajemen NIC Fisik ([n])

Tekan n pada tab Jaringan untuk mengonfigurasi kartu antarmuka jaringan fisik:

1. Pilih Antarmuka Fisik: Pilih antarmuka aktif (misalnya, enp1s0, eth0).
2. Pilih Mode Konfigurasi:
   • Mode DHCP: Mengonfigurasi ulang Netplan untuk akuisisi lease IPv4/IPv6 otomatis (dhcp4: true).
   • Mode IP Statis: Mengonfigurasi ulang Netplan dengan parameter jaringan statis kustom:
     • Alamat IP dengan CIDR: Masukkan alamat IP beserta netmask CIDR (misalnya, 192.168.1.10/24). Catatan: Awalan CIDR wajib diisi.
     • Gateway: Gateway routing IPv4 default (misalnya, 192.168.1.1).
     • DNS Nameserver: Alamat resolver DNS yang dipisahkan koma (misalnya, 1.1.1.1, 8.8.8.8).
3. Beralih Status & Pembersihan:
   • Mengubah status antarmuka menjadi UP atau DOWN.
   • Menghapus penetapan alamat IP yang ada.
4. Sinkronisasi DNS & Resolusi Otomatis:
   • Saat Netplan menerapkan pengaturan DNS statis baru, AwaniOS secara otomatis mengaktifkan systemd-resolved dan menyinkronkan nameserver ke /etc/resolv.conf untuk memastikan resolusi nama domain berfungsi di seluruh aplikasi sistem.

---

3.2.2 Manajemen Virtual Switch (VS) & vPort ([m])

AwaniOS mengintegrasikan Open vSwitch (OVS) untuk jaringan berbasis perangkat lunak (SDN) berkinerja tinggi. Tekan m pada tab Jaringan untuk mengakses wisaya Virtual Switch.

A. Mengelola Bridge VS

• Buat Bridge VS:
  • Nama Bridge: Masukkan nama bridge kustom (misalnya, br-ex, br-int).
  • Mode Fail: Pilih standalone (switching L2 standar) atau secure (memerlukan pengontrol SDN).
  • STP / RSTP: Aktifkan Spanning Tree Protocol (STP) atau Rapid Spanning Tree Protocol (RSTP) untuk pencegahan loop jaringan.
• Hapus Bridge VS: Menghapus bridge OVS dan melepaskan antarmuka terkait dengan aman.

B. Mengelola Virtual Port (vPort)

• Tambah Port Sistem (Trunk/NIC Fisik):
  • Hubungkan NIC fisik (misalnya, eth1) sebagai uplink system port ke bridge OVS.
  • Alamat IP NIC fisik akan dihapus dari Netplan dan diserahkan ke pipeline OVS.
• Tambah Internal vPort:
  • Buat vPort OVS internal (misalnya, mgmt0, storage0) untuk jaringan host atau layanan hypervisor.
  • Tetapkan Tag VLAN 802.1Q (1–4094) untuk segmentasi jaringan.
  • Tetapkan alamat IP statis langsung ke vPort internal.
• Tag Layanan (Service Tags): Tetapkan peran layanan khusus AwaniOS ke vPort untuk perutean lalu lintas klaster otomatis:
  • management — Manajemen node utama dan API control plane.
  • storage — Lalu lintas jaringan penyimpanan Ceph / SAN.
  • migration — Lalu lintas migrasi live VM.
  • backup — Pencadangan data dan replikasi snapshot.
  • replication — Replikasi blok penyimpanan.
  • shared-heartbeat — Quorum klaster dan heartbeat HA.
• Pemulihan Boot Persisten (awanios-ovs-ports.service): Port internal OVS dan tag layanan yang dikonfigurasi melalui os-tui disimpan secara otomatis ke /etc/awanios/ovs-internal-ports.conf dan diterapkan kembali saat boot sebelum inisialisasi jaringan.

---

3.3 Tab Manajemen Penyimpanan ([3])

Tekan 3 untuk membuka tab Penyimpanan:

• Disk Fisik: Melihat perangkat blok yang terdeteksi, model disk, nomor seri, kapasitas total, dan tabel partisi (/dev/sda, /dev/nvme0n1).
• LVM Volume Group: Memeriksa metrik storage pool awan-vg, extent teralokasi, dan ruang bebas.
• Logical Volume: Memantau mount point, tipe sistem berkas (ext4, xfs), ukuran total, dan persentase penggunaan untuk /, /home, dan swap.

---

3.4 Tab Layanan Systemd ([4])

Tekan 4 untuk melihat layanan sistem yang aktif maupun di latar belakang (vapor, libvirtd, openvswitch-switch, systemd-networkd, systemd-resolved, ceph):

• Filter & Pencarian: Tekan / untuk membuka kotak pencarian real-time dan ketik nama layanan.
• Status Layanan: Melihat status muat, status aktif (aktif/tidak aktif), dan sub-status (berjalan/keluar).
• Tindakan Kontrol Layanan:
  • Pilih layanan dan tekan ENTER untuk melihat log unit yang detail.
  • Kontrol tindakan cepat: Mulai (Start), Hentikan (Stop), Mulai Ulang (Restart), Aktifkan (Enable), Nonaktifkan (Disable).
• Perbarui Daftar: Tekan R untuk memuat ulang status layanan.

---

3.5 Terminal Terintegrasi ([5])

Tekan 5 untuk membuka shell pseudo-terminal terintegrasi:

• Membuka sesi interaktif Bash shell langsung di dalam UI konsol di bawah akun pengguna awanio.
• Mendukung perintah terminal standar, hak akses sudo, editor teks (vim, nano), dan utilitas CLI (awctl, kubectl, virsh, ovs-vsctl, ceph).
• Tekan ctrl+d atau ketik exit untuk menutup sesi shell dan kembali ke menu TUI.

---

3.6 Manajemen Daya Node ([6])

Tekan 6 untuk membuka tab manajemen Daya node:

• Mulai Ulang Node (Reboot): Memulai ulang sistem operasi secara aman (systemctl reboot).
• Matikan Node (Shutdown): Menghentikan semua mesin virtual dengan aman, melepas sistem berkas, dan mematikan perangkat keras (systemctl poweroff).
• Memerlukan langkah konfirmasi untuk mencegah penghentian sistem secara tidak sengaja.

---

4. Pembaruan Dasbor Konsol TUI

AwaniOS memiliki fitur pembaruan mandiri bawaan untuk dasbor konsol.

4.1 Pengbaru TUI Dalam Aplikasi (Tombol u)

1. Tekan u dari tab mana saja di dasbor konsol (atau klik [u] Update TUI pada tab Ikhtisar).
2. TUI akan mengueri https://storage.awan.io/assets/tui-version.json dan membandingkan metadata rilis online dengan BuildID lokal.
3. Jika pembaruan tersedia, tekan [Enter] untuk memulai:
   • Mengunduh biner os-tui kompilasi terbaru.
   • Membuat cadangan pemulihan (/usr/local/bin/os-tui.bak).
   • Mengganti /usr/local/bin/os-tui secara atomik.
   • Memulai ulang sesi TUI secara otomatis (getty@tty1.service) dalam 1 detik tanpa mem-boot ulang OS host.

4.2 Pembaruan Baris Perintah Manual

Selain itu, administrator sistem juga dapat memperbarui dasbor konsol dari terminal SSH jarak jauh atau sesi shell:

curl -sSL https://storage.awan.io/assets/awanios-tui-update.sh | sudo bash