Juni 28, 2026
walidumar-16
Pelajari dokumentasi jaringan lengkap menggunakan NetBox, draw.io, Oxidized, dan Git agar topologi, VLAN, IP, serta konfigurasi selalu akurat.

Dokumentasi Jaringan yang Tidak Pernah Diupdate Lebih Berbahaya Daripada Tidak Ada Dokumentasi

Banyak administrator jaringan merasa aman karena memiliki dokumentasi. Namun kenyataannya, dokumentasi yang sudah usang sering kali menjadi sumber masalah yang lebih besar daripada tidak memiliki dokumentasi sama sekali.

Ketika terjadi gangguan jaringan, proses troubleshooting sering terhambat karena informasi yang tersedia tidak sesuai dengan kondisi sebenarnya. VLAN sudah berubah, IP address sudah dipindahkan, perangkat sudah diganti, tetapi dokumentasi masih menampilkan data lama.

Akibatnya, tim IT mengambil keputusan berdasarkan informasi yang salah.

Dokumentasi yang baik bukanlah dokumentasi yang paling lengkap. Dokumentasi yang baik adalah dokumentasi yang selalu diperbarui dan dapat dipercaya saat dibutuhkan.

Pada artikel ini kita akan membahas sistem dokumentasi jaringan modern menggunakan NetBox, draw.io, Oxidized, Git, dan Runbook operasional agar infrastruktur jaringan selalu terdokumentasi dengan baik.


Mengapa Dokumentasi Jaringan Sangat Penting?

Dokumentasi jaringan berfungsi sebagai peta dan buku panduan bagi administrator jaringan.

Tanpa dokumentasi, proses berikut menjadi jauh lebih sulit:

  • Troubleshooting gangguan jaringan
  • Migrasi perangkat
  • Audit keamanan
  • Onboarding teknisi baru
  • Disaster recovery
  • Perencanaan ekspansi jaringan

Bayangkan sebuah sekolah, kampus, ISP, atau perusahaan memiliki ratusan perangkat jaringan. Ketika salah satu switch mengalami kerusakan, bagaimana administrator mengetahui VLAN yang digunakan, IP management, uplink, atau konfigurasi sebelumnya?

Di sinilah dokumentasi menjadi aset yang sangat berharga.


Prinsip Utama Dokumentasi Modern

Prinsip yang perlu diingat sangat sederhana:

Jika dokumentasi sulit diupdate, maka dokumentasi tidak akan pernah diupdate.

Karena itu sistem dokumentasi modern harus:

  • Mudah diperbarui
  • Otomatis jika memungkinkan
  • Terpusat
  • Memiliki histori perubahan
  • Mudah diakses seluruh tim

NetBox Sebagai Pusat Dokumentasi Infrastruktur

Apa Itu NetBox?

NetBox adalah platform open-source yang banyak digunakan sebagai:

  • IP Address Management (IPAM)
  • Data Center Infrastructure Management (DCIM)
  • Device Inventory
  • Dokumentasi jaringan terpusat

NetBox menjadi sumber data utama untuk seluruh informasi jaringan.


Dokumentasi IP Address dengan NetBox

Salah satu fitur terpenting NetBox adalah IPAM.

Administrator dapat mencatat:

  • Prefix jaringan
  • Subnet
  • Gateway
  • DNS
  • IP perangkat
  • Status penggunaan IP

Contoh:

PrefixFungsi
10.10.10.0/24Management Network
10.20.20.0/24Server Network
10.30.30.0/24CCTV Network
10.40.40.0/24Guest WiFi

Dengan cara ini konflik IP dapat diminimalkan.


Dokumentasi VLAN di NetBox

Selain IP Address, VLAN juga dapat didokumentasikan secara lengkap.

Contoh:

VLAN IDNama VLAN
10Management
20Server
30CCTV
40Guest
50VoIP

Informasi ini membantu administrator memahami segmentasi jaringan tanpa harus login ke switch satu per satu.


Device Inventory

NetBox juga dapat menyimpan informasi:

  • Router
  • Switch
  • Firewall
  • Access Point
  • Server
  • Rack
  • Kabel

Contoh data yang dapat dicatat:

  • Vendor
  • Model
  • Serial Number
  • Lokasi
  • Interface
  • Status perangkat

