Dokümantasyon operasyonda neyi değiştirir?
Kurumsal bir network'te yüzlerce VLAN, switch, firewall, access point, routing kuralı ve farklı lokasyonlar bir arada çalışır. Cihazların doğru yapılandırılması kadar, bu yapılandırmaların anlaşılır ve güncel biçimde dokümante edilmesi de altyapının bir parçasıdır. Yapının nasıl çalıştığı birkaç kişinin bilgisinde yaşadığında, müdahale hızı o kişilerin o an ulaşılabilir olmasına bağlanır; izin, vardiya ya da ekip değişikliği doğrudan operasyona yansır.
Güncel bir doküman bu bilgiyi ekibin tamamına açar. Bir cihazın hangi VLAN'lara hizmet verdiği, uplink bağlantısının nereye gittiği, kritik bir IP adresinin hangi sisteme ait olduğu ya da bir lokasyonun hangi routing yapısını kullandığı tek bakışta bulunur. Arıza ve değişiklik süreçlerinde kazanılan zaman, doğrudan bu hazır bilgiden gelir.
Doküman eskidiğinde ne olur?
Network altyapısı sürekli değişir: yeni bir VLAN eklenir, bir switch değiştirilir, IP bloğu güncellenir, yeni bir lokasyon sisteme katılır. Değişiklikler dokümana işlendikçe doküman altyapıyla eş kalır. Kayıt geride kaldığında ise altyapı ile doküman arasında zamanla büyüyen bir fark oluşur.
Bu fark en çok arıza anında hissedilir. Mühendis dokümana güvenerek eski bir port eşleşmesine ya da devreden çıkmış bir rotaya yönelir, ya da gerçek yapıyı sahada yeniden keşfetmek zorunda kalır. İki durumda da müdahale süresi uzar ve yanlış yapılandırma riski artar. Eskimiş doküman güven telkin ettiği için boş bir sayfadan daha yanıltıcıdır.
İyi bir network dokümantasyonunda neler bulunur?
Her altyapının ihtiyacı farklıdır; temel bölümler ise her kurumda benzerdir. Aşağıdaki tablo bu bölümleri, her birinin taşıdığı bilgiyi ve en çok hangi anda başvurulduğunu özetler.
| Bölüm | Taşıdığı bilgi | En çok başvurulduğu an |
|---|---|---|
| Topoloji ve bağlantılar | Cihazlar arası fiziksel ve mantıksal bağlantılar, uplink'ler ve yedek yollar | Arıza izolasyonu, kapasite planı |
| VLAN ve IP adresleme | VLAN listesi ve amaçları, IP blokları, gateway ve DHCP kapsamları, kritik IP'lerin ait olduğu sistemler | Yeni sistemin devreye alınması, adres çakışması |
| Routing yapısı | Statik rotalar, dinamik routing komşulukları, lokasyonlar arası yol tercihleri | Lokasyon erişim sorunları, WAN değişiklikleri |
| Firewall ve kritik güvenlik kuralları | Güvenlik bölgeleri, kuralların amacı ve sahibi, geçici istisnalar ve bitiş tarihleri | Erişim talepleri, denetim, olay müdahalesi |
| Switch port ve uplink bilgileri | Port ve cihaz eşleşmeleri, port VLAN atamaları, port kanalları, patch panel karşılıkları | Taşınma, cihaz değişimi, sahada müdahale |
| Kablosuz ağ ve SSID'ler | SSID'ler ve amaçları, kimlik doğrulama yöntemi, VLAN eşleşmesi, erişim noktası yerleşimi | Bağlantı şikâyetleri, kapsama genişletme |
| WAN ve VPN bağlantıları | Hat ve devre bilgileri, bant genişlikleri, VPN tünelleri ve uç noktaları | Hat arızası, yeni şube açılışı |
| Cihaz envanteri | Model, seri numarası, yazılım sürümü, konum, destek ve garanti bitiş tarihi | Sürüm yükseltme, yaşam döngüsü planı, garanti işlemleri |
Buradaki amaç bir dosya üretmenin ötesinde, teknik ekibin ihtiyaç anında doğru bilgiye hızla ulaşmasıdır. VLAN ve IP planının tasarım tarafını segmentasyon notunda ele aldık.
Doküman nasıl güncel tutulur?
Dokümantasyon bir kerelik bir proje yerine operasyonun sürekli bir parçasıdır. Güncelliği korumanın en sağlam yolu, doküman güncellemesini değişiklik sürecinin kapanış adımına bağlamaktır: değişiklik kaydı, ilgili bölüm güncellendiğinde ve ikinci bir göz tarafından doğrulandığında kapanır.
- Değişikliğe bağlı güncelleme: Her onaylı değişiklik, etkilediği doküman bölümünü kapsamına alır; kayıt doküman güncellendiğinde kapanır.
- Tek kaynak: Topoloji, IP planı ve envanter tek bir güncel kaynakta tutulur; kopya dosyalar yerine bu kaynağın bağlantısı paylaşılır.
- Otomatik toplanan bilgi: Envanter, yazılım sürümleri, port durumları ve yapılandırma yedekleri cihazlardan düzenli olarak çekilir; mühendis zamanı yorum isteyen bölümlere kalır.
- Bölüm sahipliği: Her bölümün bir sorumlusu olur; firewall kurallarının ve VLAN'ların amacı sahibiyle birlikte yazılır.
- Düzenli karşılaştırma: Doküman belirli aralıklarla canlı yapılandırmayla karşılaştırılır ve fark çıkan her kalem düzeltme listesine girer. Bu karşılaştırma, healthcheck turlarının doğal bir parçasıdır.
Yeni devraldığımız bir altyapıda ilk iş, elimizdeki son çizimi sahadaki gerçek yapıyla karşılaştırmaktır. Keşifte en çok zaman alan kalemler, etiketi eksik kalmış uplink'ler ve amacını yalnızca yazan kişinin bildiği firewall kurallarıdır. Bu yüzden teslim ettiğimiz projelerde kablo, port ve cihaz etiketleri dokümanla birebir eşleşir ve doküman güncellemesini değişiklik kaydının kapanış koşulu olarak işletiriz.
Dokümantasyona nereden başlanır?
Dokümanı eskimiş ya da dağınık bir altyapıda ilk adım keşiftir. Cihazların komşuluk bilgileri (LLDP), ARP ve MAC adres tabloları, routing tabloları ve yapılandırma yedekleri mevcut yapının büyük bölümünü ortaya çıkarır. Keşif çıktısı saha turuyla doğrulanır: kabinetlerde port ve patch panel eşleşmeleri, etiketler ve kablo yolları yerinde kontrol edilir.
Ardından en çok başvurulan bölümler önceliklenir: topoloji, IP planı ve kritik firewall kuralları. Kalan bölümler, değişiklik süreci işledikçe doküman üzerinde tamamlanır. Dokümantasyonu kurulum teslimatının bir parçası olarak Network Altyapısı çözümlerinde, güncel tutulmasını sürekli işletimle birlikte yönetilen hizmetlerde ele alıyoruz.
