digna Sürüm 2026.11 için Windows 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ı Windows 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.

macOS veya Linux mu arıyorsunuz?¶

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

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:

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.

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¶

Windows üzerinde PostgreSQL kurmak için şu adımları izleyin:

Adım 1: PostgreSQL İndirin¶

1. PostgreSQL Downloads sayfasını ziyaret edin
2. Windows seçin
3. En güncel yükleyiciyi indirin

Adım 2: Yükleyiciyi Çalıştırın¶

1. İndirilen yükleyici dosyasına çift tıklayın
2. Kurulum sihirbazındaki yönergeleri izleyin

Adım 3: Kurulum Dizini Seçin¶

PostgreSQL'in kurulacağı dizini seçin. Varsayılan konum genellikle uygundur.

Adım 4: Bileşenleri Seçin¶

Standart kurulum için varsayılan bileşen seçeneklerini koruyun.

Adım 5: PostgreSQL Süper Kullanıcı Parolasını Belirleyin¶

PostgreSQL süper kullanıcısı (postgres) için bir parola girip doğrulayın. Bu parolayı güvenli bir şekilde saklayın — daha sonra ihtiyaç duyacaksınız.

Adım 6: Port Numarasını Yapılandırın¶

Varsayılan PostgreSQL portu 5432'dir. İster varsayılanı kullanın ister gerekirse farklı bir port belirleyin.

Adım 7: Yerel Ayarı (Locale) Seçin¶

Veritabanınız için uygun yeri (locale) seçin. Varsayılan genellikle çoğu kurulum için uygundur.

Adım 8: Kurulumu Tamamlayın¶

Kalan adımlarda Next butonuna tıklayarak ilerleyin, ardından Finish ile tamamlayın.

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

Komut İstemi'ni açın ve PostgreSQL'in kurulu olduğunu doğrulayın:

psql --version

Kurulum başarılıysa PostgreSQL sürümünü görmelisiniz.

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:

• Internet Information Services (IIS)
• Apache Tomcat

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

IIS Kurulumu¶

Genel Bakış¶

Internet Information Services (IIS), Microsoft'un web siteleri ve web uygulamalarını barındırmak için sunduğu web sunucusudur.

IIS'i Etkinleştirme¶

1. Denetim Masasını Açın
2. Win + R tuşlarına basın

3. control yazıp Enter tuşuna basın

4. Windows Özelliklerine Gidin

5. Programlar'a tıklayın

6. Windows özelliklerini aç veya kapat'ı seçin

7. Internet Information Services'i Etkinleştirin

8. Aşağı kaydırıp Internet Information Services (IIS) öğesini bulun
9. Onay kutusunu işaretleyin

10. Alt bileşenleri genişletmek için + işaretine tıklayın ve şu alt bileşenlerin seçili olduğundan emin olun:

    • Web Management Tools
    • World Wide Web Services

11. Değişiklikleri uygulamak için OK tuşuna basın

12. IIS Kurulumunu Doğrulayın

13. Tarayıcınızı açın
14. http://localhost adresine gidin
15. IIS Hoş Geldiniz sayfasını görmelisiniz

Gerekli: URL Rewrite Modülü¶

IIS, URL Rewrite bileşeni gerektirir. Resmi Microsoft sayfasından indirin ve yükleyin.

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

IIS'in Markdown dosyalarını (.md) doğru şekilde servis edebilmesi için:

1. IIS Manager'ı açın ( Win + R, inetmgr, Enter )
2. Your Site > MIME Types bölümüne gidin
3. Add... butonuna tıklayın
4. Yapılandırın:
5. File name extension: .md
6. MIME type: text/markdown

Apache Tomcat Kurulumu¶

Genel Bakış¶

Apache Tomcat, Java servlet container ve web sunucusu olarak kullanılan açık kaynaklı bir projedir.

Kurulum¶

1. Apache Tomcat İndirin
2. Apache Tomcat Downloads sayfasını ziyaret edin

3. Windows ZIP dağıtımını indirin

4. Arşivi Çıkarın

5. ZIP dosyasını sisteminizde bir dizine çıkarın

6. Örnek: C:\Program Files\Apache Tomcat

7. Tomcat'in Çalıştığını Doğrulayın

8. Tarayıcınızı açın
9. http://localhost:8080 adresine gidin
10. Apache Tomcat karşılama sayfasını görmelisiniz

İ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 (pgAdmin, psql 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;

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

1. Size sağlanan digna kurulum ZIP dosyasını bulun
2. İstediğiniz kurulum dizinine çıkarın
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)

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ı:

digna_installation/
├── config.toml         (configuration file)
├── license.toml        (YOUR LICENSE FILE - copy here)
├── digna               (main executable)
└── 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.

Konum: digna_installation/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

