Ana sayfaya dön

Kurulum kılavuzu

KERNOVIQ’i tek komutla kurmak: gereksinimler, demo ve tam paket, betiği çalıştırmadan önce doğrulamak, seçenekler ve sorun giderme.

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-compose ile Podman 4+ (rootless Podman: systemctl --user enable --now podman.socket)
  • bash 4.4+, curl, tar, sha256sum, ssh-keygen (OpenSSH 8.1+) — güncel dağıtımlarda hazır gelir
  • kernoviq.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

Bu sayfa ürünle birlikte gelen kurulum belgesinden üretilir.