digna Sürüm 2026.11 için Linux Kurulum Kılavuzu¶

Sürüm: 2026.11

Son Güncelleme: 7 Kasım 2026

İçindekiler¶

1. Giriş
2. Sistem Gereksinimleri
3. Kurulum Öncesi Hazırlık
4. PostgreSQL Sunucu Kurulumu
5. Web Sunucusu Yapılandırması
6. İlk Kurulum
7. Backend Yapılandırması
8. Dashboard Yapılandırması
9. digna'yı systemd Hizmeti Olarak Çalıştırma
10. Yeni Bir Sürüme Yükseltme

Giriş¶

digna Hakkında¶

digna, veri ambarları, veri gölleri ve lakehouse'lar gibi çeşitli veri ortamlarında veri kalitesi yönetimini optimize etmek için tasarlanmış kapsamlı, yapay zekâ destekli bir platformdur. Yüksek ölçeklenebilirlik ve uyarlanabilirlik göz önünde bulundurularak geliştirilen digna, otomasyon, gerçek zamanlı izleme ve anomali tespiti ile modern veri zorluklarına yanıt verir.

digna iki ana bileşenden oluşur:

• digna: uygulamanın çekirdeği; verileri işlemekten ve kalite denetimlerini yürütmekten sorumludur. Arka ucu ve komut satırı arayüzünü tek bir çalıştırılabilir dosyada birleştirir ve önceki sürümlerdeki ayrı dignabackend ile dignacli programlarının yerini alır.
• dignadashboard: Bir web sunucusunda barındırılan, digna platformuyla etkileşim kurmayı ve veri kalite metriklerini görselleştirmeyi sağlayan web tabanlı arayüz.

2026.11 Sürümünde Yenilikler¶

Bu sürüm digna Data Reconciliation'ı, digna MCP Server ile birlikte digna Agentic'i ve verileri digna içinde profilleyebilen ve farklı veritabanı teknolojileri arasında referans bütünlüğünü denetleyebilen digna Engine'i ekler. Tam ayrıntılar için sürüm notlarına bakın.

Kurulum açısından bu sürüm yeni bir repository geçiş (migration) mekanizması, config.toml içinde digna Engine için isteğe bağlı bir [duckdb] bölümü ve yeni bir lisans dosyası getirir. Bunların her biri yükseltme bölümünde ele alınır.

Windows veya macOS mu arıyorsunuz?¶

Bu kılavuz Linux içindir. Diğer platformlar için Windows Kurulum Kılavuzu veya macOS Kurulum Kılavuzu belgelerine bakın.

Bu Kılavuz Hangi Dağıtımları Kapsar?¶

Yönergeler en yaygın iki sunucu ailesi için yazılmıştır. İkisinin farklılaştığı yerlerde her iki komut da verilir:

• Debian ailesi — Debian, Ubuntu. Paket yöneticisi: apt.
• RHEL ailesi — Red Hat Enterprise Linux, Rocky Linux, AlmaLinux, Fedora. Paket yöneticisi: dnf.

systemd kullanan her modern dağıtım çalışır; yalnızca paket adları ve birkaç yapılandırma yolu değişir.

Sistem Gereksinimleri¶

Kuruluma başlamadan önce sisteminizin aşağıdaki minimum gereksinimleri karşıladığından emin olun:

Veritabanı Kurulum Seçenekleri¶

PostgreSQL zaten kuruluysa: Mevcut PostgreSQL sunucunuza digna için yeni bir veritabanı ekleyebilirsiniz.

PostgreSQL'i digna ile aynı makineye kuruyorsanız:

Dağıtımınızı ve Mimarinizi Denetleme¶

Bu kılavuzdaki birkaç komut Debian ve RHEL aileleri arasında farklılık gösterir. Hangisini kullandığınızı öğrenmek için şunu çalıştırın:

cat /etc/os-release
uname -m

• ID=ubuntu veya ID=debian — apt komutlarını kullanın.
• ID=rhel, rocky, almalinux veya fedora — dnf komutlarını kullanın.
• x86_64 veya aarch64 — ihtiyacınız olan kurulum paketinin mimarisi.

Kurulum Öncesi Hazırlık¶

digna'yı kurmadan önce iki temel önkoşulun yerinde olduğundan emin olun:

1. PostgreSQL Server – hesaplanmış metrikler ve performans verileri için depolama
2. Web Server – digna Dashboard'u barındırmak için

Bu bileşenler henüz kurulu değilse, aşağıdaki bölümlerde bunları kurup yapılandırma adımlarını izleyin.

Paket Dizinini Yenileme¶

Herhangi bir şey kurmadan önce paket listelerinizi güncelleyin:

sudo apt update

sudo dnf check-update

PostgreSQL Sunucu Kurulumu¶

PostgreSQL Zaten Kuruluysa¶

PostgreSQL yerel makinenizde zaten kurulu ve çalışıyorsa veya yönetilen uzak bir PostgreSQL sunucusu kullanıyorsanız, bir sonraki bölüme geçebilirsiniz.

