Siber Güvenlik

Wazuh Upgrade: Yedek, Sıra ve Agent Yükseltmesi

Wazuh upgrade adım adım: yedeğin içini doğrulamak, indeks snapshot'ı, indexer, manager, Filebeat ve dashboard sırası, kesinti ve eski agent'lar, lab ölçümüyle.

İlker Pehlivan

Wazuh upgrade (sürüm yükseltme), Wazuh’un merkezi bileşenlerini ve agent’larını yeni sürüme taşımaktır. Sıra sabittir: önce indexer, server ve dashboard aynı sürüme çıkar, agent’lar sonra gelir. Yükseltme bir yedekle başlar, çünkü Wazuh’ta geri dönüş paketi eski sürüme indirmekle olmaz.

Bu yazı Wazuh rehberimizin on dördüncü ve son adımıdır. Lab’da tek sunuculu Wazuh’u 4.14.9’dan 4.14.10’a yükselttim. Önce sıranın ne kadar sessiz bozulabildiğini görmek için bir Linux agent’ı server’dan yeni sürüme taşıdım. Sonra belgenin listesiyle yedek aldım ve yedeğin içini saydım. Merkezi bileşenleri belgenin sırasıyla yükselttim, kesintinin ne kadar sürdüğünü ve kurumun kendi ayarlarından hangisinin korunduğunu önce ve sonra ölçtüm. Yedeği hazır olan okur doğrudan merkezi bileşenlerin yükseltmesine geçebilir.

Rehberde agent’ı abonedeki akıllı sayaca, server’ı da arıza merkezine benzettik. Sürüm yükseltmesi, merkezin ve sayaçların yazılımının yenilenmesidir. Üreticinin kuralı basittir. Merkezin yazılımı hiçbir sayacınkinden eski olmamalıdır. Bu yüzden önce merkez, sonra sayaçlar yenilenir. Yenilemeden önce abone kayıtları, yani hangi sayacın kime ait olduğu, ikinci bir deftere kopyalanır. Kayıt kaybolursa her sayacın merkeze yeniden tanıtılması gerekir. Yeni sayaçlar da sandıklarında, merkez hazır olana kadar bekler.

Wazuh’ta abone kayıtları server’daki client.keys dosyasıdır. Kopya defter ise yükseltmeden önce alınan dosya yedeği ve sanal makinenin snapshot’ıdır. Sandıkta bekleyen sayaçlar da merkez yükselene kadar eski sürümde kalan agent’lardır.

Gravür üslubunda bir arıza merkezinin cihaz odası, tavandan sarkan bir gaz lambasının ışığında. Solda önlüklü bir teknisyen uzun ahşap panonun açık yuvasına pirinç yüzlü yeni bir üniteyi iki eliyle sürüyor, yerde açık bir alet sandığı duruyor. Ortadaki masada hırkalı bir memur açık bir defterden yanındaki ikinci deftere kopyalıyor. Sağda kapının yanında kapalı bir tahta sandık var, çıtalarının arasından yeni sayaçların yuvarlak yüzleri görünüyor.
Panoya sürülen yeni ünite önce yenilenen merkezdir: Wazuh'ta indexer, server ve dashboard agent'lardan önce yükseltilir. Memurun kopyaladığı abone defteri client.keys dosyasıdır, ikinci defter de yükseltmeden önce alınan yedek ve snapshot. Kapalı sandıktaki sayaçlar, merkez yükselene kadar eski sürümde bekleyen agent'lardır.

Bu makale Siber Güvenlik ana hizmetimizin güvenlik izleme koluna, özellikle Wazuh’un yedeğine ve sürüm yükseltmesine odaklanır. İzlemenin kimin elinde nasıl yürüdüğünü SIEM hizmeti sayfamızda anlattık. Sunucunun işletim sistemini yükseltmek ayrı bir iştir, onu Ubuntu sürüm yükseltme yazısında anlattık.

Wazuh Güncellemesi Nasıl Olmalı?

Doğru düzende Wazuh deposu sunucularda kapalı durur ve yükseltme bilinçli bir bakım işidir, sıradan bir apt upgrade’in yan etkisi olmaz. Bakım bir yedekle başlar: sanal makinenin snapshot’ı, belgenin saydığı yapılandırma dosyaları ve dashboard’daki kayıtlı nesneler. Yedeğin içi listelenip sayılır. Sonra merkezi bileşenler belgenin sırasıyla aynı sürüme çıkar, agent’lar en son yükseltilir. Kurumun kendi ayarları yükseltmeden önce ve sonra ölçülür.

Bu düzen üç kaynağa dayanıyor:

  • Wazuh belgesi: yükseltme rehberi merkezi bileşenlerin yama düzeyine kadar aynı sürümde olmasını ve server’ın agent’lardan eski olmamasını şart koşar. Merkezi bileşen sayfası yükseltmeden önce indeks snapshot’ı almayı önerir ve 4.11 ve öncesine geri dönülemeyeceğini yazar. Yedeklenecek dosyaların listesi taşıma rehberindedir.
  • NIST SP 800-40r4: kurumsal yama yönetimi rehberi yamanın yan etkisini, geri dönüş için yedekten geri yüklemeyi ve dağıtımdan sonra doğrulamayı planın parçası sayar.
  • NIST SP 800-53, SI-2 ve CP-9(1): kusur giderme denetimi güncellemenin kurulmadan önce yan etkisi için sınanmasını, yedekleme denetimi de yedeğin düzenli olarak sınanmasını ister.
SoruKararNeden
Ne zaman?Bakım penceresinde, sürüm notu okunduktan sonraYükseltme sırasında alarm akışı durur
Önce ne?Snapshot, dosya yedeği, kayıtlı nesneler, indeks snapshot’ı4.11 ve öncesine dönüş yok, paket indirmek geri getirmez
Yedek tamam mı?İçi listelenir, sayılırBelgenin listesi her kurulumda aynı yerde değil
Sıra?Indexer, server, Filebeat, dashboard, sonra agent’larServer agent’tan eski olamaz
Kurum ayarları?Önce ve sonra ölçülürPaket yeni bir yapılandırma getirebilir, güvenlik yedeği bir klasörü yeniden yazar
Agent’lar?Dashboard ya da agent_upgrade ile uzaktanEski agent dashboard’da işaretlenir
Sonra?Depo yeniden kapatılır, Linux agent’ı sabitlenirTers sürüm uyarı vermeden oluşur

