Chapter-6 : Mencegah Perubahan Nama Antarmuka Jaringan dengan Network Interface Pinning

Pendahuluan
Pernahkah Anda mengalami situasi di mana setelah pembaruan kernel, upgrade sistem, atau pemasangan kartu jaringan baru, server Proxmox VE Anda tiba-tiba kehilangan koneksi jaringan? Setelah dicek, ternyata nama antarmuka jaringannya berubah! Misalnya, yang tadinya eno1 tiba-tiba menjadi eno2, atau enp3s0f0 bergeser menjadi enp4s0f0. Akibatnya, konfigurasi di /etc/network/interfaces menjadi tidak cocok, bridge tidak terbentuk, dan semua VM/CT Anda ikut terisolasi.

Masalah ini adalah konsekuensi dari Predictable Network Interface Names, standar penamaan modern yang bertujuan membuat nama antarmuka tetap konsisten berdasarkan lokasi fisik (slot PCI, port, dsb.). Namun, ada skenario di mana penamaan ini justru berubah karena kernel atau driver baru memperkenalkan skema penamaan yang berbeda. Proxmox VE menyediakan tiga metode untuk mengunci (pin) nama antarmuka agar tetap abadi, apa pun yang terjadi. Artikel ini akan mengupas semuanya.

Akar Masalah: Skema Penamaan yang Dapat Diprediksi

Linux modern menggunakan systemd untuk menamai antarmuka jaringan berdasarkan atribut fisik, bukan hanya urutan deteksi (eth0, eth1). Tujuannya mulia: nama yang tetap meskipun hardware ditambah atau dicabut. Contoh: enp3s0f0 berarti Ethernet, PCI bus 3, slot 0, fungsi 0. Namun, systemd memiliki skema penamaan yang terus berkembang. Setiap versi systemd baru bisa saja memperkenalkan versi skema yang sedikit berbeda, sehingga nama antarmuka yang dihasilkan bisa berubah setelah pembaruan systemd atau kernel.

Proxmox VE menggunakan systemd, sehingga rentan terhadap masalah ini. Untungnya, ada solusi untuk menguncinya.

Metode 1: Pinning Versi Skema Penamaan (Kernel Command Line)

Ini adalah cara paling sederhana untuk mencegah perubahan nama akibat upgrade versi systemd. Anda dapat memberitahu kernel untuk tetap menggunakan skema penamaan dari versi systemd tertentu.

Caranya:

• Edit file /etc/default/grub.
• Temukan baris GRUB_CMDLINE_LINUX_DEFAULT. Tambahkan parameter net.naming-scheme=<versi> di dalam tanda kutip. Misalnya, untuk mengunci ke skema versi v252 (default Proxmox VE 8.0):

GRUB_CMDLINE_LINUX_DEFAULT="quiet net.naming-scheme=v252"

• Simpan file, lalu perbarui konfigurasi GRUB:

update-grub

• Reboot server.

Kelebihan:

• Sangat mudah diterapkan.
• Mencegah perubahan nama yang disebabkan oleh upgrade systemd.

Kekurangan:

• Tidak mencegah perubahan nama akibat perubahan kernel/driver yang bisa mengubah urutan enumerasi PCI. Jika Anda menambah atau mencabut kartu jaringan, nama masih bisa berubah.
• Hanya mengunci versi skema, bukan nama spesifik antarmuka.

Cara Mengetahui Versi Skema yang Sedang Aktif:
Jalankan udevadm info -e | grep -m1 NET_NAMING_SCHEME atau periksa log boot.

Metode 2: Override Manual dengan File .link (systemd)

Cara ini jauh lebih kuat. Anda membuat aturan di systemd untuk mencocokkan antarmuka berdasarkan MAC Address (atau atribut unik lainnya), lalu memberinya nama kustom yang Anda inginkan. Nama ini akan abadi, tidak peduli perubahan kernel, driver, atau penambahan hardware lain.

Langkah-langkah:

• Buat direktori jika belum ada: /etc/systemd/network/.
• Buat file dengan ekstensi .link, misalnya /etc/systemd/network/10-wan.link. Nama file harus unik dan diurutkan (prioritas lebih rendah diproses lebih dulu, tetapi aturan spesifik akan menang).
• Isi file dengan konfigurasi berikut (contoh untuk mengganti NIC dengan MAC aa:bb:cc:dd:ee:ff menjadi wan0):