PostgreSQL Kurulumu¶

Adım 1: Sunucu Paketini Kurun¶

sudo apt install -y postgresql postgresql-contrib

sudo dnf install -y postgresql-server postgresql-contrib

Adım 2: Veritabanı Kümesini Başlatın¶

Debian ailesinde paket bir kümeyi otomatik olarak oluşturur ve başlatır — bir sonraki adıma geçin.

RHEL ailesinde küme açıkça oluşturulmalıdır:

sudo postgresql-setup --initdb

Adım 3: Hizmeti Başlatın ve Etkinleştirin¶

sudo systemctl enable --now postgresql

Bu komut PostgreSQL'i hemen başlatır ve sistem açılışında otomatik olarak yeniden başlayacak şekilde yapılandırır.

Adım 4: Kurulumu Doğrulayın¶

psql --version
sudo systemctl status postgresql

PostgreSQL sürümünü ve active (running) durumundaki bir hizmeti görmelisiniz.

Adım 5: Sunucuya Bağlanın¶

Linux PostgreSQL paketi, kümenin sahibi olan bir postgres sistem hesabı oluşturur. Bu hesap üzerinden bağlanın:

sudo -u postgres psql

Adım 6: Portu Doğrulayın¶

Varsayılan PostgreSQL portu 5432'dir. Sunucunuzun dinlediği portu doğrulamak için:

sudo -u postgres psql -c "SHOW port;"

Değeri not edin — digna backend'ini yapılandırırken ihtiyacınız olacak.

Adım 7: digna Kullanıcısı için Parola Kimlik Doğrulamasını Etkinleştirin¶

digna, PostgreSQL'e TCP üzerinden digna_user olarak bağlanır; bu da peer kimlik doğrulaması yerine parola kimlik doğrulaması gerektirir. pg_hba.conf dosyanızın buna izin verdiğini denetleyin.

Dosyanın yerini bulun:

sudo -u postgres psql -c "SHOW hba_file;"

Dosyayı bir düzenleyicide açın ve yerel TCP satırlarının ident yerine scram-sha-256 (eski sunucularda md5) kullandığını doğrulayın:

# TYPE  DATABASE  USER  ADDRESS         METHOD
host    all       all   127.0.0.1/32    scram-sha-256
host    all       all   ::1/128         scram-sha-256

Herhangi bir değişiklikten sonra PostgreSQL'i yeniden yükleyin:

sudo systemctl reload postgresql

Adım 8: PostgreSQL Başka Bir Makinede Çalışıyorsa¶

Farklı bir ana bilgisayardan gelen bağlantıları kabul etmek için postgresql.conf içinde listen_addresses değerini ayarlayın ve pg_hba.conf dosyasına ağınız için uygun bir host satırı ekleyin:

listen_addresses = '*'

Ardından güvenlik duvarında portu açın ve hizmeti yeniden başlatın:

sudo ufw allow 5432/tcp

sudo firewall-cmd --permanent --add-port=5432/tcp && sudo firewall-cmd --reload

sudo systemctl restart postgresql

Web Sunucusu Yapılandırması¶

digna dashboard'unu barındırmak için bir web sunucusuna ihtiyaç vardır. Aşağıdaki seçeneklerden birini seçin:

• nginx — hafif ve önerilen
• Apache httpd — yaygın olarak kullanılan alternatif

Bu sunuculardan yalnızca birini kurmanız ve yapılandırmanız yeterlidir.

Her iki bölüm de dashboard'un bağlı olduğu iki şeyi yapılandırır:

• Tek sayfalı uygulama (SPA) geri dönüşü; böylece bir dashboard URL'sini yenilemek 404 döndürmez
• .md MIME türü; böylece Markdown dosyaları doğru şekilde sunulur

nginx Kurulumu¶

Genel Bakış¶

nginx, statik digna dashboard'unu sunmaya çok uygun, hafif ve yüksek performanslı bir web sunucusudur.

Kurulum¶

sudo apt install -y nginx

sudo dnf install -y nginx

nginx'i Başlatma¶

sudo systemctl enable --now nginx

Kurulumu Doğrulayın¶

1. Tarayıcınızı açın
2. http://localhost adresine gidin
3. nginx karşılama sayfasını görmelisiniz

Güvenlik Duvarını Açma¶

Sunucuya başka makinelerden erişiliyorsa HTTP trafiğine izin verin:

sudo ufw allow 'Nginx Full'

sudo firewall-cmd --permanent --add-service=http && sudo firewall-cmd --reload

Dashboard için Bir Site Yapılandırma¶

nginx, her iki dağıtım ailesinde de conf.d dizinindeki tüm dosyaları dahil eder. Orada digna için ayrı bir yapılandırma dosyası oluşturun:

sudo nano /etc/nginx/conf.d/digna.conf

Aşağıdakini yapıştırın ve /opt/digna/dashboard yolunu, çıkardığınız dashboard klasörünün gerçek yoluyla değiştirin:

server {
    listen       80 default_server;
    listen       [::]:80 default_server;
    server_name  _;

    root   /opt/digna/dashboard;
    index  index.html;

    # Serve Markdown files with the correct MIME type.
    types {
        text/markdown  md;
    }

    # Single-page-application fallback: unknown paths return index.html
    # instead of a 404, so dashboard routes survive a browser refresh.
    location / {
        try_files $uri $uri/ /index.html;
    }
}

Varsayılan Siteyi Devre Dışı Bırakın¶

Bir port için yalnızca bir server bloğu default_server olabilir. Debian ailesinde, çakışmaması için paketle gelen varsayılan siteyi kaldırın:

sudo rm /etc/nginx/sites-enabled/default

RHEL ailesinde, /etc/nginx/nginx.conf içindeki server { ... } bloğunu yorum satırına alın veya silin.

Yapılandırmayı Uygulayın¶

Yapılandırmada söz dizimi hatası olup olmadığını test edin, ardından nginx'i yeniden yükleyin:

sudo nginx -t
sudo systemctl reload nginx

Apache httpd Kurulumu¶

Genel Bakış¶

Apache httpd, desteklenen her dağıtımın varsayılan depolarında bulunur. Paketin adı Debian ailesinde apache2, RHEL ailesinde httpd'dir.

Kurulum¶

sudo apt install -y apache2

sudo dnf install -y httpd

Apache'yi Başlatma¶

sudo systemctl enable --now apache2

sudo systemctl enable --now httpd

Kurulumu Doğrulayın¶

1. Tarayıcınızı açın
2. http://localhost adresine gidin
3. Dağıtımın varsayılan Apache sayfasını görmelisiniz

Gerekli: mod_rewrite'ı Etkinleştirin¶

Dashboard, URL yeniden yazmayı gerektirir.

Debian ailesinde modülü etkinleştirin ve yeniden başlatın:

sudo a2enmod rewrite
sudo systemctl restart apache2

RHEL ailesinde mod_rewrite varsayılan olarak yüklüdür. Bunu doğrulayın:

httpd -M | grep rewrite

Gerekli: .htaccess Geçersiz Kılmalarına İzin Verin¶

Belge kökünüz için yapılandırma dosyasını açın:

sudo nano /etc/apache2/apache2.conf

sudo nano /etc/httpd/conf/httpd.conf

Belge kökünüzü kapsayan <Directory> bloğunu bulun (her iki ailede de /var/www/html) ve şunu:

AllowOverride None

şununla değiştirin:

AllowOverride All

Gerekli: Markdown Dosyaları için MIME Türü¶

Markdown dosyalarının doğru şekilde sunulması için aynı dosyaya şu satırı ekleyin:

AddType text/markdown .md

Yapılandırmayı Uygulayın¶

Yapılandırmada söz dizimi hatası olup olmadığını denetleyin, ardından Apache'yi yeniden başlatın:

sudo apachectl configtest
sudo systemctl restart apache2

sudo apachectl configtest
sudo systemctl restart httpd

İlk Kurulum¶

Adım 1: digna Repository'sini Oluşturun¶

digna repository'si, digna tarafından hesaplanan tüm metrikleri saklar. Analitik ve performans verileri için merkezi veritabanı görevi görür.

Repository Şeması ve Kullanıcısı Oluşturma¶

PostgreSQL istemcinizi (psql, pgAdmin veya benzeri) açın ve aşağıdaki SQL komutlarını çalıştırın:

CREATE SCHEMA <digna_repo_schema>;

CREATE USER <digna_repo_user> WITH PASSWORD '<digna_repo_password>';

GRANT ALL PRIVILEGES ON SCHEMA <digna_repo_schema> TO <digna_repo_user>;

Aşağıdaki yer tutucuları değiştirin:

• <digna_repo_schema> — İstediğiniz şema adı (ör. dignarepo)
• <digna_repo_user> — İstediğiniz kullanıcı adı (ör. digna_user)
• <digna_repo_password> — Bu kullanıcı için güvenli bir parola

Örnek:

CREATE SCHEMA dignarepo;

CREATE USER digna_user WITH PASSWORD 'YourSecurePassword123!';

GRANT ALL PRIVILEGES ON SCHEMA dignarepo TO digna_user;

Bunları kabuktan tek adımda çalıştırmak için:

sudo -u postgres psql

Ardından ifadeleri postgres=# isteminde yapıştırın ve çıkmak için \q yazın.

Adım 2: digna Kurulum Paketini Çıkarın¶

1. Size sağlanan digna kurulum ZIP dosyasını bulun
2. İstediğiniz kurulum konumuna çıkarın — örneğin /opt/digna
3. Çıkarma sonrası aşağıdaki öğeleri görmelisiniz:
4. dashboard/ — Web dashboard arayüzü
5. digna — Ana yürütülebilir dosya (backend + CLI birleşik)

Kabuktan çıkarmak için:

sudo mkdir -p /opt/digna
sudo unzip digna-2026.11-linux-x86_64.zip -d /opt/digna