Sıra Neden Merkez Önce? Agent Server’dan Yeni Olursa

Belgenin uyumluluk kuralı iki cümledir. Merkezi bileşenler yama düzeyi dahil aynı sürümde olmalıdır. Server da agent’larla aynı sürümde ya da onlardan yeni olmalıdır. Linux agent belgesi aynı gerekçeyle Wazuh deposunun kapatılmasını önerir, çünkü kendiliğinden bir yükseltme agent’ı server’ın önüne geçirebilir.

Rehberin hata tablosundaki bu kazayı lab’da canlandırdım. lnx02’de agent 4.14.9’du, Wazuh deposu yorum satırıydı ve paket hold’daydı. Bu düzeni Wazuh agent yazısında kurmuştuk. Depo satırını açıp paket listesini yeniledim. apt-cache policy aday sürümü 4.14.10-1 olarak gösterdi. Paketi yükseltecek komutun ne yapacağını önce --dry-run ile sordum:

lnx02Bashroot
sudo apt-get install --dry-run wazuh-agent 2>&1 | tail -12
lnx02Bash Çıktısı
Reading package lists...
Building dependency tree...
Reading state information...
Solving dependencies...
The following held packages will be changed:
  wazuh-agent
The following packages will be upgraded:
  wazuh-agent
1 upgraded, 0 newly installed, 0 to remove and 31 not upgraded.
Inst wazuh-agent [4.14.9-1] (4.14.10-1 4.x/apt stable:stable [amd64])
Conf wazuh-agent (4.14.10-1 4.x/apt stable:stable [amd64])

hold paketi apt upgrade gibi toplu yükseltmelerde yerinde tutar. Paketin adını açıkça veren bir kurulum komutunda ise apt tutulan paketi değiştirmeye hazırdır: çıktının ilk satırı The following held packages will be changed diyor. Bu yüzden hold tek başına yetmez, depo da kapalı tutulur. Ardından apt-mark unhold ile tutmayı kaldırıp paketi kurdum. Kurulum yarım dakika kadar sürdü. Agent 4.14.10 oldu, server 4.14.9’da kaldı.

Sonuç beklediğimden farklıydı. Server yeni agent’ı reddetmedi. Agent hemen bağlandı ve Active göründü. Beş dakika boyunca ne server’ın log’unda ne agent’ınkinde sürümle ilgili bir uyarı ya da hata satırı vardı:

Wazuh dashboard'unun Endpoints sayfasındaki agent listesi: server 4.14.9'dayken lnx02 satırında Version sütunu v4.14.10 ve Status sütunu active olarak kırmızı çerçevede, ankmuh01 ve dc01 v4.14.9 ve disconnected
Server 4.14.9'dayken 4.14.10'a çıkan lnx02 bağlı kaldı. Listede bu ters sürümü işaret eden bir uyarı yok.

Bu ölçüm belgenin kuralını boşa çıkarmaz. Lab yalnız bir yama farkını denedi ve bu farkta bağlantının engellenmediğini gösterdi. Daha büyük bir sürüm farkı ölçülmedi. Bağlantının kurulması da agent’ın bütün özelliklerinin server’la uyumlu çalıştığını tek başına göstermez. Belge hangi düzenin desteklendiğini söyler.

Ölçümün asıl dersi sessizliktir. Ters sürüm bu lab’da ne bir alarm ne bir log satırı üretti. Yani bir kurumda depo açık kalırsa agent’ların server’ın önüne geçtiği ancak sürüm sütununa bakan birinin gözüyle fark edilir. Bu yüzden depo kapalı tutulur ve Linux agent’ı hold’da bekler. Yükseltme ise sırayla ve bilerek yapılır.

Wazuh Yedeği: Snapshot, Dosyalar ve Saved Objects

Yedeğin üç parçası vardır. Sanal makinenin snapshot’ı bütün sunucuyu yükseltmeden önceki haline döndürür. Belgenin dosya listesi, sunucu yeniden kurulsa bile agent kayıtlarını, kuralları ve sertifikaları taşır. Dashboard’un kayıtlı nesneleri de indeks desenlerini ve dashboard ayarlarını taşır.

Sanal makinenin snapshot’ı

Snapshot’ı sunucu kapalıyken aldım, çünkü çalışan bir indexer’ın o anda diske yazdığı veri snapshot’ta yarım kalabilir. Sunucu kapatma komutundan birkaç saniye sonra kapandı ve snapshot siem01-19-guncelleme-oncesi adıyla alındı. Yeniden açılışta SSH yarım dakika kadar sonra hazırdı. Dört servisin çalışması ve indexer kümesinin yeşile dönmesi bir dakika kadar sürdü. Kapalı geçen bu süre de bakım penceresine yazılır.

Belgenin dosya yedeği

Dosya listesi Wazuh’un taşıma rehberindedir ve rsync -aREz ile alınır. -R her dosyayı tam yoluyla kopyalar, yani yedek klasöründe /var/ossec/etc/client.keys aynı yolda durur. Belgenin komutlarını tek bir betiğe koydum. Yalnız yedek klasörünü değiştirdim: belge kullanıcının ev klasöründe tarih ve saatli bir klasör açar. Ben /var/backups/wazuh/ altını seçtim ve klasör adından iki noktayı çıkardım. Server’ın dosyaları için belgenin komutu şudur:

siem01Bashroot
rsync -aREz /etc/filebeat/ /etc/postfix/ /var/ossec/api/configuration/ /var/ossec/etc/client.keys /var/ossec/etc/sslmanager* /var/ossec/etc/ossec.conf /var/ossec/etc/internal_options.conf /var/ossec/etc/local_internal_options.conf /var/ossec/etc/rules/local_rules.xml /var/ossec/etc/decoders/local_decoder.xml /var/ossec/etc/shared/ /var/ossec/logs/ /var/ossec/queue/agentless/ /var/ossec/queue/agents-timestamp /var/ossec/queue/fts/ /var/ossec/queue/rids/ /var/ossec/stats/ /var/ossec/var/multigroups/ $bkp_folder

Agent veritabanları (/var/ossec/queue/db/) server dururken kopyalanır. Lab’da server bunun için yarım dakika kadar durdu. Bütün yedek de yarım dakika kadar sürdü ve 153 dosya, 148 MB tuttu. En büyük dosyalar agent veritabanlarıydı. Sıkıştırılmış arşiv 21 MB’tı.

