Bölüm 3: Kurulum Ön Koşulları¶

Genel Yaklaşım¶

Arceris kurulumu Arceris destek ekibi tarafından yürütülür. Bu bölüm, kurulumdan önce müşteri tarafında hazırlanması gerekenleri listeler: host kaynakları, ağ erişimleri, sertifika planlaması ve lisans bilgileri. Teknik kurulum adımları destek sürecinin parçasıdır ve bu kılavuzda anlatılmaz.

Sistem Gereksinimleri¶

Standart dağıtım modeli, Arceris'in Ubuntu 24.04 LTS (amd64) üzerinde, tüm bileşenleriyle birlikte tek bir paket olarak çalıştırılmasıdır. Veritabanı ve destek servisleri dağıtım paketinin parçası olarak birlikte gelir; ayrıca kurulup yönetilmeleri gerekmez.

Kurulumdan önce host kaynaklarının aşağıdaki alt sınırları karşılaması gerekir:

Kaynak	Alt Sınır	Önerilen	Not
İşletim sistemi	Ubuntu 24.04 LTS (amd64)	Ubuntu 24.04 LTS	Temiz bir kurulum hedefi öngörülür
CPU	12 çekirdek	24 çekirdek	Gateway, veri katmanı ve tarama servisleri aynı host üzerinde çalışır
RAM	16 GB	32 GB	Yönetim arayüzü, proxy katmanları ve paket içi destek servisleri için taban kapasite
Disk	150 GB boş alan	250+ GB	Ürün verisi, denetim kayıtları ve loglar için

CPU tüketen tarama servisleri — OCR ve Türkçe prompt güvenlik modeli — host'un çekirdek sayısına göre otomatik boyutlanır; bu yüzden çekirdek planlaması doğrudan tarama kapasitesini belirler.

Bellek planlamasında eşzamanlı büyük dosya yüklemeleri de dikkate alınmalıdır: gateway bellek limitini kendine göre ayarlar ve eşzamanlı istek gövdeleri için paylaşılan bir bütçe kullanır; sık geçen büyük ek dosyaları olan ortamlarda RAM'i üst banda doğru planlayın.

Disk planlamasında yalnızca kurulum boyutu değil; kalıcı ürün verisi (kullanıcılar, kurallar, denetim kayıtları), audit logları ve log saklama süresi de dikkate alınmalıdır.

Ağ ve Port Gereksinimleri¶

Arceris birden fazla trafik yüzeyine sahip olduğu için ağ planlaması kurulumdan önce yapılmalıdır. Kullanılacak dağıtım modeline göre hangi portların yayınlanacağı, hangi istemcilerin bu portlara erişeceği ve hangi upstream servislerle iletişim kurulacağı açık biçimde belirlenmelidir.

Standart kurulumdaki port yüzeyleri şunlardır:

Port	Yüzey	Not
`8443`	Web arayüzü ve ana HTTPS API	Yönetim ve kullanıcı paneli
`443`	Transparent Proxy HTTPS kesme yüzeyi	Tarayıcı trafiğinin denetlendiği yüzey
`3128`	Explicit Proxy portu	IDE/CLI trafiği için; varsayılan olarak açıktır

Opsiyonel gözlemlenebilirlik profili açılırsa izleme panellerinin portları da yayınlanır; bu yüzeyler yalnızca operasyon ağına açılmalıdır.

Müşteri erişimine açılması beklenen yüzeyler; kullanım senaryosuna göre 8443, 443 ve gerekiyorsa 3128 ile sınırlı tutulmalıdır. Paket içindeki veri ve yardımcı servis katmanı dış dünyaya açık olmamalıdır. Ayrıca 443 ve 3128 yüzeyleri güvenlik duvarı kurallarıyla yalnızca güvenilir istemci ağlarına açılmalıdır; Arceris'in istemci başı gövde bütçesi adil kullanım içindir, servis reddi savunması değildir.

Kurumsal ağda bu portların yalnızca teknik olarak açık olması yeterli değildir. Hangi istemcilerin hangi yüzeye erişeceği, dış dünyaya hangi bağlantıların çıkacağı ve güvenlik cihazlarının bu trafiğe nasıl davranacağı da değerlendirilmelidir. Özellikle transparent kullanım planlanıyorsa DNS yönlendirme, host yönlendirmesi veya ilgili ağ müdahale modeli önceden kararlaştırılmalıdır.