[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 = "C:\\path\\to\\digna\\tmp"

mkdir C:\path\to\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 Bağlantısını Test Edin¶

1. Komut İstemi'ni açın
2. digna kurulum dizinine gidin ( config.toml ve digna yürütülebilir dosyasının bulunduğu dizin )
3. Bağlantı testi çalıştırın:

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.

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¶

1. Yeni bir Komut İstemi penceresi açın
2. digna kurulum dizinine gidin
3. Yönetici kullanıcısı oluşturmak için şu komutu ç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 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

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.

IIS'e Dağıtım¶

1. IIS Manager'ı açın

2. Win + R tuşlarına basın, inetmgr yazın, Enter

3. Yeni Bir Web Sitesi Oluşturun

4. Sol panelde Sites üstüne sağ tıklayın

5. Add Website...'i seçin

6. Siteyi Yapılandırın

7. Site Name: Bir ad girin (ör. "dignaDashboard")
8. Physical Path: Browse'a tıklayıp dashboard klasörünüzü seçin

9. Binding: IP adresi ve portu ayarlayın (HTTP için varsayılan 80, HTTPS için 443)

10. Siteyi Başlatın

11. OK ile siteyi oluşturun

12. Yeni siteye sağ tıklayıp Start seçeneğini tıklayın

13. Kurulumu Test Edin

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

Apache Tomcat'e Dağıtım¶

1. Dashboard'u Tomcat'e Kopyalayın
2. dashboard klasörünü Tomcat webapps dizinine kopyalayın
3. İsterseniz adını değiştirin (ör. digna)

4. Örnek: C:\Program Files\Apache Tomcat\webapps\digna

5. Dağıtımı Doğrulayın

6. Tomcat yönetim sayfasını yenileyin veya yeniden yükleyin (http://localhost:8080)

7. Dağıtılmış uygulamalar arasında "digna" (veya seçtiğiniz isim) görünmelidir

8. Dashboard'a Erişim

9. Tarayıcınızı açın
10. http://localhost:8080/digna adresine gidin
11. digna dashboard giriş sayfasını görmelisiniz

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

Neden Windows Hizmeti Kullanılır?¶

digna backend'i Windows hizmeti olarak çalıştırmak şu avantajları sağlar: - Sunucu başlatıldığında otomatik olarak başlar - Komut İstemi açık olmadan arka planda çalışır - Çöktüğünde otomatik yeniden başlatma sağlar - Windows Hizmetleri üzerinden yönetilebilir

windows Komutları¶

Hizmet, digna yürütülebilir dosyasının kendisi tarafından, digna windows alt komutlarıyla yönetilir. Çalıştırılacak batch dosyası yoktur.

Her komut, varsayılan olmayan bir adla kaydedilmiş bir hizmete erişmek için --name seçeneğini kabul eder. Seçeneklerin tam listesi CLI başvurusunda yer alır.

Hizmeti Yükleme¶

1. Komut İstemi'ni Yönetici Olarak Açın
2. Komut İstemi üzerine sağ tıklayın

3. "Run as Administrator" (Yönetici olarak çalıştır) seçeneğini seçin

4. digna kurulum dizininize gidin

   cd C:\path\to\digna
   

5. Hizmeti kaydedin

   digna windows install
   

digna windows install --address 0.0.0.0 --port 8082

Hizmet otomatik başlatma ile kaydedilir, bu nedenle Windows ile birlikte başlar. Hemen başlamaz — bir sonraki bölüme bakın.

Yükleme Seçenekleri¶

Hizmeti Başlatma ve Durdurma¶

Hizmeti Başlatmak İçin¶

digna windows start

Hizmeti Durdurmak İçin¶

digna windows stop

Hizmeti Yeni Bir Dizin Altına Taşımak¶

digna kurulumunu taşımaya ihtiyacınız varsa:

1. Mevcut hizmeti durdurun ve kaydını kaldırın

   cd C:\old\path\digna
   digna windows stop
   digna windows uninstall
   

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

3. Tüm digna kurulum klasörünü yeni konuma taşıyın

4. Hizmeti yeni konumdan yeniden kaydedin

   cd C:\new\path\digna
   digna windows install
   

İlk seferde kullandığınız --address, --port veya --account değerlerini yineleyin — önceki kayıt artık yoktur.

1. Hizmeti Başlatın

   digna windows start
   

Hizmeti Kaldırma¶

1. Çalışan Hizmeti Durdurun

   cd C:\path\to\digna
   digna windows stop
   

2. Hizmetin Kaydını Kaldırın

   digna windows uninstall
   

digna sunucusu artık Windows hizmeti olarak kayıtlı olmayacaktı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.

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¶

Yönetici olarak bir Komut İstemi açın ve hizmeti mevcut kurulumunuzun digna yürütülebilir dosyasıyla durdurun:

cd C:\path\to\digna
digna windows stop

Hizmet kayıtlı kalır. Yeni yürütülebilir dosya aynı dizinde eskisinin yerini alır; bu nedenle kayıt doğru dosyayı göstermeye devam eder.

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

cd C:\path\to\digna\bin
stop_service.bat
uninstall_service.bat

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 C:\path\to\digna
ren digna.exe digna_old.exe
ren dashboard dashboard_old

digna_old.exe 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

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

copy 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:

copy /Y C:\path\to\new\license.toml license.toml

digna license check

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

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

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¶

digna bir Windows hizmeti olarak çalışıyorsa hizmeti tekrar başlatın:

cd C:\path\to\digna
digna windows start

2026.06'dan önceki bir sürümden yükselttiyseniz ve Adım 1'de hizmetin kaydını kaldırdıysanız, önce hizmeti digna yürütülebilir dosyasıyla yeniden kaydedin:

cd C:\path\to\digna
digna windows install --address <address> --port <port>
digna windows start

127.0.0.1 ve 8000 varsayılanlarını istemiyorsanız --address ve --port için eski hizmetin hizmet verdiği değerleri verin. Eski hizmet bir etki alanı hesabıyla çalışıyorsa --account ve --password ekleyin. Seçeneklerin tam listesi için bkz. digna'yı Windows Hizmeti Olarak Çalıştırma.

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

cd C:\path\to\digna
digna serve --address <address> --port <port>

IIS veya Tomcat kullanıyorsanız ilgili web sunucusunu yeniden başlatın.

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. Kurulumun logs dizinindeki dosyaları hatalara karşı kontrol edin.
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.