mindzieStudio Yerinde Kurulum Kılavuzu

Genel Bakış

mindzieStudio'nun Yapay Zekâ Destekli Süreç Madenciliği ve Otomasyon platformu, kuruluşunuzdaki iş akışlarının kapsamlı ve derinlemesine bir anlayışını sunar, süreçler üzerinde eşsiz bir görünürlük sağlar, darboğazları, verimsizlikleri ve iyileştirme alanlarını tespit eder. Süreç madenciliği araçlarını kullanarak, kullanıcılar gerçek zamanlı içgörüler elde edebilir; bu sayede operasyonları kolaylaştırabilir, uyumu artırabilir ve genel verimliliği iyileştirebilir. mindzieStudio, kuruluşların veri odaklı kararlar almasını, süreçleri maksimum verimlilik için optimize etmesini, operasyonel maliyetleri azaltmasını, süreç yürütme hızını artırmasını ve işletme genelinde kusursuz, standartlaşmış bir iş akışı sağlamasını güçlendirir.

Temel Faydalar

• Süreç Zamanlarını İyileştir - İş akışlarını daha hızlı yürütme için optimize et
• Atıkları Azalt - Verimsizlikleri belirle ve ortadan kaldır
• Uyumu İzle ve Sağla - Düzenleyici standartları sürdür

---

Kurulum Türü

Bu kılavuz hem çevrimiçi hem de çevrimdışı kurulumları kapsamaktadır. Ortamınıza göre seçim yapınız:

Kurulum Türü	Ne Zaman Kullanılır
Çevrimiçi	Sunucu internete bağlıysa
Çevrimdışı	Sunucunun internet erişimi yoksa (air-gapped)

Çevrimdışı kurulumlar için, gerekli tüm dosyalar internet erişimi olan bir makineden indirilip hedef sunucuya aktarılmalıdır.

---

Kurulum Öncesi Kontrol Listesi

Planlanan kurulumdan ÖNCE aşağıdaki maddeleri tamamlayınız. Bu sayfayı yazdırıp her maddeyi işaretleyebilirsiniz.

SSL Sertifikası

• IT/Güvenlik departmanından SSL sertifikası alındı
• Sertifika dosyası(i) IIS'ye aktarılmak üzere hazır
• Sertifika planlanan alan adıyla uyumlu

DNS Yapılandırması

• DNS kaydı oluşturuldu (örn: mindzie.[sirketiniz].com)
• DNS kaydı VM'nin IP adresine işaret ediyor
• DNS yayılımı doğrulandı (ana bilgisayar adı çözümleniyor)

SQL Server (Birini Seçiniz)

Seçenek A: Mevcut SQL Server Kullanımı

• SQL Server örneği belirlendi ve VM'den erişilebilir
• Veri tabanı yöneticisi mevcut ve:
  • "mindzie" adlı yeni bir veri tabanı oluşturabilir
  • db_owner izinleri olan uygun bir giriş oluşturabilir (Aşağıdaki Kimlik Doğrulama Moduna bakınız)
  • Bağlantı bilgilerini sağlayabilir
• Kimlik doğrulama modu belirlendi (bir sonraki bölüm)

Seçenek B: VM Üzerine SQL Server Express Kurulumu

• SQL Server Express yükleyicisi mevcut (çevrimiçi ise indirildi veya çevrimdışı ise aktarıldı)
• IT personeli SQL Server Express'i kurmaya hazır
• Not: SQL Express ücretsizdir ancak kurumsal özellikler (yedekleme, mirroring) içermez
• SQL Server Express Kurulumu kılavuzuna bakınız

SQL Server Kimlik Doğrulama Modu

Aşağıdaki kimlik doğrulama modlarından birini seçiniz:

Mod	Gereksinimler	En Uygun Alan
Mixed Mod (SQL Server + Windows Kimlik Doğrulama)	Kullanıcı adı/şifre ile SQL girişi	Önerilen. Daha basit kurulum - Windows servisi ve IIS uygulama havuzu varsayılan Local System hesabında kalabilir
Sadece Windows Kimlik Doğrulama	SQL izinlerine sahip, hem Windows servisi hem de IIS uygulama havuzu tarafından kullanılan bir Windows servis hesabı	Güvenlik politikası SQL girişlerine izin vermeyen ortamlar

