KERNOVIQ kendi Linux makinenizde ya da sunucunuzda çalışır. İnternet erişimi varsa tek komut yeter; internete kapalı sunucular çevrimdışı paketi kullanır (kapali-ag-kurulumu.md). Windows sunucu ya da bilgisayarda bir kurulum sihirbazı onu WSL 2 içine kurar (aşağıda Windows). Üçü de aynı ürünü kurar: lisans anahtarı yoksa ürün kısıtlı deneme sürümü olarak çalışır, Ayarlar → Lisans'a girilen anahtar bütün kısıtları kurulumu değiştirmeden kaldırır.
| Paket | Kimin için | Ne gelir |
|---|---|---|
| Demo (varsayılan) | KERNOVIQ'i denemek | ağda HTTPS, bu makinenin adıyla ve IP adresleriyle (iç sertifika otoritesi); denemenin kullandığı servisler; ilk yöneticiyi tarayıcıda oluşturmak için tek kullanımlık bağlantı |
| Tam | lisanslı kurumun sunucusu | tam sürüm: iç ağda HTTPS, sunucunun adıyla ve IP adresleriyle (iç sertifika otoritesi ya da kendi sertifikanız), tarama runner'ı dahil bütün servisler, açılışta başlama ve her gece şifreli yedek (root ile) |
İkisine de ağdaki diğer cihazlardan ulaşılır: çalışma arkadaşlarınız
sunucunun adını ya da adresini (https://192.168.1.20) açar. Kurulumu
yalnızca makinenin kendisine bırakmak için --local verin
(http://127.0.0.1:8280, ağa hiçbir şey açılmaz).
Demo paketi deneme sürümüdür ve ücretsiz indirilir. Tam paket tam sürümdür: kurulum betiği onu lisans anahtarınızla lisans sunucusundan indirir.
Gereksinimler
- x86-64 Linux, 4 GB bellek (çok kullanıcılı tam paket için 8 GB), 10 GB boş disk
- Compose eklentili Docker Engine ya da
docker-composeile Podman 4+ (rootless Podman:systemctl --user enable --now podman.socket) bash4.4+,curl,tar,sha256sum,ssh-keygen(OpenSSH 8.1+) — güncel dağıtımlarda hazır gelirkernoviq.org'a ve sürümün belirttiği imaj kayıt defterine giden HTTPS
Demo
curl -fsSL https://kernoviq.org/install.sh | bash
Kurulum betiği makineyi denetler, sürümü indirir, doğrular ve KERNOVIQ'i
başlatır; sonra nereden ulaşılacağını — bu makinenin adını ve adreslerini,
örneğin https://192.168.1.20 — ve https://<ad>/setup#token=… biçiminde bir
bağlantı yazar (adı bilmeyen bir cihaz için aynı bağlantının adresli hâliyle).
Bağlantıyı açın, kurumunuzu ve ilk yöneticiyi oluşturun, hepsi bu. Bağlantı bir
kez çalışır; kullanana kadar kimseyle paylaşmayın.
Sertifikayı kurulumun oluşturduğu iç sertifika otoritesi verir; tarayıcılar bu
otoriteye güvenene kadar uyarı gösterir: uyarıyı onaylayın ya da kullandığınız
cihazlara kurulum dizinindeki kernoviq-ca.crt dosyasını yükleyin. Sertifika
makinenin adreslerini içerir; adres değişince (DHCP) kernoviqctl start yenisini
ekler, kernoviqctl cert renew bunu her an yapar. Makinede ya da ağda gelen
bağlantıları süzen bir güvenlik duvarı varsa TCP 443'e (ve HTTPS'e yönlendiren
80'e) izin verin.
Rootless Podman'lı ya da docker grubundaki bir kullanıcıyla kurulum
~/.local/share/kernoviq altına, sudo ile /opt/kernoviq altına yapılır.
Rootless Podman 443 ve 80 yerine 8443 ve 8080'i dinler; başka portlar için
--https-port ve --http-port, başka bir ad için --server-name. --local
ile KERNOVIQ yalnızca bu makinede http://127.0.0.1:8280 adresinden yanıt verir
(başka bir port için --port 8380).
Sunucuya tam paket
curl -fsSL https://kernoviq.org/install.sh | sudo bash -s -- --edition full --server-name kernoviq.kurum.local \
--license-key-file /root/kernoviq-lisans.txt
Lisans dosyası, lisans e-postasındaki anahtarı (KQL1…) içerir. Betik anahtarı
ve sürümü lisans sunucusuna (https://license.kernoviq.org ya da
--license-server URL) gönderir; sunucu tam kiti ve imajlar için birkaç saat
geçerli bir erişim bilgisi verir. Kit hem lisans sunucusunun sağlama
toplamıyla hem de sürümün imzalı listesiyle denetlenir; KERNOVIQ çalışınca
anahtar etkinleştirilir. Sunucunun reddettiği bir anahtar (tanınmayan, iptal
edilmiş, süresi dolmuş ya da güncelleme süresi dışındaki bir sürüm) hiçbir şey
değişmeden kurulumu durdurur; --dry-run ile de denetlenir.
Kurum adını ve ilk yöneticiyi sorar (ya da --org, --admin-email,
--admin-name, --admin-password-file verin; tarayıcı bağlantısı için
--web-setup), bir iç sertifika otoritesi ile sunucu sertifikası oluşturur
(ya da sizinkini kullanır: --cert DOSYA --key DOSYA [--ca DOSYA]),
kernoviq systemd servisini ve gece yedeğini açar. İç sertifika
otoritesini kullanıyorsanız /opt/kernoviq/kernoviq-ca.crt dosyasını
kullanıcıların bilgisayarlarına dağıtın. Kullanıcılar sunucuya adıyla ya da,
DNS adı henüz bilmiyorsa, adresiyle ulaşır. Günlük işletim — sertifikalar,
yedekler, güncellemeler, runner'lar, iç sistemler — çevrimdışı paketle
aynıdır (kapali-ag-kurulumu.md).
Windows
Windows 10 22H2, Windows 11 ve Windows Server 2022 ya da üstünde (64 bit) KERNOVIQ sitesinden KERNOVIQ-Setup.exe dosyasını indirip yönetici olarak çalıştırın. Donanım sanallaştırması, 6 GB bellek (8 GB önerilir) ve 20 GB boş disk gerekir; etki alanı denetleyicileri desteklenmez.
Sihirbaz gerekirse WSL 2'yi açar (yeniden başlatmadan sonra kendiliğinden
devam eder), KERNOVIQ'e ait, Docker Engine'li bir Ubuntu dağıtımı oluşturur ve
KERNOVIQ'i verdiğiniz DNS adıyla, iç CA ya da kurumunuzun sertifikasıyla ağa
HTTPS üzerinden sunar. Sonunda ilk yönetici için tek kullanımlık bir bağlantı
gösterir. KERNOVIQ Windows ile birlikte, kimse oturum açmadan başlar ve
kernoviq komutuyla işletilir (kernoviq status, doctor, backup,
upgrade). Yükseltmek için daha yeni kurulum programını çalıştırın; kaldırmak
için Ayarlar → Uygulamalar (yedekler kalır).
Gözetimsiz:
KERNOVIQ-Setup-<sürüm>.exe /S /ACCEPT_EULA /SERVERNAME=kernoviq.kurum.local
Geri kalan her şey — Windows'ta kurulanlar, kullanıcılar ve sertifikalar, yedekler, sorun giderme — Windows kılavuzunda anlatılır.
Çalıştırmadan önce okuyun
Kurulum betiği tek bir bash dosyasıdır. Önce okumak ve sürümü kendiniz doğrulamak için:
curl -fsSLO https://kernoviq.org/install.sh
less install.sh
version=$(curl -fsSL https://kernoviq.org/releases/latest)
for file in SHA256SUMS SHA256SUMS.sig release-signer.pub; do curl -fsSLO "https://kernoviq.org/releases/$version/$file"; done
printf 'kernoviq-release namespaces="kernoviq-bundle" %s\n' "$(cat release-signer.pub)" > allowed_signers
ssh-keygen -Y verify -f allowed_signers -I kernoviq-release -n kernoviq-bundle -s SHA256SUMS.sig < SHA256SUMS
sha256sum --ignore-missing -c SHA256SUMS # install.sh: OK
ssh-keygen -l -f release-signer.pub # kernoviq.org'daki parmak iziyle karşılaştırın
bash install.sh
Sırasıyla yaptıkları: makineyi denetler (işletim sistemi, araçlar, konteyner
motoru, bellek, disk, port); sürümün sağlama listesini indirip imzasını
betiğin içine yazılı KERNOVIQ sürüm anahtarıyla doğrular; kiti (compose
dosyaları, kernoviqctl, belgeler — birkaç yüz kilobayt) indirip doğrulanmış
listeyle karşılaştırır; kernoviqctl install'u çalıştırır: imajlar imzalı
kitin yazdığı özetlerle (digest) çekilir — konteyner motoru her katmanı
bunlarla denetler —, ayarlar, anahtarlar ve sertifikalar oluşturulur,
servisler başlar; kurulum bağlantısını yazar.
Asla yapmadıkları: sizinle ya da makineyle ilgili herhangi bir bilgiyi bir
yere göndermek, kendi koyduğu bir parola kullanmak, ağa port açmak
(--server-name ile HTTPS istemedikçe), tarama başlatmak. --dry-run
denetim ve doğrulamadan sonra durur.
Seçenekler
| Seçenek | Anlamı |
|---|---|
--edition demo|full |
paket (varsayılan demo) |
--version SÜRÜM |
en yenisi yerine belirli bir sürüm |
--port N |
demo: yerel port (varsayılan 8280) |
--server-name AD |
bu DNS adıyla iç ağda HTTPS (full için zorunlu) |
--license-key-file DOSYA |
tam paket: lisans anahtarınız (full için zorunlu) |
--license-server URL |
başka bir lisans sunucusu (varsayılan https://license.kernoviq.org) |
--home DİZİN |
kurulum dizini |
--upgrade |
var olan kurulumu güncelle (önce yedek; yeni sürüm açılmazsa geri alınır); yapı korunur: tam sürüm, kurulumun etkin lisans anahtarıyla indirilir |
--uninstall [--purge] |
konteynerleri kaldır; --purge bütün veriyi, imajları ve dizini de siler |
--dry-run |
yalnız denetle ve doğrula |
--yes |
hiçbir şey sorma |
Diğer bütün seçenekler kernoviqctl install'a gider (kernoviqctl install --help).
Kurulumdan sonra kernoviqctl yoldadır (/usr/local/bin, kullanıcı
kurulumunda ~/.local/bin): kernoviqctl status, stop, start, logs,
backup, uninstall.
Demodan lisanslı ürüne
sales@kernoviq.org adresine yazın (Ayarlar → Lisans, teklif için gerekenlerle e-postayı hazırlar). Ödemeden sonra lisans anahtarınız e-postayla gelir; Ayarlar → Lisans'a yapıştırdığınızda sınırlar hemen kalkar; Tam sürüme geç düğmesi tam sürümü yerinde kurar — önce yedek, verileriniz yerinde. Üretim kullanımı için tam paketi anahtarla bir sunucuya kurun.
Sorun giderme
| Belirti | Nedeni ve çözümü |
|---|---|
rootless Podman needs its API socket |
systemctl --user enable --now podman.socket |
something already listens on 127.0.0.1:8280 |
portu başka bir servis kullanıyor: --port 8380 |
something already listens on port 443 (ya da 80) |
makinede başka bir web sunucusu var: --https-port 8443 --http-port 8080 ya da --local |
| tarayıcı sertifika için uyarıyor | kurulumun iç sertifika otoritesine henüz güvenmiyor: kurulum dizinindeki kernoviq-ca.crt dosyasını yükleyin (ya da kurumunuzun sertifikası: kernoviqctl cert install) |
| diğer cihazlar bağlanamıyor | bir güvenlik duvarı TCP 443/80'i süzüyor ya da kurulum --local ile yapılmış (kernoviqctl status adresleri gösterir) |
could not pull … |
makine imaj kayıt defterine ulaşamıyor (vekil sunucu: yalnız curl için değil Docker ya da Podman için de ayarlayın) ya da disk dolu |
the release signature does not verify |
indirme yolda değişmiş ya da betik ile sürüm birbirine ait değil: install.sh'ı kernoviq.org'dan yeniden indirin |
| kurulum bağlantısı anahtarın geçersiz olduğunu söylüyor | ilk yönetici zaten var: /login'den giriş yapın |