DNS ve Zaman Kaynağı¶

Arceris'in upstream sağlayıcı adreslerini çözümleyebilmesi bir ön koşuldur. Çözümleme önce yönetim panelindeki Host DNS sunucularıyla, ardından kurulumda belirlenen yedek sunucularla yapılır. Air-gapped bir ağda iç DNS sunucularının kurulumdan sonra panelden girilmesi gerekir; aksi hâlde çözümleme yedek adrese düşer ve izole ağda sağlayıcı trafiği çıkamaz. Host DNS ve NTP ayarlarının tamamı kurulum sonrası panelden yönetilir (Bölüm 29); zaman senkronizasyonuna duyarlı akışlar (örneğin Kerberos kaydı) için doğru zaman kaynağı da önceden planlanmalıdır.

İstemcilerin Arceris'e nasıl ulaşacağı da önceden netleştirilmelidir: istemciler sunucu host adını DNS üzerinden çözmeli ya da trafik L3 düzeyinde (DNAT/güvenlik duvarı kuralı) Arceris'e yönlendirilmelidir.

Sertifika ve TLS Gereksinimleri¶

Arceris'in kurulum öncesi en kritik ihtiyaçlarından biri doğru sertifika planlamasıdır. Standart kurulumda sertifika materyali kurulum sırasında otomatik üretilir; elle hazırlanması gerekmez. Kurulum öncesi hazırlanması gereken bilgi, istemcilerin sunucuya ulaşmak için kullanacağı host adı ve IP listesidir — bu liste sunucu sertifikasına işlenir.

Kurulum öncesinde aşağıdaki ayrım anlaşılmış olmalıdır:

Web ve admin arayüzü için kullanılan TLS sunucu sertifikası
Transparent Proxy için kullanılan CA sertifikası

Bu iki amaç için aynı sertifika mantığı kullanılmaz. Kurumun kendi kök CA'sı kullanılacaksa bu destek ekibine önceden bildirilmelidir; kurumsal sertifikaların benimsenmesi ve yaşam döngüsü Bölüm 4 ve Bölüm 32'de ele alınır. Özellikle transparent kullanım planlanıyorsa, istemci cihazlara CA güven ilişkisinin nasıl dağıtılacağı da kurulum ön koşullarının parçası olarak ele alınmalıdır.

Opsiyonel Bileşenlerin Ön Koşulları¶

Kurumsal Veri Denetçisi: Kurumun kendi politikalarının kurumun kendi LLM'i tarafından değerlendirilmesi plananıyorsa, erişilebilir bir LLM uç noktası (yerel bir model servisi veya OpenAI-uyumlu bir uç nokta) önceden planlanmalıdır. Ayrıntılar Bölüm 20'dedir.
Gözlemlenebilirlik profili: İzleme ve log toplama katmanı opsiyonel profilde gelir; açılacaksa ek disk ve bellek planlanmalıdır.

Lisans ve İlk Erişim Bilgileri¶

Kurulumun teknik olarak tamamlanabilmesi için yalnızca servislerin ayağa kalkması yeterli değildir. Ürüne ilk yönetici erişiminin nasıl sağlanacağı ve lisans doğrulamasının nasıl yapılacağı da kurulum ön koşullarının parçasıdır.

Canlıya geçmeden önce aşağıdaki konular hazır olmalıdır:

Kullanılacak lisans anahtarı ve lisans doğrulama bilgisi. Sunucu lisans hub'ına erişemezse ürün lisans engelli açılır; çevrimdışı işletim için bu durum destek ekibine bildirilmelidir (Bölüm 30).
İlk yönetici erişimi için kimlik doğrulama yöntemi ve ilk parola — kurulum özetiyle birlikte iletilir; parola ilk girişte değiştirilmelidir (Bölüm 4).
Break-glass erişim politikasının nasıl tanımlanacağı ve acil durum yönetici anahtarı
Upstream AI sağlayıcı bağlantıları için gerekli erişim anahtarları

Bu bilgiler eksikse ürün teknik olarak ayağa kalksa bile yönetim arayüzü, lisanslı özellikler veya upstream entegrasyonlar beklenen şekilde kullanılamayabilir. Bu nedenle ilk erişim ve lisans bilgileri, kurulumdan önce doğrulanmış olmalıdır.