El ile Kurulum¶

Emakin'in konteynerler veya Helm aracılığıyla değil doğrudan bir ana bilgisayara kurulması gerektiğinde el ile kurulum kullanılır. Bu yöntem, çalışma zamanı ortamı veya hizmet yöneticisi üzerinde ayrıntılı denetim gerektiren durumlar için uygundur.

Ön Koşullar¶

Korunan belgelerde şu ön koşullar listelenir:

DotNet Core 10.0 Microsoft tarafından sağlanan
Dragonfly
BaseX Server
desteklenen veritabanı sunucusu: PostgreSQL, Oracle veya MS SQL Server

Kurulum İş Akışı¶

1. Kurulum Paketini İndirin¶

Hedef işletim sistemi için paketi indirin.

2. Paketi Çıkarma¶

Bir yükleme dizini oluşturun; aşağıda bu dizin <installdir>olarak anılacaktır ve paketi bu dizine çıkarın.

Mevcut belgeler, dizin adında boşluk ve özel karakter kullanmaktan kaçınılmasını önerir.

3. Veritabanı Bağlantısını Yapılandırma¶

Gerekmedikçe <installdir>/appsettings.json doğrudan düzenlemeyin. Bunun yerine şunu oluşturun:

1	`<installdir>/Configuration/appsettings.json`

Mevcut belgelerdeki örnek:

{
    "DbConnStr": "Host=sqlserver;Database=EMAKIN;Username=emakin;Password=emakin;",
    "ProxyUri": ""
}

Daha kapsamlı yapılandırma davranışı için Düğüm Yapılandırması.

İsteğe Bağlı Özel Veri Yolu¶

Aracı, düğüme özgü özel yapılandırmayı, günlükleri ve FullText kataloğunu varsayılan olarak <installdir>/Configuration/Data altında depolar. AK_CONFIGURATION_DATA_PATH Bu verilerin başka bir konumda tutulması gerekiyorsa tanımlayın:

1	`AK_CONFIGURATION_DATA_PATH=D:\EmakinData`

Aracı başlatmadan önce değişkeni Windows hizmet ortamında veya Linux hizmet yöneticisi ortamında yapılandırın. Hedef dizine, aracı çalıştıran hesap tarafından önceden erişilebilmeli ve bu hesaba yazma izni verilmelidir. Verilerin hizmet değişiminden veya ana makine bakımından sonra da korunması gerekiyorsa kalıcı bir disk kullanın.

4. Bağlantı Noktalarının Kullanılabilirliğini Doğrulama¶

Mevcut belgelerdeki varsayılan değerler:

80 ve 443 web erişimi için
7180 sistem yönetimi için

Bu bağlantı noktaları kullanımdaysa, ilgili ayarları <installdir>/Configuration/appsettings.json.

Web bağlantı noktalarını değiştirmeye ilişkin mevcut örnek:

{
  "Web": {
    "Kestrel": {
      "Endpoints": {
        "Http": {
          "Url": "http://*:8080"
        },
        "Https": {
          "Url": "https://*:8443"
        }
      }
    }
  }
}

Ana makine yönetimi bağlantı noktasını değiştirmeye ilişkin mevcut örnek:

{
  "HostAdmin": {
    "Kestrel": {
      "Endpoints": {
        "Http": {
          "Url": "http://*:7181"
        }
      }
    }
  }
}

5. Windows'ta Hizmetleri Yükleme¶

Windows'ta ana aracı hizmetini yüklemek için:

1	`.\AltiKare.Workflow.Agent.exe install`

Mevcut belgelerde ayrıca şu komutlar listeleniyor:

.\AltiKare.Workflow.Agent.exe basex
.\AltiKare.Workflow.Agent.exe redis

gerektiğinde ilgili hizmetleri yüklemek için.

6. Konsol Modunda Test Etme¶

Tüm hizmet yığınını çalıştırmadan önce web sunucusunu konsol modunda test edin:

1	`.\AltiKare.Workflow.Agent.exe web`

Bu işlem, tüm arka plan aracısı iş yükü olmadan web hizmetlerini başlatır.

7. Aracı Hizmetini Başlatma¶

Yapılandırmayı doğruladıktan sonra:

Windows: hizmeti Windows Hizmetleri üzerinden başlatın
Linux: hizmeti, ana makinenin dağıtımında kullanılan hizmet yöneticisi üzerinden başlatın