Betiğin çıktısında rsync dört kez hata verdi:

siem01Bash Çıktısı
== [04:00:53] server dosyalari
rsync: [sender] link_stat "/etc/postfix" failed: No such file or directory (2)
rsync error: some files/attrs were not transferred (see previous errors) (code 23) at main.c(1356) [sender=3.4.1]
rsync-cikis=23
== [04:00:54] pem ve authd.pass
rsync: [sender] link_stat "/var/ossec/etc/*.pem" failed: No such file or directory (2)
rsync error: some files/attrs were not transferred (see previous errors) (code 23) at main.c(1356) [sender=3.4.1]
rsync-cikis=23

Çıkış kodu 23, rsync’in “bazı dosyaları aktaramadım” demesidir. Aynı komuttaki diğer dosyalar yine kopyalanır. Dört hatanın nedeni ayrı ayrı okundu:

  1. /etc/postfix yok, çünkü bu sunucuda Postfix kurulu değil.
  2. /var/ossec/etc/*.pem yok. Belge bu satırı “varsa” diye verir ve bu kurulumda o klasörde .pem dosyası yoktu.
  3. Dashboard’un özel görseller için ayrılan klasörü (custom/images) bu kurulumda yok.
  4. Dashboard’un keystore dosyası, yani dashboard’un indexer’a bağlanırken kullandığı parolayı saklayan dosya, belgenin verdiği /usr/share/wazuh-dashboard/config/ yolunda değildi. Bu kurulumda dosya /etc/wazuh-dashboard/opensearch_dashboards.keystore yolundaydı ve yedeğe girmedi.

İlk üçü kurulumda olmayan dosyalardır, dördüncüsü ise gerçek bir eksiktir. Belgenin listesi bütün kurulumların birleşimidir ve her dosya her kurulumda aynı yerde durmaz. Bu yüzden yedeğin içi listelenir ve kritik dosyalar tek tek aranır: client.keys, authd.pass, sslmanager.key, indexer’ın, Filebeat’in ve dashboard’un sertifikaları.

Lab yedeğinde client.keys 3 satırdı, yani üç agent’ın kaydı yedekteydi. Eksik keystore’u gerçek yolundan ayrıca ekledim ve arşivi yeniden aldım. Sonra her sertifikanın ve keystore’un yedekteki kopyasını kaynağıyla sha256 hash’inden karşılaştırdım. On altı dosyanın on altısı eşitti.

Arşiv sertifika anahtarlarını, agent kayıt parolasını ve agent anahtarlarını taşır. Bu yüzden yalnız root okuyabilir (chmod 600) ve sunucunun dışına şifreli bir yedek alanına gider. Genel yedekleme düzenini veri yedekleme ve felaket kurtarma yazısında anlattık.

Dashboard’un kayıtlı nesneleri

Belge, dashboard’da yapılan özelleştirmelerin dışa aktarılmasını önerir. Dashboard’da sol menüden Dashboard management > Dashboards Management > Saved objects açılır ve Export all objects seçilir:

Wazuh dashboard'unun Saved Objects sayfası: soldaki menüde Saved objects ve sağ üstte Export all objects düğmesi kırmızı çerçevede, listede Advanced Settings ve wazuh-alerts, wazuh-monitoring, wazuh-statistics gibi altı indeks deseni
Lab'daki dashboard'da yedi kayıtlı nesne vardı: dashboard ayarları ve altı indeks deseni.

İnen dosya .ndjson biçimindedir ve lab’da 204 KB’tı. Kurum kendi görselleştirmelerini ya da dashboard’larını kurduysa liste daha uzundur ve asıl kaybedilecek iş buradadır.

İndeks snapshot’ı

Belgenin merkezi bileşen sayfası yükseltmeden önce indekslerin snapshot’ını almayı önerir. Bu, alarmların ve agent envanterinin indexer’daki kopyasıdır. Dosya yedeği bunları taşımaz. VM snapshot’ı taşır, ama yalnız bütün sunucuyla birlikte geri döner.

Indexer bir snapshot’ı yalnız tanımlı bir klasöre yazar. Lab’daki kurulumda bu klasör tanımlı değildi: opensearch.yml dosyasında path.repo satırı yoktu. Yani belgenin önerisi, kurulumdan sonra ayrıca bir ayar yapılmadan uygulanamaz. Satırı ekledim, klasörü indexer kullanıcısına verdim ve indexer’ı yeniden başlattım:

siem01Bashroot
sudo cp -a /etc/wazuh-indexer/opensearch.yml /etc/wazuh-indexer/opensearch.yml.yedek-g && echo "path.repo: [\"/var/backups/wazuh-indexer-snapshot\"]" | sudo tee -a /etc/wazuh-indexer/opensearch.yml >/dev/null; sudo mkdir -p /var/backups/wazuh-indexer-snapshot && sudo chown wazuh-indexer:wazuh-indexer /var/backups/wazuh-indexer-snapshot && sudo chmod 750 /var/backups/wazuh-indexer-snapshot; sudo tail -3 /etc/wazuh-indexer/opensearch.yml; ls -ld /var/backups/wazuh-indexer-snapshot; date +%T; sudo systemctl restart wazuh-indexer; echo restart-cikis=$?; date +%T

Yeniden başlatma yarım dakika kadar sürdü. İlk iki sağlık sorgusu OpenSearch Security not initialized. döndü, küme yarım dakika kadar sonra yeşildi. Bu ayar bir kez yapılır, sonraki yükseltmelerde yalnız snapshot alınır. Snapshot indexer’ın REST API’sine iki istekle alınır. Önce PUT _snapshot/yedek isteği, {"type":"fs","settings":{"location":"/var/backups/wazuh-indexer-snapshot"}} gövdesiyle klasörü yedek adlı bir snapshot deposu olarak tanıtır. Sonra PUT _snapshot/yedek/oncesi-4-14-9?wait_for_completion=true isteği snapshot’ı alır ve bitene kadar bekler.

Snapshot birkaç saniye sürdü. Kümedeki 36 shard’ın 36’sı da SUCCESS ile yazıldı ve klasör 25 MB tuttu. Canlı bir kurulumda bu süre ve boyut indekslerin büyüklüğüyle artar. Snapshot klasörü de indexer’la aynı diskteyse, diskin kendisi bozulduğunda işe yaramaz.

Merkezi Bileşenleri Yükseltmek: Indexer, Manager, Filebeat, Dashboard

Belgenin sırası hazırlık, indexer, manager, Filebeat ve dashboard’dur. Komutları belgenin merkezi bileşen sayfasından aldım. Yükseltme boyunca ayrı bir pencereden her birkaç saniyede bir dashboard’un 443 portunu ve agent’ların bağlandığı 1514 portunu yokladım, böylece kesintinin nerede başlayıp bittiği kayda geçti.

Hazırlık: depo, güvenlik yedeği, durdurma

İlk iş Wazuh deposunu açmaktır. Kurulumda depo satırı yorum yapılmıştı:

siem01Bashroot
sudo sed -i "s/^#deb /deb /" /etc/apt/sources.list.d/wazuh.list

apt-get update sonrasında indexer, manager ve dashboard için aday sürüm 4.14.10-1 oldu. Filebeat’in adayı kurulu sürümle aynıydı: 7.10.2-2.

Sonra indexer’ın güvenlik yapılandırması, yani kullanıcılar, roller ve rol eşlemeleri, çalışan kümeden dosyalara yedeklenir:

siem01Bashroot
/usr/share/wazuh-indexer/bin/indexer-security-init.sh --options "-backup /etc/wazuh-indexer/opensearch-security -icl -nhnv"

Betik on yapılandırma türünü /etc/wazuh-indexer/opensearch-security/ altına yazdı ve her biri için SUCC döndü. Ardından Filebeat ve dashboard durdurulur. Indexer’a shard’ları yalnız birincil kopyalar için dağıtması söylenir (cluster.routing.allocation.enable: primaries) ve bellekteki yazılar diske aktarılır (_flush). Lab’da _flush 33 shard’ın 33’ünde başarılı döndü. En son manager durdurulur. Kesinti burada başlar: agent’lar artık bağlanamaz ve dashboard kapalıdır.

Indexer

Indexer durdurulur ve jvm.options dosyası jvm.options.old adıyla kopyalanır. Paket şu komutla kuruldu:

siem01Bashroot
DEBIAN_FRONTEND=noninteractive apt-get install -y -o Dpkg::Options::=--force-confdef -o Dpkg::Options::=--force-confold wazuh-indexer

--force-confold, dpkg’ye yerelde değiştirilmiş bir yapılandırma dosyasını korumasını söyler. Paket o dosyanın yeni bir halini getirirse yanına .dpkg-dist uzantısıyla koyar. Belge jvm.options için ayrı bir soru sorar: yenisi mi kullanılsın, eskisi mi? Lab’da paket yeni bir jvm.options getirmedi. /etc/wazuh-indexer/ altında .dpkg-dist dosyası oluşmadı, jvm.options’ın sha256 hash’i yükseltmeden önceki kopyasıyla aynı kaldı ve kurulumda 2560 MB’a çıkardığımız heap satırları yerindeydi.

Paket 875 MB’tı ve indirmeyle birlikte kurulum birkaç dakika sürdü. Indexer başlatıldıktan yarım dakika kadar sonra API cevap verdi. Ardından güvenlik yapılandırması yeniden yüklenir, shard dağıtımı yeniden all yapılır ve kümenin yeşile dönmesi beklenir:

siem01Bashroot
/usr/share/wazuh-indexer/bin/indexer-security-init.sh

Küme aynı saniyede yeşildi, unassigned_shards 0’dı. opensearch-plugin list on yedi eklentiyi listeledi.

Burada bir tuzak var. Indexer’ın kök adresine sürüm sorulduğunda "number" : "7.10.2" döner, 4.14.10 değil. Bunun nedeni opensearch.yml’deki compatibility.override_main_response_version: true satırıdır. Bu satırla indexer kendini Filebeat-OSS 7.10.2’nin beklediği sürümle tanıtır. Indexer’ın gerçek sürümü paket listesinden okunur.

Manager

Manager aynı dpkg seçenekleriyle kuruldu. Paket 622 MB’tı ve kurulum yaklaşık 5 dakika sürdü. ossec.conf’un ve local_rules.xml’in sha256 hash’leri değişmedi, /var/ossec/etc/ altında .dpkg-dist dosyası oluşmadı. Manager başlayınca wazuh-control info -v v4.14.10 döndü.

Manager açılırken kendi veritabanının bir yedeğini de aldı. ossec.log’da şu satırlar vardı:

siem01Çıktı
2026/11/14 04:16:00 wazuh-db: INFO: Created Global database backup "backup/db/global.db-backup-2026-11-14-04:16:00-pre_upgrade.gz"
2026/11/14 04:16:00 wazuh-db: INFO: Deleted Global database backup: "backup/db/global.db-backup-2026-11-05-18:18:47.gz"

Bu otomatik yedek agent listesinin tutulduğu veritabanını kapsar, dosya yedeğinin yerini tutmaz. Yeni yedek alınırken eskilerinden biri silindi, yani sunucuda sınırlı sayıda kopya tutuluyor.

Belge iki adımı yalnız eski sürümlerden gelenler için ister: 4.12 ve öncesinden gelenler için CDB listelerinin ossec.conf’a eklenmesi, 4.7 ve öncesinden gelenler için zafiyet tespiti bloğunun yenilenmesi. 4.14.9’dan gelen lab’da ikisi de zaten yerindeydi. Manager’ın log’unda yükseltmeden sonra yeni bir ERROR satırı yoktu: dosyadaki 9 hata satırının en yenisi yükseltmeden iki saat önceydi.

Manager çalışmaya başlayınca 1514 portu yeniden açıldı. Agent’lar için kesinti yaklaşık 10 dakika sürdü.

Filebeat

Filebeat’te üç parça yenilenir: Wazuh modülü, alarm indeksinin şablonu ve paket. Modül belgenin adresinden indirilip açılır. Şablon yeni sürümün etiketinden indirilir:

siem01Bashroot
curl -s https://packages.wazuh.com/4.x/filebeat/wazuh-filebeat-0.5.tar.gz | tar -xvz -C /usr/share/filebeat/module
curl -so /etc/filebeat/wazuh-template.json https://raw.githubusercontent.com/wazuh/wazuh/v4.14.10/extensions/elasticsearch/7.x/wazuh-template.json

4.14.10’un şablonu öncekiyle bayt bayt aynıydı. Filebeat paketi de değişmedi, filebeat is already the newest version (7.10.2-2) yazdı. filebeat.yml yine de belgenin dediği gibi önce yedeklenip geri konur. Sonra boru hatları ve indeks yönetimi yeniden yüklenir:

siem01Bashroot
filebeat setup --pipelines
filebeat setup --index-management -E output.logstash.enabled=false

Kurulumda alarm indeksleri için yazdığımız wazuh-custom şablonu bu adımdan sonra da yerindeydi: sırası (order) 1, shard sayısı 1. Fabrikanın wazuh şablonu ise sırası 0 ile 3 shard istiyordu. İki şablon aynı indekslere uyduğunda sırası yüksek olanın ayarı geçerlidir. filebeat test output her satırda OK verdi.

Dashboard

Dashboard da aynı dpkg seçenekleriyle kuruldu. opensearch_dashboards.yml’in sha256 hash’i değişmedi ve .dpkg-dist dosyası oluşmadı. Paket 196 MB’tı, ama kurulumu manager’ın 622 MB’lık paketinden daha uzun sürdü. Dashboard başlatıldıktan yarım dakika kadar sonra 443 portu yeniden cevap verdi.

Kesinti ne kadar sürdü?

AdımSürePaket
Hazırlık (güvenlik yedeği, durdurma)Birkaç saniye
Indexer kurulumuBirkaç dakika875 MB
Indexer’ın açılıp yeşile dönmesiYarım dakika kadar
Manager kurulumuYaklaşık 5 dakika622 MB
Filebeat (modül, şablon, setup)Birkaç saniyedeğişmedi
Dashboard kurulumu ve açılışıYaklaşık 5 dakika196 MB
Agent’lar bağlanamadıyaklaşık 10 dakika
Dashboard kapalıyaklaşık 15 dakika

Tablodaki adımların toplamı ölçülen kesintilerden kısadır, dashboard için yaklaşık bir dakika. Aradaki fark adımların arasında geçen süredir.

Kesintinin neredeyse hepsi paket kurulumlarıydı. Bu sürelere paketlerin indirilmesi de dahildir, lab’da indirme ile kurulum ayrı ölçülmedi. Paketler bakım penceresinden önce apt-get install --download-only ile indirilebilir, ama bunun kesintiyi ne kadar kısalttığı ölçülmedi.

Agent’ların bu sürede olay kaybedip kaybetmediği yükseltme sırasında ölçülmedi. Sağlık kontrolü yazısındaki denemede server üç dakika durmuştu ve o dakikalardaki olayların hepsi server dönünce alarm oldu. Olaylar kaybolmasa bile, kesinti sırasında gelen bir saldırının alarmı dakikalar sonra düşer. Bu yüzden yükseltme bir bakım penceresine konur ve ekip bundan haberdar edilir.

Yükseltme Hangi Ayarı Ezer?

Yükseltmeden önce ve sonra aynı ölçümü aldım: kurulumdan sonra elle değiştirdiğimiz her dosyanın sha256 hash’i, indexer’ın heap’i ve bellek kilidi, şablonlar, saklama policy’si ve firewall kuralları.

AyarNeredeYükseltmeden sonra
Heap 2560 MBjvm.optionsDeğişmedi: hash eşit, heap_max_in_bytes 2684354560
Bellek kilidiopensearch.yml, systemd ek dosyasıDeğişmedi: mlockall: true
Indexer ayarları, path.repoopensearch.ymlDeğişmedi
Dashboard ayarlarıopensearch_dashboards.ymlDeğişmedi
Filebeat çıkışıfilebeat.ymlDeğişmedi
Server yapılandırmasıossec.confDeğişmedi
Özel kurallarlocal_rules.xmlDeğişmedi
Agent grup ayarlarıshared/*/agent.confDördü de değişmedi
Tek shard şablonuwazuh-customYerinde, sırası 1
90 günlük saklamaISM policy’siYerinde
FirewallufwBeş kural yerinde
Rol eşlemeleriopensearch-security/roles_mapping.ymlDeğişti

