Yükleniyor…

Kurulum

Documenos ®

Documenos® hem x86 hem de ARM mimarisiyle uyumludur.

Sunucunuzdaki işlemci modeli x86 tabanlı veya ARM tabanlı olabilir. Documenos® her ikisiyle de uyumludur. Her iki sunucu mimarisi için uygun kurulum dosyalarını şu sayfadan indirebilirsiniz: İndirme

İki kurulum yolu vardır: Docker ile tüm bileşenler tek komutla ayağa kalkar ve önerilen yöntem budur. Windows IIS kurulumu ise uygulamayı mevcut Windows sunucu altyapınızda çalıştırmak istediğinizde tercih edilir.

ARM / x86

Docker ile Kurulum

Tek bir paket; uygulamayı, PostgreSQL veritabanını, Dijital İmza Servisini, Elasticsearch arama motorunu ve LibreTranslate çeviri servisini birlikte kurar.

  1. Ön koşulları hazırlayın. Sunucunuzda Docker Engine (20.10+) ve Docker Compose eklentisi (2.0+) kurulu olmalıdır. Uygulama konteyneri için en az 8 GB RAM ayrılabilmeli ve konteyner imajlarını indirmek için sunucunun internet erişimi bulunmalıdır. Linux, Windows ve macOS üzerinde çalışır.
  2. Paketi indirin. İndirme sayfasından Docker Compose paketini (ZIP) indirin. Paket; servis tanımlarını içeren docker-compose.yml, yapılandırma değerlerini içeren .env ve kurulum notlarını içeren readme.md dosyalarından oluşur. Klasörü olduğu gibi sunucunuza kopyalayın.
  3. Parolaları belirleyin. .env dosyasını açın ve konteynerleri başlatmadan önce şu iki değeri mutlaka kendi güçlü ve benzersiz değerlerinizle değiştirin: DB_PASSWORD (PostgreSQL veritabanı kullanıcısının parolası) ve DEFAULT_PWD (yeni oluşturulan kullanıcılara atanan ilk parola; kullanıcılar ilk girişten sonra değiştirmelidir). Üretim ortamında asla örnek veya varsayılan parola kullanmayın.
  4. Ağ ve port ayarlarını gözden geçirin. *_BIND_IP ve *_PORT değerlerini kontrol edin. Varsayılan olarak veritabanı, imza, arama ve çeviri servisleri yalnızca 127.0.0.1 adresine bağlanır ve dışarıdan erişilemez; dışarıya açık olan tek port uygulama portudur (APP_PORT, varsayılan 8080). Uygulama bir yük dengeleyici veya ters vekil sunucu arkasındaysa CLIENT_IP_HEADER değerini (örneğin X-Forwarded-For) doldurun.
  5. Servisleri başlatın. docker-compose.yml dosyasının bulunduğu klasörde şu komutu çalıştırın: docker compose up -d
  6. İlk başlatmanın tamamlanmasını bekleyin. İlk açılışta çeviri servisi TRANSLATE_LOAD_ONLY ile belirlenen dil modellerini indirir; bu, normal bir bağlantıda 5–10 dakika sürer ve yalnızca bir kez yapılır. İlerlemeyi docker compose ps ve docker compose logs -f documenos_translate komutlarıyla izleyebilirsiniz. Servis indirme sırasında starting, hazır olduğunda healthy görünür. Bağlantınız yavaşsa TRANSLATE_START_PERIOD değerini artırın.
  7. Uygulamayı açın. Tarayıcınızda http://sunucu-adresiniz:8080 adresini (veya belirlediğiniz APP_PORT değerini) açın, ilk çalıştırma yönergelerini izleyerek yönetici hesabını oluşturun ve lisansınızı kaydedin.

Güncelleme: En son paketi indirin, mevcut yapılandırma değerlerinizi yeni .env dosyasına aktarın ve docker compose pull ardından docker compose up -d komutlarını çalıştırın. Verileriniz adlandırılmış Docker birimlerinde (volume) tutulur; güncellemelerden ve yeniden başlatmalardan etkilenmez.