Mixed Mod için:

• SQL Server’da Mixed Mod kimlik doğrulaması etkinleştirildi
• SQL giriş kimlik bilgileri oluşturulacak (kullanıcı adı/şifre)

Sadece Windows Kimlik Doğrulama için:

• Windows servis hesabı belirlendi ya da oluşturulacak
• Servis hesabı mindzie veritabanına db_owner erişimine sahip olacak
• Bu hesap altında hem Windows servisinin hem de IIS uygulama havuzunun çalıştırılması için izin mevcut
• Servis hesabına IIS web sitesi, servis ve depolama dizinleri için okuma/yazma erişimi verilecek (bkz. Adım 4)

Sanal Makine

• Windows Server 2019 veya daha yenisi sağlandı
• Minimum gereksinimleri karşılıyor: 4+ çekirdek, 8GB+ RAM, 100GB+ depolama (Teknik Gereksinimler sayfasına bakınız)
• Aşağıdaki işlemler için tam erişime sahip yönetici mevcut:
  • Yazılım kurulumu
  • IIS yapılandırması
  • Windows servis yönetimi
• İnternet bağlantısı var (yalnızca çevrimiçi kurulum için)

Ek Maddeler

• mindzieStudio lisans anahtarı mindzie'den alındı
• Planlanan bakım/durum kesinti zamanı kullanıcılarla paylaşıldı (varsa)

---

Kurulum Adımları

Adım 1: SQL Server Yapılandırması

Gereksinimler:

1. SQL sunucunuzda veri tabanı oluşturma izni
2. SQL Server Management Studio (tercih edilir)

Kurulum Süreci:

1. SQL Server Management Studio'yu başlatın
2. mindzie veri tabanını doğru tipte sıralama (collation) ile oluşturun

Sonra kimlik doğrulama modunuza göre devam edin:

Mixed Mod (SQL Server Kimlik Doğrulama) Kullanıyorsanız

3. SQL Server’da Mixed Mod kimlik doğrulamanın etkin olduğundan emin olun
4. "mindzie" adlı bir SQL login oluşturun
5. "mindzie" girişine "mindzie" veri tabanında db_owner erişimi verin

Sadece Windows Kimlik Doğrulama Kullanıyorsanız

3. Bir Windows servis hesabı belirleyin veya oluşturun (örn: DOMAIN\mindzieService)
4. SQL Server’da bu Windows hesabı için bir login oluşturun
5. Bu Windows login’e "mindzie" veri tabanında db_owner erişimi verin
6. Not: 4. adımda hem mindzieStudio Windows servisini hem de IIS uygulama havuzunu bu hesap altında çalışacak şekilde yapılandıracaksınız

Adım 2: Internet Information Services (IIS)

Yapılandırma:

1. Sunucuda .NET kurulumu öncesinde IIS'nin etkin olduğundan emin olun
2. Eğer .NET önceden kurulduysa, .NET yüklemesini onarın
3. Web Server -> Application Development altında "WebSocket Protocol" eklentisini aktif edin

Not: Sonraki adıma geçmeden önce IIS'nin düzgün yapılandırıldığından emin olun.

Adım 2a: WebDAV Kaldırma

WebDAV sunucudan kaldırılmalıdır. Bu özellik HTTP isteklerini (PUT, DELETE, MOVE) mindzieStudio’ya ulaşmadan önce keser ve API hatalarına yol açar.

PowerShell'i Yönetici olarak açın ve şu komutu çalıştırın:

Remove-WindowsFeature Web-DAV-Publishing

Sunucu yeniden başlatması gerekebilir. Detay için WebDAV'nın Devre Dışı Bırakılması sayfasına bakınız.

Adım 3: .NET Runtime Kurulumu

Adım 4: mindzieStudio Kurulumu

Lisans Yapılandırması (Tüm Kurulumlar)

1. Kurulum sonrası EnterpriseConfiguration uygulamasını çalıştırın
2. Lisansınızı metin kutusuna yapıştırın ve "Yeni Lisansı Aktifleştir" butonuna tıklayın

Veri Tabanı Yapılandırması

1. "Database Settings" butonuna tıklayın
2. "Change SQL Server" seçeneğine tıklayın
3. Kimlik doğrulama modunuza göre yapılandırın:

Mixed Mod kullanıyorsanız (SQL Server Kimlik Doğrulama):

• Doğru SQL Server adı girildiğinden emin olun
• Kimlik doğrulamayı "SQL Server Authentication" olarak ayarlayın
• SQL kullanıcı adı ve şifreyi girin
• "Update Database" butonuna tıklayın

Sadece Windows Kimlik Doğrulama kullanıyorsanız:

• Doğru SQL Server adı girildiğinden emin olun
• Kimlik doğrulamayı "Windows Authentication" olarak ayarlayın
• "Update Database" butonuna tıklayın
• Ardından aşağıda açıklandığı gibi her iki servis hesabını da değiştirin

Her iki hesabı değiştirmek için:

1. Enterprise Configuration aracında Service / IIS Status bölümünü bulun ve Settings... butonuna tıklayın
2. Açılan pencerede, her biri kendi Change Account... butonuna sahip iki bağımsız bölüm vardır: biri Windows Service: mindzieStudioService, diğeri IIS Application Pool: mindzieStudioAppPool başlıklıdır. İkisi de aynı Windows servis hesabına ayarlanmalıdır.
3. Her bölümde sırayla Change Account... butonuna tıklayın, Custom Account (recommended for Windows Auth) seçeneğini seçin, hesap adını ve şifreyi girin ve OK butonuna tıklayın.
4. Her iki bölümdeki Account alanının artık servis hesabınızı gösterdiğini doğrulayın. Herhangi biri hâlâ LocalSystem, NT AUTHORITY\SYSTEM veya ApplicationPoolIdentity gösteriyorsa, değiştirilmemiştir.

Windows servis hesabını Windows Servisleri (services.msc) üzerinden de ayarlayabilirsiniz -> mindzieStudioService üzerinde sağ tık -> Özellikler -> Oturum Aç sekmesi. Uygulama havuzu için services.msc içinde bir karşılığı yoktur - bunu yapılandırma aracından ya da IIS Yöneticisi -> Uygulama Havuzları -> mindzieStudioAppPool -> Gelişmiş Ayarlar -> Kimlik üzerinden değiştirin.

Servis hesabının ihtiyaç duyduğu izinler:

Gereksinim	Nerede verilir
mindzie veritabanı üzerinde db_owner yetkisine sahip SQL girişi	SQL Server (Adım 1)
IIS web sitesi dizinine okuma/yazma erişimi	Windows klasör izinleri
Servis dizinine okuma/yazma erişimi	Windows klasör izinleri
Depolama dizinine okuma/yazma erişimi	Windows klasör izinleri

Şifresi sabit kalan bir hesap kullanın veya şifre her değiştiğinde Windows servisi ile uygulama havuzunun kimlik bilgilerini güncellemek için bir prosedür oluşturun - kayıtlı şifre geçerliliğini yitirdiği anda site çalışmayı durdurur.

Veritabanı Yapılandırmasını Doğrulayın

Sunucuyu teslim etmeden önce kurulumun gerçekten çalıştığını doğrulayın:

1. Windows servisi "Running" durumuna ulaşır. Settings penceresinde veya services.msc içinde mindzieStudioService durumu Running olmalıdır. StartPending durumunda takılı kalması ya da başladıktan kısa süre sonra Stopped durumuna dönmesi, hesabın veritabanını açamadığı anlamına gelir.
2. Uygulama havuzu başlatılmıştır (Started) ve Account alanı servis hesabınızı gösterir.
3. Site yüklenir. mindzieStudio adresine gidin ve oturum açın. Başlangıçtaki bir veritabanı hatası, oturum açma ekranı yerine bir hata sayfası üretir.

Adım 4a: Python Kurulumu (Opsiyonel)

Python zenginleştirmeleri veya Python Script eylemleri kullanmayı planlıyorsanız, şimdi Python’u kurun.

Detaylı Python kurulum talimatları için Python Kurulumu sayfasına bakınız.

Adım 5: IIS’de SSL Yapılandırması

SSL Yapılandırması:

1. Internet Information Services (IIS) üzerinde SSL Sertifikasını yapılandırın
2. 1. adımdaki SSL sertifikası ile https binding ekleyin
3. Bu binding üretim ortamları için localhost olmamalıdır

Önerilen DNS:

• mindziestudio.[şirketadı].com

Önemli Notlar:

• Üretim ortamları için SSL yapılandırması zorunludur
• Güvenlik için uygun sertifika yönetimi yapın

---

Güncellemeler

---

Ek Yapılandırma

Yükseltmeler

Enterprise sunucunuzu yükseltirken, IIS üzerindeki web sitesine sertifikanızı yeniden eklemeniz gerekecektir.

Lisans Güncellemeleri

Lisansınızı yükselttiyseniz, değişikliğin geçerli olması için şu adımları izleyin:

1. Enterprise Configuration aracını çalıştırın ve lisans yenileme butonuna tıklayın
2. IIS üzerindeki mindzie web sitesini yeniden başlatın

LLM Yapay Zekâ Entegrasyonu

mindzie’nin Yapay Zekâ yardımcı pilotu ve diğer özellikleri için yerinde (on-premise) LLM kullanımı hakkında detaylı bilgi için support@mindzie.com adresiyle iletişime geçiniz.

---

Sorun Giderme

"Cannot open database mindzie requested by the login. Login failed for user 'NT AUTHORITY\SYSTEM'"

Belirti: Kurulum tamamlandı ve lisans geçerli, ancak site başlatılırken şuna benzer bir hata veriyor:

SqlException 4060: Cannot open database "mindzie" requested by the login.
Login failed for user 'NT AUTHORITY\SYSTEM'.

Nedeni: Windows Kimlik Doğrulama seçtiniz, ancak mindzieStudio Windows servisi ve/veya IIS uygulama havuzu hâlâ Local System olarak çalışıyor. NT AUTHORITY\SYSTEM, Local System hesabıdır ve SQL Server’ınızda bir girişi yoktur. Veritabanının kendisi sorunsuzdur - uygulamanın yalnızca veritabanını açmaya yetkili bir kimliği yoktur. Bu durum genellikle sadece Windows servisinin hesabı değiştirildiğinde ve mindzieStudioAppPool uygulama havuzu varsayılan değerinde bırakıldığında ortaya çıkar.

Çözüm:

1. Enterprise Configuration aracını açın -> Service / IIS Status -> Settings...
2. Her iki bölümdeki Account alanını kontrol edin. LocalSystem, NT AUTHORITY\SYSTEM veya ApplicationPoolIdentity değerlerinin herhangi biri sorunun kaynağıdır.
3. Her bir bölümde Change Account... ile Windows servis hesabınızı ayarlayın. İkisi de değiştirilmelidir - bkz. Adım 4, Veritabanı Yapılandırması.
4. Hesabın mindzie veritabanı üzerinde db_owner yetkisine sahip bir SQL girişi olduğunu doğrulayın (Adım 1).
5. Hesaba IIS web sitesi, servis ve depolama dizinleri için okuma/yazma erişimi verin - yapılandırma aracı bu yolları gösterir ancak izinleri ayarlamaz.
6. Windows servisini yeniden başlatın, uygulama havuzunu geri dönüştürün (recycle) ve siteyi yeniden yükleyin.

Hata mesajında servis hesabınız geçiyorsa (örneğin Login failed for user 'DOMAIN\mindzieService'), kimlik değişikliği başarılı olmuştur, ancak o hesabın mindzie veritabanı üzerinde db_owner yetkisi yoktur. Bunu Adım 1’de anlatıldığı gibi SQL Server’da düzeltin.

Yapılandırma Sonrasında Servis Başlamıyor

mindzieStudioService StartPending durumunda kalıyor veya hemen tekrar duruyorsa, bunun nedeni neredeyse her zaman servis hesabının veritabanına erişememesidir. Yukarıdaki adımları uygulayın ve unutmayın: veritabanı penceresindeki başarılı bir Check yalnızca SQL Server’a bağlantıyı doğrular; mindzie veritabanına erişimi ya da servis hesabı üzerinden erişimi doğrulamaz.

---

Destek

Kurulumunuzda yardıma mı ihtiyacınız var? Bizimle iletişime geçin:

E-posta: support@mindzie.com

Destek ekibimiz kurulum ve yapılandırma ile ilgili her türlü sorunuzda yardımcı olmaya hazırdır.

---

Teknik özellikler ve gereksinimler için Teknik Gereksinimler sayfasına bakınız.