Bu sürüm geçişinde paketler kurumun hiçbir ayarını ezmedi. Değişen tek dosyayı da paket değil, hazırlıktaki güvenlik yedeği değiştirdi. indexer-security-init.sh -backup seçeneğiyle kümedeki canlı yapılandırmayı /etc/wazuh-indexer/opensearch-security/ altındaki dosyaların üstüne yazar. Lab’da on dosyanın onu da 04:07:14’te, yani yedek adımında yeniden yazıldı. roles_mapping.yml’deki fark yalnız silinen yorum ve boş satırlardı, eşlemelerin kendisi aynıydı.

Bu dosyalara elle not yazan ya da kümeye yüklemediği bir değişikliği orada bekleten biri, o notu bu adımda kaybeder. Dosyaların eski hali yalnız yükseltmeden önce alınan dosya yedeğinde kalır.

Lab’daki sonuç bir sonraki yükseltmeye garanti değildir. Paket bir sürümde yeni bir jvm.options getirebilir ya da şablonu değiştirebilir. Bu yüzden ölçüm her yükseltmede tekrarlanır. Önce hash’ler alınır, sonra karşılaştırılır.

Depoyu Kapatmak ve Alarm Akışını Sınamak

Yükseltme bitince Wazuh deposu server’da yeniden yorum satırı yapılır:

siem01Bashroot
sudo sed -i "s/^deb /#deb /" /etc/apt/sources.list.d/wazuh.list

lnx02’de depo, ters sürüm deneyinden beri açıktı ve hold kaldırılmıştı. İkisi de geri alındı. Aynı satırda alarm akışını sınamak için üç sahte SSH satırı üretildi:

lnx02Bashroot
sudo sed -i "s/^deb /#deb /" /etc/apt/sources.list.d/wazuh.list; cat /etc/apt/sources.list.d/wazuh.list; sudo apt-mark hold wazuh-agent; apt-mark showhold; sudo apt-get update 2>&1 | tail -1; apt-cache policy wazuh-agent | head -3; for i in 1 2 3; do logger -p auth.info -t sshd "Invalid user guncellemedeneme$i from 192.168.1.250 port 5$i"; done; date +%T
lnx02Bash Çıktısı
#deb [signed-by=/usr/share/keyrings/wazuh.gpg] https://packages.wazuh.com/4.x/apt/ stable main
wazuh-agent set on hold.
wazuh-agent
Reading package lists...
wazuh-agent:
  Installed: 4.14.10-1
  Candidate: 4.14.10-1
01:25:47

Üç satır iki saniye içinde alerts.json’a 5710 (seviye 5) alarmı olarak düştü. Yani yükseltilmiş server, Filebeat ve indexer zinciri olayı uçtan uca taşıyordu.