[Match]
MACAddress=aa:bb:cc:dd:ee:ff
Type=ether

[Link]
Name=wan0

• Setelah membuat file, perbarui initramfs agar aturan ini dikenali saat booting:

update-initramfs -u -k all

• Jangan lupa untuk menyesuaikan file /etc/network/interfaces agar menggunakan nama baru (wan0) alih-alih nama lama.
• Reboot server.

Kelebihan:

• Sangat presisi. Anda menentukan sendiri nama antarmuka.
• Tahan terhadap perubahan kernel/driver karena mencocokkan berdasarkan MAC, bukan posisi bus.
• Fleksibel: bisa juga mencocokkan berdasarkan Path (lokasi PCI) atau Driver.

Kekurangan:

• Manual, perlu membuat file untuk setiap antarmuka yang ingin dipin.
• Rentan kesalahan penulisan MAC Address atau konfigurasi link.
• Harus reboot untuk diterapkan.

Metode 3: pve-network-interface-pinning (Otomatis dan Direkomendasikan)

Proxmox VE menyediakan alat ajaib yang mengotomatiskan Metode 2. Alat ini akan mendeteksi semua antarmuka fisik Anda, lalu membuatkan file .link yang diperlukan secara otomatis. Ia juga akan menawarkan untuk memperbarui referensi nama di file konfigurasi Proxmox lainnya, seperti /etc/network/interfaces.

Cara Penggunaan:

• Generate Nama Tetap Standar (nic1, nic2, …):

pve-network-interface-pinning generate

• Perintah ini akan menghasilkan file .link di /etc/systemd/network/ yang mengganti nama semua NIC fisik menjadi nic1, nic2, nic3, dst. (berdasarkan urutan MAC Address). File konfigurasi baru akan dibuat dengan ekstensi .new, sehingga Anda bisa meninjaunya terlebih dahulu.
• Generate Nama Kustom untuk Antarmuka Tertentu:
  Jika Anda ingin mengganti nama hanya satu antarmuka spesifik, misalnya enp1s0f0 menjadi wan0:

pve-network-interface-pinning generate --interface enp1s0f0 --target-name wan0

• Tinjau Perubahan:
  Alat ini tidak langsung menimpa konfigurasi. Ia akan membuat file baru seperti:
  • /etc/network/interfaces.new (konfigurasi jaringan yang sudah disesuaikan dengan nama baru)
  • File .link baru di /etc/systemd/network/
  Periksa file-file tersebut dengan cat atau editor teks untuk memastikan semuanya sesuai keinginan.
• Terapkan:
  Jika Anda puas dengan perubahannya, Anda harus me-reboot server. Saat booting, layanan pvenetcommit akan secara otomatis mengganti interfaces dengan interfaces.new, dan systemd akan menerapkan aturan .link untuk memberi nama antarmuka.

Kelebihan:

• Otomatis, cepat, dan minim kesalahan manusia.
• Menangani pembuatan file .link dan penyesuaian interfaces sekaligus.
• Ini adalah metode yang didukung penuh dan direkomendasikan oleh Proxmox VE.

Kekurangan:

• Hanya bisa dijalankan via CLI (tidak ada tombol di GUI).
• Tetap memerlukan reboot untuk penerapan penuh.

Perbandingan Tiga Metode

Rekomendasi: Selalu gunakan Metode 3 (pve-network-interface-pinning) untuk server produksi. Ini memberikan kepastian absolut bahwa nama antarmuka tidak akan berubah, apa pun pembaruan yang dilakukan.

Visual: Alur Pencegahan Perubahan Nama Antarmuka

Diagram ini memandu Anda memilih metode yang tepat berdasarkan situasi Anda.

Kesimpulan
Perubahan nama antarmuka jaringan adalah mimpi buruk yang bisa dihindari sepenuhnya. Dengan memahami akar masalah dan menggunakan alat seperti pve-network-interface-pinning, Anda dapat memastikan infrastruktur Proxmox VE Anda tetap stabil dan dapat diakses, apa pun pembaruan yang terjadi di masa depan. Luangkan waktu untuk menerapkan pinning sekarang sebelum masalah terjadi.