Yürütülebilir Dosyayı Çalıştırılabilir Yapın¶

Arşivin nasıl aktarıldığına bağlı olarak, çalıştırma izni biti çıkarma sırasında korunmayabilir. Bunu açıkça ayarlayın:

cd /opt/digna
sudo chmod +x digna

Bir Hizmet Hesabı Oluşturun¶

Üretim dağıtımları için backend'in ayrı, ayrıcalıksız bir kullanıcı olarak çalıştırılması önerilir:

sudo useradd --system --no-create-home --shell /usr/sbin/nologin digna
sudo chown -R digna:digna /opt/digna

Adım 3: Lisans Dosyasını Yükleyin¶

1. Size sağlanan license.toml dosyasını bulun
2. Bunu digna kurulum dizininin köküne kopyalayın (config.toml ve digna yürütülebilir dosyasının bulunduğu dizin)

Neden önemli: Lisans dosyası müşteri bilgilerini, lisans bitiş tarihini ve dijital imzayı içerir. Bu dosyayı değiştirmeyin — herhangi bir değişiklik lisansın geçersiz olmasına neden olur.

Kurulum sonrası dizin yapısı:

/opt/digna/
├── config.toml         (configuration file)
├── license.toml        (YOUR LICENSE FILE - copy here)
├── digna               (main executable)
├── bin/                (service management scripts)
└── dashboard/          (web interface)
    └── (dashboard files)

Backend Yapılandırması¶

Adım 1: Yapılandırma Dosyasını Oluşturun ve Düzenleyin¶

config_template.toml dosyası digna kurulum dizininde sağlanır. Bunu config.toml olarak yeniden adlandırmanız yeterlidir.

cd /opt/digna
sudo mv config_template.toml config.toml

Konum: /opt/digna/config.toml

config.toml dosyasını bir metin düzenleyici ile açın ve aşağıdaki bölümleri yapılandırın.

[app] Bölümü¶

Bu bölüm, dashboard ile backend arasındaki kaynaklar arası kaynak paylaşımını (CORS) yapılandırır:

[app]
DIGNA_APP_CORS_ALLOW_ORIGINS = ["http://localhost:5173"]
DIGNA_APP_CORS_ALLOW_CREDENTIALS = true

[repo] Bölümü¶

Bu bölüm PostgreSQL veritabanı bağlantısını yapılandırır:

[repo]
DIGNA_REPO_HOST = "localhost"
DIGNA_REPO_PORT = 5432
DIGNA_REPO_DB = "postgres"
DIGNA_REPO_SCHEMA = "dignarepo"
DIGNA_REPO_USER = "digna_user"
DIGNA_REPO_PASSWORD = "YourSecurePassword123!"
DIGNA_REPO_SSLMODE = "prefer"
DIGNA_REPO_NUM_CONNS = 16

sudo chown digna:digna /opt/digna/config.toml
sudo chmod 600 /opt/digna/config.toml

[base] Bölümü¶

Bu bölüm güvenlik, çerez (cookie) ve denetim ayarlarını içerir:

[base]
DIGNA_FERNET_KEY = "DU4a0yJ-OqvbKCL4hNQn_CsknH-V1vWmHZqBUl-AY44="
DIGNA_COOKIE_DOMAIN = "localhost"
DIGNA_COOKIE_SECURE = false
DIGNA_COOKIE_HTTPONLY = true
DIGNA_TOKEN_EXPIRES_IN = 86400
DIGNA_MAX_WORKERS = 4
DIGNA_FRONTEND_BASEURL = "http://localhost/"
DIGNA_SOURCE_QUERY_TIMEOUT_SEC = 3600
DIGNA_SOURCE_LOGIN_TIMEOUT_SEC = 30

[encryption] Bölümü¶

Bu bölüm, depoda saklanan hassas değerleri şifrelemek için kullanılan anahtarı içerir. Zorunludur — anahtar eksikse config check, [encryption] bölümünü FAILED olarak bildirir.

[encryption]
DIGNA_ENCRYPTION_KEY = 'ycELf6IbcO55dYIZHpPv6kQv/bbnUXoIaHLh2bh1kMg='

[logging] Bölümü¶

Bu bölüm günlükleme davranışını yapılandırır:

[logging]
DIGNA_LOGGING_MODE = "INFO"
DIGNA_LOGGING_DIR = "logs"
DIGNA_LOGGING_MAX_FILES = 30

[duckdb] Bölümü (İsteğe Bağlı)¶

Sürüm 2026.11'de yeni. Bu bölüm, profilleme konumu digna Engine olan veritabanı bağlantıları için verileri digna içinde profilleyen ve farklı veritabanı bağlantılarındaki veri kaynakları arasında referans bütünlüğü denetimlerini çalıştıran digna Engine'in kaynaklarını belirler. Bkz. Profilleme Konumu.

Bu bölüm isteğe bağlıdır. Bölüm yoksa aşağıdaki varsayılanlar geçerlidir.