Wazuh Agent Upgrade: Eski Agent’ları Bulmak ve Yükseltmek

Server yükselince eski sürümde kalan agent’lar dashboard’da işaretlenir. Belgeye göre Agents management > Summary listesinde sürümün yanındaki kırmızı nokta, agent’ın server’dan eski bir sürümde çalıştığını gösterir. İmleç noktanın üstüne gelince Outdated etiketi çıkar. Lab’da server 4.14.10’a çıkınca 4.14.9’daki iki Windows agent’ı bu noktayla işaretlendi:

Wazuh agent upgrade öncesi Endpoints listesi: server 4.14.10'dayken ankmuh01 ve dc01 satırlarında Version sütunundaki v4.14.9 ve yanındaki kırmızı nokta kırmızı çerçevede, lnx02 v4.14.10
Server yükseldikten sonra 4.14.9'da kalan iki agent'ın sürümünün yanında kırmızı nokta çıktı. 4.14.10'daki lnx02'de nokta yok.

Belge agent’ları uzaktan yükseltmenin üç yolunu verir:

  1. Dashboard: listede agent’lar seçilir, More > Upgrade agents ile yükseltilir. Tek bir agent için satırındaki … menüsünden Upgrade seçilir. Bu seçenek yalnız bağlı ve eski sürümdeki agent’larda görünür.
  2. Komut satırı: server’da /var/ossec/bin/agent_upgrade -l eski agent’ları listeler, agent_upgrade -a 002 kimliği verilen agent’ı yükseltir.
  3. Server API: PUT /agents/upgrade. Belge birden çok sunuculu kümelerde bu yolu önerir.

Üç yolda da server agent’a imzalı bir yükseltme paketi gönderir ve agent kendini yükseltir. Agent’ın bunun için bağlı olması gerekir. Kapalı bir makinedeki agent listede disconnected görünür ve yükseltilemez.

Lab’da muhasebe bilgisayarı ankmuh01’i açtım ve Windows agent’ını komut satırı yoluyla yükselttim. Önce server’da eski sürümdeki agent’ları listeledim:

siem01Bashroot
sudo /var/ossec/bin/agent_upgrade -l
siem01Bash Çıktısı
ID    Name                                Version
002   ankmuh01                            Wazuh v4.14.9
003   dc01                                Wazuh v4.14.9

Total outdated agents: 2

Sonra yalnız ankmuh01’in agent’ını, yani 002 kimliğini yükselttim:

siem01Bashroot
sudo /var/ossec/bin/agent_upgrade -a 002
siem01Bash Çıktısı
Upgrading...

Upgraded agents:
	Agent 002 upgraded: Wazuh v4.14.9 -> Wazuh v4.14.10

Komut yaklaşık 2 dakika sürdü. Agent yükseltmeyi bitirince server’a bir bildirim gönderdi ve server bunu kendi ossec.log dosyasına yazdı:

siem01Çıktı
2026/11/14 04:36:09 wazuh-modulesd:agent-upgrade: INFO: (8164): Received upgrade notification from agent '2'. Error code: '0', message: 'Upgrade was successful'

Hata kodu 0, yükseltmenin başarılı bittiğini söylüyor. Ardından agent_control -i 002, ankmuh01’i Active ve Client version: Wazuh v4.14.10 olarak gösterdi. agent_upgrade -l listesinde yalnız dc01 kaldı. Dashboard da görevi kaydetti:

Wazuh agent upgrade sonrası Endpoints listesi: Upgrade tasks kutusundaki 1 Done ve ankmuh01 satırının Version sütunundaki v4.14.10 kırmızı çerçevede, ankmuh01 active, dc01 v4.14.9 ve yanında kırmızı nokta
Yükseltme görevi 1 Done olarak kapandı. ankmuh01'in sürümü v4.14.10, kırmızı noktası kalktı. Kapalı olan dc01 4.14.9'da duruyor.

Bu doğrulamaların hepsi server tarafındadır. Aynı sonuç Windows makinesinin kendi tarafında da okunur. ankmuh01’de Control Panel > Programs > Programs and Features listesinde Wazuh Agent satırı 4.14.10 sürümünü ve yükseltme gününün tarihini gösterdi:

Wazuh agent upgrade sonrası Windows'ta Programs and Features listesi: Wazuh Agent satırı kırmızı çerçevede, Publisher Wazuh, Inc., Installed On 14.11.2026, Size 17,9 MB, Version 4.14.10
Uzaktan yükseltmeden sonra ankmuh01'in kurulu programlar listesi. Wazuh Agent 4.14.10, kurulum tarihi yükseltme günü.

Aynı bilgi PowerShell’den de okunur:

ankmuh01PowerShellYönetici
Get-Package -Name '*Wazuh*' | Format-List Name,Version,ProviderName
ankmuh01PowerShell Çıktısı
Name         : Wazuh Agent
Version      : 4.14.10
ProviderName : msi

Kayıt defterindeki kaldırma kaydında da DisplayVersion 4.14.10’du ve Get-Service WazuhSvc hizmeti Running gösterdi.

Windows agent’ı yükseltmenin adımlarını C:\Program Files (x86)\ossec-agent\upgrade\upgrade.log dosyasına yazar. Lab’daki dosyanın tamamı şuydu:

ankmuh01Çıktı
2026-11-14 04:34:19Z - Sysnative Powershell will be used to access the registry.
2026-11-14 04:34:24Z - Found Wazuh installation at: HKLM:\SOFTWARE\WOW6432Node\Wazuh, Inc.\Wazuh Agent\WazuhInstallDir = C:\Program Files (x86)\ossec-agent\
2026-11-14 04:34:24Z - Extracted version from VERSION.json : 4.14.9.
2026-11-14 04:34:24Z - Current version: 4.14.9.
2026-11-14 04:34:24Z - Extracting the version from MSI file.
2026-11-14 04:34:26Z - MSI new version: v4.14.10.
2026-11-14 04:35:27Z - Starting upgrade process.
2026-11-14 04:35:27Z - Installing MSI to: C:\Program Files (x86)\ossec-agent\ (msiexec.exe /i wazuh-agent-4.14.10-1.msi APPLICATIONFOLDER="C:\Program Files (x86)\ossec-agent\" WIXUI_INSTALLDIR=APPLICATIONFOLDER REBOOT=ReallySuppress /qn /l*v installer.log)
2026-11-14 04:35:35Z - msiexec finished with exit code: 0.
2026-11-14 04:35:35Z - Extracted version from VERSION.json : 4.14.10.
2026-11-14 04:35:35Z - Starting Wazuh-Agent service.
2026-11-14 04:35:37Z - Installation finished.
2026-11-14 04:35:37Z - Process ID: 2236.
2026-11-14 04:35:48Z - Reading status file: status='connected'.
2026-11-14 04:35:48Z - Extracted version from VERSION.json : 4.14.10.
2026-11-14 04:35:48Z - Upgrade finished successfully. New version: 4.14.10.

Agent paketi 04:34’te açtı ve yeni sürümü okudu. Kurulum 04:35:27’de başladı ve birkaç saniyede bitti, msiexec 0 koduyla çıktı. Agent hizmeti yeniden başladı, on saniye kadar sonra server’a bağlandığını gördü ve yükseltmeyi başarılı saydı. Server’ın ossec.log’undaki bildirim yarım dakika kadar sonra, 04:36:09’da geldi.

Satırlardaki Z eki normalde UTC saatini gösterir, ama bu dosyada saatler yereldir. ankmuh01’in saat dilimi Turkey Standard Time’dı. Windows’un event log’u ile server’ın log’u aynı anları aynı saatle yazdı. Bu log başka log’larla karşılaştırılırken üç saatlik fark aranmaz.

Agent’ın kendi ossec.log dosyasında yükseltme için ayrı bir satır yoktu. Yükseltme, yeni sürümle yapılan bir açılış olarak görünür:

ankmuh01Çıktı
2026/11/14 04:35:39 wazuh-agent: INFO: Windows version is 6.0 or newer. (Microsoft Windows 11 Pro [Ver: 10.0.26300.9711] |ANKMUH01 |x86_64 - Wazuh v4.14.10).
2026/11/14 04:35:39 wazuh-modulesd:agent-upgrade: INFO: (8153): Module Agent Upgrade started.

Yani yükseltmenin adımları upgrade.log’da, sonucu ise ossec.log’daki sürüm satırında okunur.

Linux agent’ı paket yöneticisiyle de yükseltilebilir. Bunu ters sürüm deneyinde yaptım: depo açıldı, hold kaldırıldı ve paket kuruldu. Yükseltmeden sonra depo yeniden kapatılır ve paket yeniden hold’a alınır. Wazuh agent yazısında Windows agent’ını bir GPO başlangıç betiğiyle kurmuştuk. O betik kurulu sürüm hedef sürümden eski değilse kurulumu atlar. Yani agent’lar uzaktan yükseltildiyse betiğin hedef sürümü de yeni sürüme çekilir, yoksa yeni kurulan bir makine eski sürümle gelir.

Wazuh Güncellemesi Doğru Yapıldı mı?

Yükseltmenin bittiğini altı ölçüm birlikte söyler:

  1. Paketler: apt list --installed 'wazuh-*' filebeat indexer, manager ve dashboard için 4.14.10-1 gösterir. Filebeat 7.10.2-2’de kalır.
  2. Server: wazuh-control info -v v4.14.10 döndürür.
  3. Dashboard: /app/about adresindeki About sayfası uygulama sürümünü gösterir.
  4. Küme: _cluster/health yeşildir ve unassigned_shards 0’dır. Lab’da yükseltmeden önce de sonra da 36 shard’ın hepsi yerindeydi.
  5. Alarm akışı: bir agent’tan üretilen sahte olay alerts.json’a alarm olarak düşer.
  6. Windows agent’ı: upgrade.log’un son satırı Upgrade finished successfully yazar ve Programs and Features listesi yeni sürümü gösterir.
Wazuh dashboard'unun About sayfası: üstteki bantta App version 4.14.10 satırı kırmızı çerçevede, altında Welcome to the dashboard ve Community kartları
Yükseltmeden sonra dashboard'un About sayfası 4.14.10 gösteriyor. Indexer'ın kök adresinin döndürdüğü 7.10.2 ise uyumluluk için verilen sürümdür.

Bu beş ölçüm Wazuh sağlık kontrolü yazısındaki günlük listenin kısa halidir. Yükseltmeden sonraki ilk gün o listenin tamamı okunur: servisler, Filebeat bağlantısı, disk ve kopan agent’lar.

Geri Dönüş: Snapshot, Dosya Yedeği ve İndeks Snapshot’ı

Wazuh’ta geri dönüş, paketi eski sürüme indirmek değildir. Belge 4.11 ve öncesine dönülemeyeceğini açıkça yazar, çünkü 4.12’den bu yana indexer’ın kullandığı Apache Lucene sürümü eskiye dönüşü desteklemez. Yama düzeyinde bir paket indirme bu lab’da denenmedi. Belgenin tarif ettiği yollar yedeklerdir:

YolNeyi geri getirirNe zaman
VM snapshot’ıBütün sunucuyu, snapshot anındaki haliyleYükseltme yarıda kaldıysa ya da sunucu açılmıyorsa
Dosya yedeğiAgent kayıtlarını, kuralları, sertifikaları, yapılandırmayıYeni bir sunucuya taşırken ya da yeniden kurarken
İndeks snapshot’ıAlarmları ve agent envanteriniIndexer’ın verisi bozulduysa
Kayıtlı nesnelerİndeks desenlerini, dashboard’larıDashboard’daki özelleştirmeler kaybolduysa

VM snapshot’ına dönmenin bir bedeli vardır: snapshot’tan sonra gelen bütün alarmlar ve agent değişiklikleri de geri gider. Bu yüzden yükseltmeden hemen önce alınır ve yükseltme başarılı olunca bir süre sonra silinir. Bu turda geri dönüş denenmedi, çünkü yükseltme sorunsuz bitti. Bir yedeğin çalıştığı ise ancak geri yüklenince görülür. NIST SP 800-53’ün CP-9(1) denetiminin istediği de budur.

Wazuh Güncellemesinde Sık Yapılan Hatalar

  • Depoyu açık bırakmak: sıradan bir apt upgrade agent’ı server’ın önüne geçirebilir. Lab’da bu ters sürüm ne alarm ne log satırı üretti.
  • hold’u tek önlem sanmak: paketin adını veren bir kurulum komutunda apt tutulan paketi değiştirmeye hazırdır. --dry-run bunu The following held packages will be changed diye söyler.
  • rsync’in çıkış kodunu okumadan geçmek: kod 23 “bazı dosyalar aktarılmadı” demektir. Lab’da dört satırın üçü kurulumda olmayan dosyaydı, biri gerçek bir eksikti.
  • Belgenin yollarını kurulumun yolları sanmak: dashboard keystore belgenin verdiği yolda değildi ve ilk yedeğe girmedi.
  • İndeks snapshot’ını yükseltme günü kurmaya çalışmak: path.repo fabrika ayarında tanımlı değildir ve indexer’ın yeniden başlatılmasını ister. Bir kez, önceden kurulur.
  • Indexer’ın kök adresindeki sürüme bakmak: uyumluluk ayarı yüzünden 7.10.2 döner. Sürüm paket listesinden okunur.
  • Güvenlik yapılandırması dosyalarına not saklamak: indexer-security-init.sh -backup bu dosyaları kümedeki canlı yapılandırmayla yeniden yazar.
  • Kesintiyi birkaç dakika sanmak: lab’da agent’lar yaklaşık 9, dashboard yaklaşık 16 dakika ulaşılamaz oldu.

Sonuç: Yükseltme Bir Komut, Hazırlığı Bir Liste

Wazuh upgrade, belgenin sırasıyla indexer, manager, Filebeat ve dashboard’u aynı sürüme taşımak, agent’ları da en son yükseltmektir. Lab’da 4.14.9’dan 4.14.10’a geçiş kurumun hiçbir ayarını ezmedi ve agent’lar yaklaşık 9 dakika bağlanamadı. Asıl iş komutlardan önceydi. Yedeğin içi sayılınca belgenin listesinin bu kurulumdaki keystore’u kaçırdığı görüldü. İndeks snapshot’ı için gereken klasör tanımlı değildi. Depo açık kalınca da agent server’ın önüne hiçbir uyarı vermeden geçti.

Girişteki benzetmeye dönersek: merkezin yazılımı yenilenmeden önce abone defteri kopyalanır ve kopya sayfa sayfa karşılaştırılır. Wazuh’ta bu, client.keys’i, sertifikaları ve keystore’ları taşıyan yedeğin içinin listelenmesidir. Sandıktaki yeni sayaçlar da merkez hazır olunca takılır, yani agent’lar server’dan sonra yükseltilir.

Bu yazı Wazuh rehberinin son adımıydı. Rehberin bütün adımları ve sırası Wazuh rehberimizde.

Wazuh Güncellemesi Hakkında Sık Sorulan Sorular

Lab'da tek sunuculu Wazuh'u 4.14.9'dan 4.14.10'a yükseltirken agent'lar yaklaşık 10 dakika server'a bağlanamadı, dashboard 15 dakika kadar kapalı kaldı. Sürenin neredeyse hepsi paket kurulumlarıydı: indexer paketi 875 MB, manager paketi 622 MB, dashboard paketi 196 MB'tı. Hazırlık ayrıca zaman alır: sanal makinenin kapatılıp snapshot'ının alınması ve yeniden açılması yaklaşık bir buçuk dakika, dosya yedeği yarım dakika kadar sürdü.
Belge bu düzeni desteklemez: server agent'larla aynı sürümde ya da onlardan yeni olmalıdır. Lab'da yama farkında, yani 4.14.9 server ile 4.14.10 agent arasında, agent bağlandı ve ne alarm ne log satırı üretti. Daha büyük bir sürüm farkı ölçülmedi. Ters sürüm sessiz oluştuğu için Wazuh deposu kapalı tutulur ve Linux agent'ı hold'a alınır.
Lab'daki 4.14.10 yükseltmesinde silmedi. Heap ayarı, ossec.conf, özel kurallar, tek shard şablonu, saklama policy'si ve firewall kuralları değişmeden kaldı. Değişen tek dosya indexer'ın rol eşlemesiydi ve onu paket değil, hazırlıktaki güvenlik yedeği komutu yeniden yazdı. Paket başka bir sürümde yeni bir yapılandırma getirebilir, bu yüzden dosyaların hash'i her yükseltmeden önce ve sonra karşılaştırılır.
İlker Pehlivan
Yazan

BT Danışmanı | Ağ, Sistem ve Güvenlik Yönetimi

İlker Pehlivan, karmaşık BT altyapılarını ölçeklenebilir ve güvenli sistemlere dönüştürür. Buradaki rehberleri kendi laboratuvarında kurup ölçerek yazar.

LinkedIn

Benzer Makaleler

Wazuh Rehberi: Kurulumdan Alarma Adım Adım SIEM

Wazuh rehberi: kurulumdan agent'a, Windows log'undan e-posta alarmına on dört adımlık sıra. Her adım hangi kurumda gerekir, fabrika ayarı ne, lab'da ne ölçtük.

16 dk okuma

SIEM Hizmeti: Yönetilen Güvenlik İzleme ve Müdahale

SIEM hizmeti: domain controller, firewall, VPN ve sunucu logları tek yerde toplanır, kurallarla okunur, şüpheli olayda aynı ekip müdahale eder. Kapsam ve fiyat.

10 dk okuma

Wazuh Active Response: Otomatik Engelleme ve Muafiyet

Wazuh active response: SSH ve Windows brute force kaynağını firewall-drop ve netsh ile süreli engellemek, white_list ve kural seçimi, lab ölçümüyle.

23 dk okuma

Wazuh Health Check: Servis, Indexer ve Kopan Agent

Wazuh health check: wazuh-control status, indexer kümesinin rengi, Filebeat, disk, kopan agent alarmı ve e-posta eşiği, günlük ve haftalık liste, lab ölçümüyle.

18 dk okuma

Wazuh Active Directory İzleme: DC Olayından Alarma

Wazuh ile Active Directory izleme: domain controller'a agent, hazır Windows kurallarının seviyeleri, kilit zinciri, frekans eşiği ve özel kural, lab ölçümüyle.

22 dk okuma

Wazuh Agent Kurulumu: Windows'a GPO, Linux'a apt

Wazuh agent kurulumu: fabrikada parolasız gelen kaydı parolaya bağlamak, Windows'a GPO başlangıç betiğiyle toplu dağıtım, Linux'a apt ve lab ölçümleri.

29 dk okuma