Saat audit dilakukan, seluruh informasi tersedia dalam satu dashboard.


Dokumentasi Topologi Menggunakan draw.io

Mengapa Tidak Cukup Menyimpan Gambar?

Kesalahan yang sering dilakukan adalah menyimpan diagram jaringan hanya dalam bentuk PNG atau JPG.

Masalahnya:

  • Sulit diedit
  • Harus membuat ulang saat ada perubahan
  • Tidak memiliki layer objek

Karena itu simpan selalu file sumber draw.io.

Contoh format:

  • .drawio
  • .xml

Dengan demikian diagram dapat diperbarui kapan saja.


Komponen yang Harus Ada pada Diagram Topologi

Topologi jaringan sebaiknya menampilkan:

  • Router
  • Core Switch
  • Distribution Switch
  • Access Switch
  • Firewall
  • Server
  • Access Point
  • VLAN
  • Link antar perangkat

Diagram yang baik harus mudah dipahami bahkan oleh teknisi baru.


Backup Konfigurasi Otomatis Menggunakan Oxidized

Mengapa Backup Konfigurasi Penting?

Banyak administrator hanya menyimpan konfigurasi secara manual.

Masalahnya:

  • Lupa backup
  • File hilang
  • Versi terbaru tidak tersimpan

Solusinya adalah menggunakan Oxidized.


Fungsi Oxidized

Oxidized dapat:

  • Backup konfigurasi otomatis
  • Menyimpan histori perubahan
  • Mendukung banyak vendor
  • Integrasi dengan Git

Perangkat yang dapat dibackup:

  • MikroTik
  • Cisco
  • Juniper
  • Aruba
  • Huawei
  • Fortigate

dan banyak vendor lainnya.


Cara Kerja Oxidized

  1. Login otomatis ke perangkat
  2. Mengambil konfigurasi
  3. Menyimpan hasil backup
  4. Mencatat perubahan konfigurasi

Administrator tidak perlu melakukan backup manual lagi.


Menggunakan Git untuk Version Control Dokumentasi

Dokumentasi bukan file statis.

Dokumentasi akan berubah seiring perkembangan jaringan.

Karena itu gunakan Git sebagai version control.

Keuntungan:

  • Histori perubahan
  • Audit perubahan
  • Rollback dokumen
  • Kolaborasi tim

Contoh dokumen yang cocok disimpan di Git:

  • SOP
  • Runbook
  • Inventory
  • Catatan perubahan
  • Dokumentasi konfigurasi

Membuat Runbook untuk Layanan Kritis

Apa Itu Runbook?

Runbook adalah panduan langkah demi langkah untuk menangani suatu layanan atau insiden.

Contoh layanan:

  • DNS Server
  • DHCP Server
  • Firewall
  • Hypervisor
  • Database
  • VPN Server

Contoh Struktur Runbook

Nama Layanan

DHCP Server

Gejala Gangguan

Client tidak mendapatkan IP Address.

Langkah Pemeriksaan

  1. Cek status service DHCP.
  2. Cek koneksi jaringan.
  3. Verifikasi pool DHCP.
  4. Verifikasi lease.
  5. Restart service bila diperlukan.

Langkah Recovery

  1. Backup konfigurasi.
  2. Restart service.
  3. Verifikasi lease baru.
  4. Monitoring selama 30 menit.

Dengan format seperti ini siapa pun dalam tim dapat melakukan penanganan awal.


Implementasi Sistem Dokumentasi Jaringan yang Ideal

Berikut kombinasi yang direkomendasikan:

Layer Dokumentasi

NetBox

Digunakan untuk:

  • IPAM
  • VLAN
  • Device Inventory
  • Rack Management

draw.io

Digunakan untuk:

  • Diagram topologi
  • Diagram alur jaringan
  • Dokumentasi visual

Oxidized

Digunakan untuk:

  • Backup konfigurasi otomatis
  • Versioning konfigurasi

Git

Digunakan untuk:

  • SOP
  • Runbook
  • Dokumentasi teknis

Tutorial Implementasi Dokumentasi Jaringan Step-by-Step

Langkah 1: Bangun NetBox

  • Install NetBox di server Linux.
  • Buat site.
  • Tambahkan rack.
  • Tambahkan perangkat.
  • Input subnet dan VLAN.

