Kurulum

Tek bir betik, seçtiğiniz modülleri kurar: sunucu uzantıları, zimletler, yardımcı bileşenler ve izinler. Kurulumun sonunda posta servisi bir kez yeniden başlatılır.

Bakım penceresi

Kurulum sonunda mailboxd bir kez yeniden başlatılır; kullanıcılar kısa bir kesinti yaşar. Kurulumu bakım penceresinde yapın.

Standart kurulum

1. Paketi sunucuya kopyalayıp açın:

   tar xzf profelis-edition-installer-ubuntu22.tgz
   cd profelis-edition-installer
   

2. Kurulumu başlatın:

   sudo ./install.sh
   

3. Kurulacak modülleri seçin. Seçiminiz /etc/profelis-edition/modules.conf dosyasına yazılır ve sonraki çalıştırmalarda hatırlanır.
4. Kurulum sonunda doğrulama çalışır; PASS görmelisiniz.
5. Yönetici konsolunu sert yenileyin (Ctrl+Shift+R). Profelis modülleri Araçlar ve Geçiş altında görünür.

Sık kullanılan seçenekler

Seçenek	Ne yapar
--look air	Webmail'i Profelis Air görünümüyle açar (--look classic Klasik).
--modules a,b,c	Soru sormadan yalnız bu modülleri kurar.
--all-modules	Tüm modülleri kurar.
--yes	Önceki seçimi soru sormadan uygular.
--verify	Yalnız sağlık kontrolü yapar.
--wire-postfix	DLP'yi posta aktarımına bağlar (onaylı).
--mobile-agent	Z-Push sunucusunda mobil aracıyı kurar.
--ha	Yüksek erişilebilirlik yardımcı bileşenini kurar.
--skip-restart	mailboxd'yi yeniden başlatmaz; sonra elle yapın.
--interactive	Rehberli kurulumu açar (terminal gerekir).
--no-menu	Terminalden çalıştırılsa da rehberli menüyü açmaz; doğrudan modül seçimine geçer.
--pre-zmsetup	Yalnız swatch saldırı yamasını uygular ve çıkar; Zimbra paketlerinden sonra, zmsetup çalışmadan önce kullanılır.
--remove-snmp	zimbra-snmp paketini kaldırır (SNMP trap kullanılmıyorsa; swatch saldırı yüzeyi kapanır).
--alwayson-admin-cidr	Always On güvenlik duvarında yönetim portu 7071'e izin verilen ek ağ (firewall.admin_cidr); boşsa yalnız küme adresleri açılır ve uyarı verilir. Rehberli kurulum bunu sorar.
--no-guard	Zimbra Guard bakım modunu yönetmez; kurulum sonunda referans değer yine yenilenir.
--force	Değişmemiş jar ve zimlet'i de yeniden kurar, mailboxd'yi yeniden başlatır.
--skip-companions	Yardımcı betikleri (2FA, etiket, DLP, tema, ...) çalıştırmaz.
--help	Tüm seçenekleri gruplu olarak ve kopyalanabilir örneklerle yazar.

Yeni Zimbra kurulumunda sıra

swatch saldırı yamasının zmsetup öncesinde uygulanması gerekir: önce Zimbra paketlerini kurun, sonra sudo ./install.sh --pre-zmsetup, ardından zmsetup, en son sudo ./install.sh. Sistem hâlâ yamasızsa kurulum başarısız olur.

Rehberli kurulum

install.sh seçeneksiz (veya --interactive ile) terminalden çalıştırıldığında adım adım ilerleyen bir rehber açar. Önce kısa bir menü gelir:

Seçim	Ne yapar
1 Kur / güncelle	Bu makinenin rolünü sorar ve seçime göre kurulumu yapar.
2 Doğrula	Yalnız sağlık kontrolü (--verify ile aynı).
3 Tam HA'ya yükselt	Yalnız bu makinede tanıksız (laboratuvar) bir profil varsa görünür.
4 Yardım	--help çıktısını gösterir.
0 Çıkış	Hiçbir şey yapmadan çıkar.

Roller:

Rol	Sorulanlar	Kurulanlar
Tek sunucu	Modüller	Profelis modülleri (bugünkü kurulum).
Küme: ilk düğüm	Düğümler ve IP'leri, tanık ve IP'si, ortak IP, blob deposu, OpenSearch belleği, InnoDB tamponu, Zimbra yaması 604, modüller	Profil üretilir; Profelis modülleri, yama 604 ve Always On fazları (veritabanı, ZooKeeper, OpenSearch, LDAP çoğaltma, nesne deposu, blob, ...).
Küme: ek düğüm	Profilin yeri, bu makinedeki yama paketi, modüller	Profelis modülleri, yama 604 ve Always On fazları.
Tanık sunucu	Profilin yeri	Yalnız tanık bileşenleri: güvenlik duvarı, ZooKeeper, garbd, OpenSearch oy düğümü, Ceph veya Garage üyesi. Zimbra gerekmez; tanıkta ilgisiz bir Zimbra varsa ona dokunulmaz.

Veritabanı modu topolojiden gelir ve rehberde açıklanır: tanık varsa Galera + MaxScale (iki düğümde eşanlı çoğaltma, tanıkta çoğunluk oyu), tanık yoksa single (Zimbra'nın veritabanı ilk düğümde).

Blob deposu seçenekleri (ceph, garage ve s3 Zimbra PFE 10 gerektirir; Zimbra 9'da kurulum paketi bunları reddeder, nfs kullanın) ve ek sorular:

Depo	Ne zaman	Ek sorular
ceph	Tanıklı küme; iki düğüm ve tanık üzerinde otomatik kurulur.	Laboratuvar için loop imajı boyutu veya üretim diskleri (diskin içeriği silinir); isteğe bağlı küme ağı.
garage	Tanıklı küme; daha hafif nesne deposu.	Loop imajı boyutu veya veri dizini; isteğe bağlı kapasite.
s3	Kurumun mevcut S3 servisi; depo kurulmaz.	Uç nokta, bucket, bölge ve kimlik dosyasının yolu.
nfs	Laboratuvar varsayılanı.	İsteğe bağlı NFS paylaşımı.

S3 anahtarları ekranda sorulmaz

Anahtarları bir dosyaya access_key=... ve secret_key=... satırları olarak yazın ve izinlerini chmod 600 yapın. Rehber yalnız dosyanın yolunu sorar; anahtarlar ekrana ve komut satırına yazılmaz.

OpenSearch belleği ve InnoDB tamponu için makinenin belleğine göre bir varsayılan önerilir. Zimbra yaması 604 için kurulum paketindeki zmpatch-*.tar.gz önerilir; yama zaten uygulanmışsa yok yazın.

Her rolde değişiklikten önce yapılacakların özeti gösterilir ve onay istenir. Kurulum her adımı [i/N] biçiminde gösterir; kurulu olan adımlar zaten kurulu diye geçilir. Bir adım başarısız olursa kurulum durur ve kaldığı yerden devam etmek için gereken komutları yazar. Tanıklı kümede ilk düğüm, tanığın önce kurulduğunu onaylamanızı bekler. Sonda sıradaki adımlar yazılır: profilin diğer makinelere kopyalanması, önce tanık, sonra ilk düğüm, sonra diğer düğümler.

Rehber yalnız şu durumda açılır: terminal var, --yes verilmemiş ve --modules, --all-modules, --verify ya da herhangi bir --alwayson-* seçeneği yok. Otomasyon ve betikler eskisi gibi çalışır.

Tanıksız küme yalnız laboratuvar içindir

Tanık sunucu verilmezse (none) veritabanı, NFS, ZooKeeper ve OpenSearch yalnız ilk düğümde çalışır. İlk düğüm tek hata noktasıdır; o düğüm durursa tüm küme durur. Üretimde bir tanık sunucu kullanın.

Always On seçenekleri

Seçenek	Ne yapar
--alwayson-nodes A,B	Profil yoksa bu makinede (ilk düğüm A) profili üretir ve kurar.
--alwayson-witness W	Tanık sunucu. none laboratuvar kurulumudur; bir sunucu adı tam HA profili üretir.
--alwayson-witness-ip IP	Tanık sunucunun IP adresi (DNS'te yoksa).
--alwayson-vip IP	Ortak IP adresi; boş bırakılırsa dış yük dengeleyici kullanılır.
--alwayson-blob B	Blob deposu: ceph, garage, s3 veya nfs. Tanıklı kurulumda varsayılan ceph, laboratuvarda nfs.
--alwayson-set K=V	Profile bir ayar yazar; tekrarlanabilir. Örnek: blob.loop_size=20G, blob.devices=/dev/sdb,/dev/sdc, index.opensearch_heap=4g, db.innodb_buffer_pool=8G.
--alwayson-s3-credentials DOSYA	s3 deposunun anahtar dosyası (access_key= ve secret_key= satırları).
--alwayson-profile DOSYA	Profil yolu (varsayılan /etc/profelis-alwayson/profile.conf).
--alwayson-upgrade-fullha W	İlk düğümde, tanıksız kümeyi tanık W ile tam HA'ya yükseltir, ardından küme adımını çalıştırır.
--no-alwayson-cluster	Küme adımını atlar (yalnız jar ve zimlet).

Always On seçili ve blob deposu ceph, garage veya s3 ise s3store modülü seçime kendiliğinden eklenir. Kurulum paketinde zmpatch-*.tar.gz varsa profil üretilirken yama yolu profile yazılır.

Zimbra kurulu olmayan bir makinede profil varsa ve bu makine profilde tanıksa, install.sh yalnız alwayson-install'ı çalıştırır ve onun sonucuyla biter.

Örnekler

# Rehberli kurulum (her rol)
sudo ./install.sh
# Tek sunucu, soru yok, tüm modüller
sudo ./install.sh --yes --all-modules
# Güncelleme (aynı modül seçimi)
sudo ./install.sh --yes
# Mevcut seçime bir modül ekleme
sudo ./install.sh --yes --modules "$(grep -v '^#' /etc/profelis-edition/modules.conf | paste -sd, -),waf"
# Yalnız doğrulama
sudo ./install.sh --verify

Always On, laboratuvar (tanıksız, NFS, ilk düğümde tek komut):

sudo ./install.sh --yes --all-modules \
  --alwayson-nodes posta1.zpe.profelis.net,posta2.zpe.profelis.net --alwayson-witness none

Always On, tam HA ve Ceph. Sıra: profil, tanık, ilk düğüm, diğer düğümler. Profil her makinede aynı yolda olmalıdır.

# posta1 (ilk düğüm): profili üret (laboratuvar diskleri; üretimde --set blob.devices=/dev/sdb,/dev/sdc)
sudo scripts/alwayson/alwayson-install --profile /etc/profelis-alwayson/profile.conf --write-profile \
  --nodes posta1.zpe.profelis.net,posta2.zpe.profelis.net --witness tanik.zpe.profelis.net \
  --witness-ip 192.0.2.30 --vip 192.0.2.10 --blob ceph --set blob.loop_size=20G
# tanık: profili al ve tanık bileşenlerini kur
sudo install -d -m 0700 /etc/profelis-alwayson
sudo scp -p posta1.zpe.profelis.net:/etc/profelis-alwayson/profile.conf /etc/profelis-alwayson/profile.conf
sudo scripts/alwayson/alwayson-install --profile /etc/profelis-alwayson/profile.conf --yes
# posta1, ardından posta2 (posta2'ye profili önce kopyalayın)
sudo ./install.sh --yes

Garage veya kurumsal S3 ile profil üretimi aynı komuttur; yalnız depo seçenekleri değişir:

# Garage
... --blob garage --set blob.data_dir=/srv/garage-data --set blob.garage_capacity=500G
# Kurumsal S3 (anahtarlar dosyada)
... --blob s3 --set blob.s3_endpoint=https://s3.zpe.profelis.net --set blob.s3_bucket=zimbra \
    --s3-credentials /root/s3.cred

Laboratuvar kümesini tam HA'ya yükseltme (posta1 ilk düğümdür):

# posta1
sudo scripts/alwayson/alwayson-install --profile /etc/profelis-alwayson/profile.conf --upgrade-fullha \
  --witness tanik.zpe.profelis.net --witness-ip 192.0.2.30 --blob ceph --set blob.loop_size=20G --yes
# profili tanığa ve posta2'ye kopyalayın; sonra tanık, posta1, posta2 sırasıyla kurun

Yarıda kalan bir küme adımında kurulum, ekrana alwayson-install --profile ... --phase ... biçiminde devam komutunu ve ardından install.sh'i yeniden çalıştırma komutunu yazar; tamamlanan adımlar atlanır.

Ayrıntılar: Always On kurulumu.