Adaptor Penyimpanan

Adaptor penyimpanan menentukan bagaimana host berkomunikasi dengan perangkat keras penyimpanan atau target penyimpanan jaringan yang mendasarinya. Vapor mendukung pengontrol perangkat keras lokal, Fibre Channel Host Bus Adapter (HBA), dan koneksi penyimpanan berbasis perangkat lunak (software-defined).

---

Adaptor Lokal dan Perangkat Keras

Navigasikan ke Penyimpanan > Adaptor untuk melihat semua Host Bus Adapter (HBA) yang terdeteksi. Ini mencakup pengontrol AHCI/SATA lokal dan kartu PCIe RAID atau Fibre Channel yang terpasang.

• Mengklik salah satu HBA akan menampilkan daftar perangkat blok (block device) spesifik yang terkait dengannya.
• Pindai Ulang (Rescan): Jika Anda memasang drive baru (hot-plug) atau mengonfigurasi ulang array hardware RAID, lakukan operasi rescan untuk memaksa OS mendeteksi geometri penyimpanan baru tanpa perlu memboot ulang sistem.

---

iSCSI Software Adapter

Vapor menyediakan dukungan bawaan untuk memetakan target penyimpanan iSCSI jarak jauh melalui antarmuka Ethernet standar. Antarmuka iSCSI ini dikelola sebagai satu software adapter (singleton).

1. Mode Konfigurasi Adaptor

Buka Penyimpanan > Adaptor dan pilih iSCSI Software Adapter untuk mengonfigurasi pengaturan berikut:

• Initiator IQN: Tentukan nama inisiator yang unik (misalnya, iqn.2026-03.com.awanio.vapor:node-01).
• Mode Koneksi:
  • single_path: Koneksi berjalan melalui satu jalur gateway jaringan.
  • multipath: Koneksi mencakup beberapa jalur fisik untuk failover dan agregasi.
• Node Startup: Konfigurasikan apakah sesi terhubung secara otomatis saat boot (automatic) atau memerlukan aktivasi manual (manual).

2. Port Binding

Untuk konfigurasi multipath, hubungkan antarmuka jaringan host tertentu (seperti enp2s0 dan enp3s0) ke inisiator iSCSI perangkat lunak. Port binding memisahkan lalu lintas penyimpanan ke subnet dan NIC khusus.

• Hubungkan Port (Bind Port): POST /api/v1/storage/iscsi/adapter/port-bindings dengan payload {"interface_name": "enp2s0"}.
• Hapus Hubungan (Delete Binding): DELETE /api/v1/storage/iscsi/adapter/port-bindings/{binding_id}.

3. Pencarian Target (Target Discovery)

Untuk menemukan target IQN pada SAN Anda, lakukan panggilan discovery:

• Temukan Target (Discover Targets): POST /api/v1/storage/iscsi/adapter/discover dengan parameter target portal (IP:port) dan opsional binding_portals (antarmuka yang dipetakan ke IP portal tertentu). Ini akan mengeksekusi permintaan iSCSI SendTargets.
• Lihat Target Terdeteksi: GET /api/v1/storage/iscsi/adapter/targets mencantumkan semua target IQN SAN yang berhasil ditemukan.

4. Sesi Aktif dan Autentikasi

Log in ke target IQN yang ditemukan untuk memasang (mount) LUN-nya:

• Login Sesi: POST /api/v1/storage/iscsi/adapter/sessions menerima parameter target_iqn, portal, kredensial CHAP (username/password), dan binding_portals.
• Daftar Sesi: GET /api/v1/storage/iscsi/adapter/sessions mengembalikan pengidentifikasi sesi iSCSI yang aktif (session_id).
• Logout Sesi: DELETE /api/v1/storage/iscsi/adapter/sessions/{session_id}.
• Lupakan Target (Forget Target): Untuk membersihkan metadata target yang ditemukan, kirimkan POST /api/v1/storage/iscsi/adapter/targets/forget dengan target_iqn dan portal.

5. Pindai Ulang & Pemetaan LUN

Setelah membuat sesi, lakukan pemindaian ulang pada bus iSCSI untuk mendeteksi volume baru:

• Pindai Ulang Bus (Bus Rescan): POST /api/v1/storage/iscsi/adapter/rescan memaksa pemindaian ulang semua sesi aktif.
• Dapatkan LUN dan Perangkat: Gunakan GET /api/v1/storage/iscsi/adapter/luns dan GET /api/v1/storage/iscsi/adapter/devices untuk memverifikasi pemetaan ke path blok lokal (misalnya /dev/sdb atau /dev/disk/by-id/*).

---

Manajemen Multipath I/O (MPIO)

Saat menjalankan adaptor iSCSI dalam mode multipath, Vapor terintegrasi dengan layanan multipathd host untuk mengelola failover jalur:

• Daftar Perangkat Multipath: GET /api/v1/storage/multipath/devices mencantumkan peta multipath yang aktif.
• Detail Perangkat: GET /api/v1/storage/multipath/devices/{wwid} mengembalikan status, kebijakan, dan kapasitas untuk perangkat tertentu berdasarkan World Wide Identifier (WWID).
• Daftar Jalur Perangkat: GET /api/v1/storage/multipath/devices/{wwid}/paths menampilkan status (aktif, rusak, diaktifkan) dari setiap jalur fisik.
• Perbarui Kebijakan Perutean: PATCH /api/v1/storage/multipath/devices/{wwid}/policy mengubah kebijakan perutean secara dinamis (misalnya, failover atau round_robin).
• Pindai Ulang Multipath: POST /api/v1/storage/multipath/rescan memicu evaluasi ulang perangkat multipath di seluruh host.