Langkah 2: Buat Diagram Topologi

  • Gunakan draw.io.
  • Simpan file sumber.
  • Simpan di repository Git.

Langkah 3: Deploy Oxidized

  • Hubungkan ke seluruh router dan switch.
  • Jadwalkan backup otomatis.

Langkah 4: Siapkan Repository Git

  • Simpan SOP.
  • Simpan runbook.
  • Simpan diagram.

Langkah 5: Terapkan Kebijakan Update

Setiap perubahan jaringan wajib:

  • Update NetBox
  • Update topologi
  • Commit ke Git

Tips Agar Dokumentasi Selalu Update

Jadikan Dokumentasi Bagian dari SOP

Setiap perubahan jaringan harus disertai update dokumentasi.

Otomatisasi Sebanyak Mungkin

Gunakan:

  • NetBox
  • Oxidized
  • Git

untuk mengurangi pekerjaan manual.

Audit Berkala

Lakukan audit dokumentasi minimal setiap:

  • Bulanan
  • Triwulanan
  • Semester

Gunakan Template Standar

Dokumentasi yang seragam lebih mudah dipelihara.


Kesimpulan

Dokumentasi jaringan bukan sekadar arsip, melainkan fondasi operasional infrastruktur IT yang sehat.

Menggabungkan NetBox untuk IPAM dan inventaris perangkat, draw.io untuk diagram topologi, Oxidized untuk backup konfigurasi otomatis, Git untuk version control, serta runbook untuk prosedur operasional akan menghasilkan sistem dokumentasi yang akurat, mudah diperbarui, dan benar-benar berguna saat terjadi masalah.

Ingat satu prinsip penting:

Dokumentasi yang sulit diperbarui adalah dokumentasi yang akan ditinggalkan.

Bangun sistem yang sederhana, terpusat, otomatis, dan mudah dipelihara agar dokumentasi selalu menjadi sumber kebenaran yang dapat dipercaya.

Frequently Asked Questions (FAQ)

1. Apa fungsi utama NetBox?

NetBox digunakan sebagai IP Address Management (IPAM), inventaris perangkat jaringan, dokumentasi VLAN, subnet, rack, dan infrastruktur jaringan.

2. Mengapa dokumentasi jaringan harus selalu diperbarui?

Karena dokumentasi yang tidak sesuai kondisi aktual dapat menyebabkan kesalahan troubleshooting, audit, maupun implementasi perubahan jaringan.

3. Apa keuntungan menggunakan Oxidized?

Oxidized dapat melakukan backup konfigurasi perangkat jaringan secara otomatis dan menyimpan riwayat perubahan konfigurasi.

4. Mengapa diagram topologi harus disimpan dalam format draw.io?

Agar mudah diedit dan diperbarui tanpa perlu membuat ulang diagram dari awal.

5. Apakah Git cocok digunakan untuk dokumentasi jaringan?

Ya. Git sangat efektif untuk menyimpan SOP, runbook, catatan perubahan, serta dokumentasi teknis dengan histori revisi yang lengkap.

6. Apa itu Runbook?

Runbook adalah panduan operasional langkah demi langkah untuk menangani layanan, gangguan, recovery, atau prosedur teknis tertentu.

7. Kombinasi tools dokumentasi jaringan yang direkomendasikan?

NetBox + draw.io + Oxidized + Git + Runbook merupakan kombinasi yang sangat efektif untuk dokumentasi jaringan modern.

Bagaimana sistem dokumentasi jaringan yang Anda gunakan saat ini? Apakah masih menggunakan spreadsheet sederhana, atau sudah memanfaatkan NetBox dan otomatisasi backup konfigurasi?

Tuliskan pengalaman Anda di kolom komentar. Jika artikel ini bermanfaat, jangan lupa bagikan kepada rekan administrator jaringan, teknisi, guru TJKT, maupun praktisi IT lainnya.

Ikuti terus artikel terbaru seputar Linux Server, MikroTik, Proxmox, Cloud Computing, DevOps, dan Administrasi Jaringan. Jangan lupa subscribe channel YouTube Walid Umar serta follow Instagram untuk mendapatkan tutorial terbaru setiap hari.

Tinggalkan Balasan

Alamat email Anda tidak akan dipublikasikan. Ruas yang wajib ditandai *

Dilindungi Oleh
Shield Security