[duckdb]
DIGNA_DUCKDB_MEMORY_LIMIT_MB = 1024
DIGNA_DUCKDB_TEMP_DIRECTORY = "/opt/digna/tmp"

sudo mkdir -p /opt/digna/tmp
sudo chown digna:digna /opt/digna/tmp

Adım 2: Yapılandırmayı Doğrulayın¶

Depoyu başlatmadan önce config.toml dosyasının eksiksiz ve doğru kurulmuş olduğunu denetleyin. digna kurulum dizininizde şunu çalıştırın:

./digna config check

Her bölüm ayrı ayrı doğrulanır, böylece tek bir hata diğerlerinin durumunu gizlemez:

Configuration validation report (source: config.toml):
 - App config: OK
 - Repository config: OK
 - Base config: OK
 - Logging config: OK
 - Encryption config: OK
 - OIDC config(s): OK
 - Template overrides: OK
 - Unknown keys: OK

Overall: OK

FAILED olarak bildirilen her şeyi düzeltin ve devam etmeden önce komutu yeniden çalıştırın. Unknown keys altındaki bir WARNING, config.toml içinde digna'nın okumadığı anahtarları listeler; bunların hiçbir etkisi yoktur, bu nedenle kaldırın ya da yazımlarını düzeltin. Seçeneklerin tam listesi CLI başvurusunda yer alır.

Adım 3: Repository'yi Başlatın¶

1. Bir terminal açın
2. digna kurulum dizinine gidin (config.toml ve digna yürütülebilir dosyasının bulunduğu dizin)
3. Bağlantı testini çalıştırın:

cd /opt/digna
./digna repo check

Yeni bir şemada komut bağlanır ve ardından henüz bir repository kurulu olmadığını bildirir:

Error: No repo installed. Use the 'digna repo upgrade' command to install it.

Bu aşamada beklenen sonuç budur: digna'nın PostgreSQL'e ve şemaya ulaştığını doğrular. Bunun yerine bir bağlantı veya kimlik doğrulama hatası alırsanız sorun [repo] bölümündedir ya da PostgreSQL kurulumundadır.

sudo ln -s /opt/digna/digna /usr/local/bin/digna

Adım 4: Repository Şemasını Kurun¶

Aynı dizinde şu komutu çalıştırın:

./digna repo upgrade

Bu komut gerekli tabloları repository şemasına kurar ve şu çıktıyla tamamlanır:

✅ Repo schema 'dignarepo' is up to date.

Adım 5: Yönetici (Admin) Kullanıcısı Oluşturun¶

Yönetici kullanıcısı doğrudan repository şemasında oluşturulur; bu nedenle sunucunun henüz çalışıyor olması gerekmez. digna kurulum dizininde şunu çalıştırın:

./digna user add <email> <password> "<display_name>" --admin

Örnek:

./digna user add admin@example.com 'AdminPassword123!' "Admin User" --admin

Bu komut, admin@example.com e-posta adresine ve tam idari ayrıcalıklara sahip bir kullanıcı oluşturur.

Adım 6: digna Sunucusunu Başlatın¶

digna kurulum dizininde sunucuyu başlatın:

./digna serve --address <host> --port <port>

Parametreler: - --address — Sunucu hostname/IP (varsayılan 127.0.0.1) - --port — Sunucu portu (varsayılan 8000)

Sunucu çalışmaya başladığında dinlediği adresi yazdırır:

Server running on http://127.0.0.1:8082

sudo ufw allow 8082/tcp

sudo firewall-cmd --permanent --add-port=8082/tcp && sudo firewall-cmd --reload

Dashboard Yapılandırması¶

Adım 1: Dashboard'u Web Sunucusuna Dağıtın¶

digna dashboard'u kendi yapılandırmasını dashboard/dashboard_config.toml dosyasından okur. Bu dosya kurulumla birlikte gelmez — onu dashboard/ dizininde, dashboard dosyalarının yanında siz oluşturursunuz.

Dosyanın içeriği Çoklu Oturum Açma (Single Sign-On) bölümünde açıklanmıştır; dosyaya ihtiyaç duyulan yer de burasıdır: dashboard'un sunduğu oturum açma seçeneklerini ve çoklu örnek dağıtımlarında backend bağlantısını içerir.

Web sunucunuzu seçin ve ilgili dağıtım adımlarını izleyin.

nginx'e Dağıtım¶

nginx Kurulumu bölümünü izlediyseniz server bloğu zaten dashboard klasörünüzü gösterir ve herhangi bir kopyalama gerekmez.

1. Yolu doğrulayın
2. /etc/nginx/conf.d/digna.conf dosyasını açın

3. root değerinin çıkardığınız dashboard klasörünü gösterdiğini doğrulayın

4. Klasörün okunabilir olduğundan emin olun

   sudo chmod -R a+rX /opt/digna/dashboard
   

5. nginx'i yeniden yükleyin

   sudo nginx -t
   sudo systemctl reload nginx
   