Windows IIS Üzerinde Kurulum

Documenos® bir ASP.NET Core uygulamasıdır; IIS üzerinde ASP.NET Core Modülü aracılığıyla çalışır.

  1. Ön koşulları hazırlayın. Windows Server üzerinde IIS rolünü etkinleştirin ve ASP.NET Core Hosting Bundle paketini kurun. Hosting Bundle IIS'ten sonra kurulmalıdır; aksi hâlde ASP.NET Core Modülü IIS'e kaydolmaz. Kurulumdan sonra IIS'i iisreset komutuyla yeniden başlatın.
  2. Veritabanı sunucusunu hazırlayın. PostgreSQL (v15 veya sonrası) kurun ya da mevcut bir PostgreSQL sunucusuna erişim sağlayın. Documenos® çekirdek (DOCUMENOS_CORE), raporlama (DOCUMENOS_REPORT) ve yüz tanıma (DOCUMENOS_FACE) için ayrı veritabanları kullanır.
  3. Yardımcı servisleri hazırlayın. Tam metin arama için Elasticsearch, elektronik imza için Dijital İmza Servisi ve kendi sunucunuzda otomatik çeviri için LibreTranslate gerekir. Bu servisleri Docker paketindeki tanımlarla ayrı bir sunucuda çalıştırıp uygulamanın erişebileceği adreslerini not edin.
  4. ZIP paketini indirin. İndirme sayfasındaki Windows IIS İçin ZIP Dosyası bölümüne indirme anahtarınızı girerek paketi indirin.
  5. Dosyaları sunucuya açın. ZIP içeriğini web sitesi için ayırdığınız klasöre çıkarın; örneğin C:\inetpub\documenos.
  6. Bağlantı ayarlarını yapın. Uygulama klasöründeki appsettings.json dosyasında ConnectionStrings bölümüne PostgreSQL bağlantı bilgilerinizi (CnStrServer, CnStr, CnStrBI, CnStrFA) girin. İmza ve çeviri servislerinin adreslerini (SignatureServiceUrl, TranslateServiceUrl) de aynı dosyada tanımlayın. Elasticsearch arama sunucusunun bağlantısı ise kurulumdan sonra yönetim panelinden tanımlanır.
  7. Uygulama havuzu oluşturun. IIS Yöneticisi'nde yeni bir uygulama havuzu (Application Pool) ekleyin ve .NET CLR sürümü ayarını Yönetilen Kod Yok (No Managed Code) olarak seçin.
  8. Web sitesini ekleyin. IIS Yöneticisi'nde Siteler → Web Sitesi Ekle adımıyla yeni bir site oluşturun; fiziksel yol olarak dosyaları açtığınız klasörü, uygulama havuzu olarak az önce oluşturduğunuz havuzu seçin. Bağlamaları (port, ana bilgisayar adı) belirleyin ve üretim ortamında HTTPS için bir SSL sertifikası atayın.
  9. Klasör izinlerini verin. Uygulama klasörü için IIS AppPool\<havuz adı> kimliğine okuma ve yazma izni verin. Uygulama; günlükleri, geçici dosyaları ve veri koruma anahtarlarını bu kimlikle yazar.
  10. Siteyi başlatın ve açın. Siteyi başlatın ve tarayıcınızda tanımladığınız adresi açın. Veritabanı yapısı uygulama başlarken otomatik olarak uygulanır. İlk çalıştırma yönergelerini izleyerek yönetici hesabını oluşturun ve lisansınızı kaydedin.

Güncelleme: IIS kurulumunda sürüm yükseltme adımları Bakım ve Güncelleme sayfasında anlatılmaktadır. Lisans kaydı ve deneme modu hakkında bilgi için Lisanslama sayfasını inceleyin.