Manuel Kurulum¶

Manuel Kurulum, Emakin'in kapsayıcılar veya Helm aracılığıyla değil, doğrudan bir ana makineye kurulması gerektiğinde kullanılır. Bu yöntem, çalışma zamanı ortamı veya hizmet yöneticisi üzerinde yakın denetim gerektiğinde uygundur.

Ön Koşullar¶

Korunan belgelerde şu ön koşullar listelenmiştir:

DotNet Core 10.0 Microsoft'tan
Dragonfly
BaseX Server
desteklenen bir veritabanı sunucusu: PostgreSQL, Oracle veya MS SQL Server

Kurulum İş Akışı¶

1. Kurulum Paketini İndirin¶

Hedef işletim sistemine uygun paketi indirin.

2. Paketi Ayıklayın¶

Aşağıda <installdir>olarak anılacak bir kurulum dizini oluşturun ve paketi bu dizine ayıklayın.

Korunan belgelerde dizin adında boşluk ve özel karakterlerden kaçınılması önerilmektedir.

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

Gerekmedikçe <installdir>/appsettings.json dosyasını doğrudan düzenlemeyin. Bunun yerine şu dosyayı oluşturun:

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

Geçerli belgelerden korunan örnek:

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

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

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

Agent, düğüme özel özel yapılandırmayı, günlükleri ve FullText kataloğunu varsayılan olarak <installdir>/Configuration/Data altında depolar. Bu değişkeni AK_CONFIGURATION_DATA_PATH yalnızca bu verilerin başka bir konumda tutulması gerektiğinde tanımlayın:

1	`AK_CONFIGURATION_DATA_PATH=D:\EmakinData`

Agent'ı başlatmadan önce değişkeni Windows hizmet ortamında veya Linux hizmet yöneticisi ortamında yapılandırın. Hedef dizine agent'ı çalıştıran hesap erişebilmeli ve bu hesap dizine yazabilmelidir. Hizmetin değiştirilmesi veya ana makine bakımı sonrasında verilerin korunması gerekiyorsa kalıcı bir disk kullanın.

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

Korunan varsayılan değerler:

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

Bu bağlantı noktaları kullanımdaysa, ilgili ayarları şu dosyada güncelleyin: <installdir>/Configuration/appsettings.json.

Web bağlantı noktalarını değiştirmeye yönelik korunan örnek:

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

Ana makine yönetimi bağlantı noktasını değiştirmeye yönelik korunan ö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`

Korunan belgelerde ayrıca şunlar listelenir:

.\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, arka plan aracısının tüm iş yükünü başlatmadan web hizmetlerini çalıştırır.

7. Aracı Hizmetini Başlatma¶

Yapılandırma doğrulandıktan sonra:

Windows: hizmeti Windows Hizmetleri aracılığıyla başlatın
Linux: hizmeti ana makinenin dağıtımında kullanılan hizmet yöneticisi aracılığıyla başlatın