6. Kurulumu Test Edin

7. Tarayıcınızı açın
8. http://localhost (veya yapılandırdığınız URL) adresine gidin
9. digna dashboard giriş sayfasını görmelisiniz

Apache httpd'ye Dağıtım¶

1. Dashboard'u Belge Köküne Kopyalayın

   sudo cp -R /opt/digna/dashboard /var/www/html/digna
   

2. Yeniden Yazma Kurallarını Ekleyin

Dashboard rotalarının tarayıcı yenilemesinden sonra da çalışması için dağıtılan klasörün içinde bir .htaccess dosyası oluşturun:

sudo nano /var/www/html/digna/.htaccess

Aşağıdakini yapıştırın:

RewriteEngine On
RewriteBase /digna/

# Serve existing files and directories as-is.
RewriteCond %{REQUEST_FILENAME} -f [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^ - [L]

# Everything else falls back to the single-page application entry point.
RewriteRule ^ index.html [L]

1. Apache'yi Yeniden Başlatın

   sudo systemctl restart apache2
   

   sudo systemctl restart httpd
   

2. Dashboard'a Erişim

3. Tarayıcınızı açın
4. http://localhost/digna adresine gidin
5. digna dashboard giriş sayfasını görmelisiniz

Adım 2: SELinux (Yalnızca RHEL Ailesi)¶

RHEL, Rocky, AlmaLinux ve Fedora'da SELinux varsayılan olarak zorlayıcı (enforcing) moddadır ve web sunucusunun beklenen konumlarının dışındaki dosyaları okumasını engeller. Etkin olup olmadığını denetleyin:

getenforce

Sonuç Enforcing ise ve dashboard'u /opt/digna/dashboard konumundan sunuyorsanız, web sunucusunun okuyabilmesi için dizini etiketleyin:

sudo semanage fcontext -a -t httpd_sys_content_t "/opt/digna/dashboard(/.*)?"
sudo restorecon -Rv /opt/digna/dashboard

digna'yı systemd Hizmeti Olarak Çalıştırma¶

Neden digna'yı Hizmet Olarak Çalıştırmalı?¶

digna backend'ini systemd hizmeti olarak çalıştırmak şu avantajları sağlar:

• Makine açıldığında otomatik olarak başlar
• Açık bir terminal penceresi olmadan arka planda çalışır
• Çöktüğünde otomatik olarak yeniden başlar
• Standart Linux hizmet yöneticisi olan systemctl üzerinden yönetilebilir

Hizmet Yönetim Dosyaları¶

Gerekli tüm dosyalar digna kurulum dizininin altında: bin/ dizininde bulunur.

Mevcut kabuk betikleri:

• install_service.sh — digna'yı systemd'ye kaydeder
• uninstall_service.sh — hizmet kaydını kaldırır
• start_service.sh — kayıtlı hizmeti başlatır
• stop_service.sh — çalışan hizmeti durdurur

Betikleri Çalıştırılabilir Yapma¶

Çıkarma işlemi çalıştırma izni bitini korumayabilir. İlk kullanımdan önce:

cd /opt/digna/bin
sudo chmod +x *.sh

Hizmeti Yükleme¶

1. Bir terminal açın

2. bin Klasörüne Gidin

   cd /opt/digna/bin
   

3. Kurulum Betiğini Çalıştırın

   sudo ./install_service.sh
   

digna sunucusu artık otomatik başlatma etkinleştirilmiş şekilde systemd'ye kayıtlıdır. Hizmet hemen başlamaz — başlatmak için bir sonraki bölüme bakın.

Hizmeti Başlatma ve Durdurma¶

Hizmeti Başlatmak İçin¶

1. Bir terminal açın
2. /opt/digna/bin dizinine gidin
3. Şunu çalıştırın:

   sudo ./start_service.sh
   

Hizmeti Durdurmak İçin¶

1. Bir terminal açın
2. /opt/digna/bin dizinine gidin
3. Şunu çalıştırın:

   sudo ./stop_service.sh
   

Hizmeti systemctl ile Yönetme¶

Kaydedildikten sonra hizmet, herhangi bir dizinden standart systemd komutlarıyla da denetlenebilir:

sudo systemctl start digna
sudo systemctl stop digna
sudo systemctl restart digna
sudo systemctl status digna

Hizmeti Doğrulama¶

Hizmetin kayıtlı olduğunu ve çalıştığını doğrulamak için:

systemctl is-enabled digna
systemctl is-active digna

enabled, hizmetin sistem açılışında başladığı; active ise şu anda çalıştığı anlamına gelir.

Hizmet Günlüklerini Görüntüleme¶

systemd, backend'in konsola yazdığı her şeyi yakalar. Okumak için:

sudo journalctl -u digna -n 100

Bir sorunu yeniden oluştururken günlüğü canlı izlemek için:

sudo journalctl -u digna -f

Hizmeti Yeni Bir Dizine Taşıma¶

Unit dosyası yürütülebilir dosyanın mutlak yolunu sakladığından, kurulumun yerini değiştirmek hizmetin yeniden kaydedilmesini gerektirir:

1. Mevcut Hizmeti Kaldırın

   cd /old/path/digna/bin
   sudo ./uninstall_service.sh
   

2. Uygulama Dosyalarını Taşıyın

   sudo mv /old/path/digna /new/path/digna
   

3. Hizmeti Yeniden Kurun

   cd /new/path/digna/bin
   sudo ./install_service.sh
   

4. Hizmeti Başlatın

   sudo ./start_service.sh
   

Hizmeti Kaldırma¶

1. Çalışan Hizmeti Durdurun

   cd /opt/digna/bin
   sudo ./stop_service.sh
   

2. Hizmeti Kaldırın

   sudo ./uninstall_service.sh
   

digna sunucusunun systemd kaydı artık kaldırılmıştır.

Yeni Bir Sürüme Yükseltme¶

Bu bölüm, Sürüm 2026.06 kurulumunu Sürüm 2026.11'e yükseltir. Kurulumunuz daha eskiyse önce 2026.06'dan Önceki Bir Sürümden Yükseltme bölümünü okuyun.

Yükseltme Öncesi¶

digna Repository Yedeği Almak Zorunludur

digna'yı yükseltmeden önce veri kaybını önlemek için repository'nizin (PostgreSQL) yedeğini alın. Bir yedek, yükseltme sırasında beklenmeyen sorunlar çıkarsa geri dönüş yapabilmenizi sağlar.

Kabuktan yedek almak için:

pg_dump -h localhost -p 5432 -U digna_user -n dignarepo postgres > digna_repo_backup.sql

Sürüm 2026.11 için Lisans Dosyasını Talep Etme

Sürüm 2026.11 yeni bir license.toml gerektirir. Başlamadan önce bu dosyayı digna ekibinden talep edin ve Adım 7 için hazır bulundurun.

2026.06'dan Önceki Bir Sürümden Yükseltme¶

Sürüm 2026.06, eski bir kurulumu doğrudan 2026.11'e yükselttiğinizde hâlâ geçerli olan üç değişiklik getirdi:

• Yalnızca ODBC. digna her kaynak teknolojisine ODBC üzerinden erişir. Henüz ODBC kullanmayan her veritabanı bağlantısı yükseltmeden sonra ODBC'ye taşınmalıdır; otomatik dönüştürme yoktur. ODBC sürücülerini önceden digna ana bilgisayarına kurun, bkz. ODBC Sürücüsünü digna Ana Bilgisayarına Kurma, ve her bağlantının özelliklerini teknoloji kılavuzlarından alarak hazır bulundurun. Databricks Legacy bağlayıcısı artık yoktur; bu bağlantıları Databricks bağlayıcısına taşıyın.
• Tek yürütülebilir dosya. dignabackend ve dignacli, backend ile CLI'yi birleştiren tek digna yürütülebilir dosyasıyla değiştirilmiştir.
• config.toml. [encryption] bölümü zorunludur; DIGNA_APP_HOST ve DIGNA_APP_PORT ise artık okunmaz: sunucu adresini ve portunu digna serve komutundan alır. Dosyanızı Backend Yapılandırması ile karşılaştırın.

Aşağıdaki adımlar, eski bir kurulumun nerede farklı bir işlem gerektirdiğini belirtir. Adım 8'deki repository yükseltmesi, önceki herhangi bir sürümün repository'sini doğrudan 2026.11'e getirir.

Yükseltme Süreci¶

Adım 1: digna Hizmetini Durdurun¶

digna bir systemd hizmeti olarak çalışıyorsa, önce durdurun:

cd /opt/digna/bin
sudo ./stop_service.sh

digna ön planda çalışıyorsa, terminal penceresinde Ctrl+C tuşlarına basın.

Adım 2: Mevcut Kurulumu Yedekleyin¶

digna kurulum dizininizde, yeni sürümün yanına dağıtılabilmesi için mevcut kurulumunuzun yürütülebilir dosyasını ve dashboard klasörünü yeniden adlandırın:

cd /opt/digna
sudo mv digna digna_old
sudo mv dashboard dashboard_old

digna_old dosyasını yükseltmeyi doğrulayana kadar, dashboard_old klasörünü ise yapılandırma dosyalarınızı oradan geri yükleyene kadar saklayın (bkz. Adım 4). Sonrasında ikisini de silebilirsiniz.

Adım 3: Yeni Sürümü Çıkarın ve Dağıtın¶

1. Yeni digna kurulum ZIP dosyasını çıkarın
2. Yeni digna yürütülebilir dosyasını ve dashboard klasörünü kurulum dizinine kopyalayın
3. Çalıştırma izni bitini ve hizmet hesabının sahipliğini geri yükleyin:

sudo chmod +x /opt/digna/digna
sudo chown -R digna:digna /opt/digna

Adım 4: Yapılandırma Dosyalarınızı Geri Yükleyin¶

sudo cp dashboard_old/dashboard_config.toml dashboard/dashboard_config.toml

Sürüm 2026.11, config.toml dosyasında değişiklik gerektirmez: Sürüm 2026.06 ile çalışan bir dosya çalışmaya devam eder. İki değişiklik isteğe bağlıdır:

• Veritabanı bağlantıları digna Engine'i kullanacaksa ve varsayılanlar ana bilgisayarınıza uygun değilse bir [duckdb] bölümü ekleyin.
• Bir ters vekil sunucu dashboard'u ve backend'i aynı kaynak (origin) altında sunuyorsa [app] bölümünü çıkarın.

[[oidc_clients]]
DIGNA_OIDC_KEY = 'microsoft'
DIGNA_OIDC_CLIENT_ID = '<client_id>'
DIGNA_OIDC_CLIENT_SECRET = '<client_secret>'
DIGNA_OIDC_REDIRECT_URI = 'http://localhost:3000/oidc/callback'
DIGNA_OIDC_CONFIGURATION_URL = 'https://login.microsoftonline.com/<tenant_id>/v2.0/.well-known/openid-configuration'

Adım 5: Web Sunucusunu Yeniden Yükleyin¶

Dashboard bir statik dosyalar kümesidir; bu nedenle web sunucunuz — ve tarayıcı — hâlâ önceki sürümü sunuyor olabilir. dashboard klasörünü barındıran web sunucusunu yeniden yükleyin veya yeniden başlatın, ardından sayfayı zorla yenileyin (Ctrl+F5).

Adım 6: Yapılandırmayı Doğrulayın¶

Depoya dokunmadan önce config.toml dosyasının eksiksiz olduğunu doğrulayın:

./digna config check

Her bölüm OK bildirmelidir. FAILED olarak bildirilen her şeyi düzeltin, Unknown keys altında listelenen anahtarları kaldırın ve devam etmeden önce komutu yeniden çalıştırın.

Adım 7: Lisans Dosyasını Değiştirin¶

Bir lisans dosyası normalde bir sürümden diğerine aktarılır. Sürüm 2026.11 bir istisnadır: iki lisanslı modül, digna Data Reconciliation ve digna Agentic ekler ve 2026.11'den önce verilmiş bir lisans bunları içermez. digna ekibinin Sürüm 2026.11 için sağladığı license.toml dosyasını kurulum dizinine kopyalayarak eskisinin yerine koyun:

sudo cp /path/to/new/license.toml /opt/digna/license.toml

./digna license check

Adım 8: Repository Şemasını Yükseltin¶

digna kurulum dizininizde şunu çalıştırın:

cd /opt/digna
./digna repo upgrade

Sürüm 2026.11, repository şemasını sürümlendirilmiş geçişlerle (migration) yönetir. Önceki bir sürümden yapılan ilk yükseltme, şemayı önceki düzenin son sürümüne getirir, bunu başlangıç noktası olarak kaydeder ve ardından Sürüm 2026.11'in geçişlerini uygular. Şu çıktıyla tamamlanır:

✅ Baseline migration recorded as applied.
✅ Repo schema 'dignarepo' is up to date.

Mevcut tüm veriler korunur. Repository'nin durumunu istediğiniz zaman görmek için ./digna repo check komutunu çalıştırın: uygulanan en son geçişi ve bekleyen geçişleri listeler.

Error: Legacy repo version 3.0.2 installed. Use the 'digna repo upgrade' command to upgrade it.

Adım 9: Hizmetleri Yeniden Başlatın¶

systemd hizmeti olarak çalışıyorsa:

cd /opt/digna/bin
sudo ./start_service.sh

Manuel olarak çalıştırıyorsanız, sunucuyu yeniden başlatın:

cd /opt/digna
./digna serve --address <address> --port <port>

nginx veya Apache kullanıyorsanız ilgili web sunucusunu yeniden yükleyin:

sudo systemctl reload nginx

sudo systemctl restart apache2

RHEL ailesinde, dashboard dizini değiştirildiyse SELinux etiketlemesini yeniden uygulayın:

sudo restorecon -Rv /opt/digna/dashboard

Adım 10: Yükseltmeyi Doğrulayın¶

1. Yeni yürütülebilir dosyanın sürümünü doğrulayın:

   ./digna version
   

   İlk satır Release: 2026.11 olmalıdır.

2. digna dashboard'a erişin ve arayüzün düzgün yüklendiğini doğrulayın.

3. Sunucu günlüklerini hatalara karşı kontrol edin:

   sudo journalctl -u digna -n 100
   

4. Veritabanı bağlantılarınızı sınayın — bkz. Bağlantıyı Sınama. 2026.06'dan önceki bir sürümden yükselttiyseniz, önce henüz ODBC kullanmayan her bağlantıyı ODBC'ye taşıyın.

Yeni modüllerle çalışmaya başlamak için bkz. digna Data Reconciliation, digna MCP Server için Bir Yapay Zekâ Ajanı Bağlama ve digna Engine için Profilleme Konumu.