Komut Satırı Arayüzü¶

Hizmetleri yüklemeniz, korumalı yapılandırma değerlerini ayarlamanız, seçili modülleri el ile başlatmanız veya tanılama ve bakım komutlarını çalıştırmanız gerektiğinde Emakin aracısının komut satırı arayüzünü kullanın. Aracı genellikle varsayılan olarak bir Windows hizmeti veya arka plan programı olarak çalışacak şekilde yapılandırılır; ancak CLI modunda da başlatılabilir.

CLI Modu Ne Zaman Kullanılır¶

CLI modu başlıca şu işler için kullanışlıdır:

ilk kurulum ve hizmet kaydı
korumalı yapılandırma güncellemeleri
web, aracı, SMTP veya tam metin modüllerini hedefli başlatma
bakım ve tanılama

Not: Bazı komutlar işletim sistemine özgüdür ve her dağıtım hedefinde kullanılamayabilir.

Komut Grupları¶

Komutlar
- help
Yükleme Komutları
- install
- uninstall
- basex
- ubasex
- redis
- uredis
Yapılandırma Komutları
- setconfig
- registerstore
Agent Komutları
- start
- web
- agent
- smtp
- fulltext
- market
- push
Bakım Komutları
- cleanup
- fslist
- fsmove
- fulltextmerge
- fulltextlist
- fulltextdump
- fulltextreset
- fulltextindex
- ssltest

Komutlar¶

help¶

Kullanılabilir komutların listesini yazdırır. Bazı seçenekler işletim sistemine bağlıdır ve yalnızca desteklendiklerinde gösterilir.

.\AltiKare.Workflow.Agent.exe help

Usage:
help           Show help                                          help
 install        install as service                                 install
 uninstall      uninstall service                                  uninstall
 basex          install basex service                              basex
 ubasex         uninstall basex service                            ubasex
 redis          install redis service                              redis
 uredis         uninstall redis service                            uredis
 setconfig      Sets a configuration value in protected.json       setconfig <key> <value>
 start          start all services                                 start
 web            start web services                                 web
 agent          start agent                                        agent
 smtp           start smtp                                         smtp
 fulltext       start fulltext                                     fulltext
 market         start market service                               market
 push           start push service                                 push
 registerstore  register data store                                registerstore <applicationName> <storeName> [processPath]
 cleanup        execute maintenance cleanup                        cleanup
 fslist         list file service paths to csv                     fslist <applicationName> <repositoryName> <csvPath> [path] [recursive]
 fsmove         move file service paths from csv                   fsmove <applicationName> <repositoryName> <csvPath>
 fulltextmerge  execute full text merge [collection]               fulltextmerge
 fulltextlist   list all full text collections                     fulltextlist
 fulltextdump   execute full text search and dump results          fulltextdump  <query> [collection] [local]
 fulltextreset  Reset the full text index                          fulltextreset [domainId] [types]
 fulltextindex  Re-index given items                               fulltextindex items
 ssltest        execute ssl connection test                        ssltest  hostname [port]

Yükleme Komutları¶

install¶

Agent'ı Windows hizmeti olarak yükler. Yalnızca Windows'ta kullanılabilir.

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

uninstall¶

Windows hizmetini kaldırır. Yalnızca Windows'ta kullanılabilir.

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

basex¶

BaseX hizmetini Windows hizmeti olarak yükler. Yalnızca Windows'ta kullanılabilir.

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

ubasex¶

BaseX Windows hizmetini kaldırır. Yalnızca Windows'ta kullanılabilir.

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

redis¶

Redis'i Windows hizmeti olarak yükler. Yalnızca Windows'ta kullanılabilir.

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

uredis¶

Redis Windows hizmetini kaldırır. Yalnızca Windows'ta kullanılabilir.

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

Yapılandırma Komutları¶

setconfig¶

Bir yapılandırma ayarını şifrelenmiş biçimde belirler.

.\AltiKare.Workflow.Agent.exe setconfig <key> <value>

Varsayılan olarak yapılandırma parametreleri düz metin JSON dosyalarında saklanır; ancak veritabanı bağlantı dizeleri gibi hassas ayarlar şifrelenebilir. Şifrelenmiş ayarlar aşağıdaki yolda saklanır ve önceki yapılandırma katmanlarını geçersiz kılar. <configuration-data-path> varsayılan olarak Configuration/Data ve isteğe bağlı AK_CONFIGURATION_DATA_PATH ortam değişkeniyle değiştirilebilir:

<configuration-data-path>/protectedsettings.json

Warning

Şifrelenmiş yapılandırma ayarları yazılabilir ancak tekrar okunamaz. Bu dosya kaybolursa, saklanan değerler dosyadan kurtarılamaz.

Örneğin, veritabanı bağlantı dizesi şu komutla ayarlanabilir:

.\AltiKare.Workflow.Agent.exe setconfig DbConnStr 'Host=myserver;Database=emakin;Username=emakin;Password=mypassword;'

Bu komut çalıştırıldıktan sonra yeni bir protectedsettings.json dosya etkin yapılandırma veri yolunda oluşturulur ve şifrelenmiş bağlantı dizesini saklar. Eğer AK_CONFIGURATION_DATA_PATH tanımlanmamışsa, bu yol <installdir>/Configuration/Data.

{
  "DbConnStr": "CfDJ8L..........6PT0Kw="
}

Şu kaynaktaki herhangi bir yapılandırma değeri <installdir>/appsettings.json şununla ayarlanabilir: setconfig; alt bölümlere ise : ayırıcı kullanılarak erişilebilir.

.\AltiKare.Workflow.Agent.exe setconfig Section:SubSection:Key Value

registerstore¶

Tüm kiracılar arasında paylaşılacak yeni bir veri deposu kaydeder.

.\AltiKare.Workflow.Agent.exe registerstore <applicationName> <storeName> [processPath]

applicationName ana bilgisayar uygulamasını belirtir ve storeName yeni depo adını belirtir. Paylaşılan veri deposu adı PS_ önekini içermelidir.

.\AltiKare.Workflow.Agent.exe registerstore myemakin.com PS_MyStore

Bir süreç tanımı yolu da sağlarsanız, o süreçte tanımlanan tüm tablolar yeni depoda oluşturulur. Yol belirtilmezse boş bir veri deposu oluşturulur.

.\AltiKare.Workflow.Agent.exe registerstore myemakin.com PS_MyStore c:/files/sampleprocess.xml

Agent Komutları¶

start¶

Tüm modüller etkin durumdayken agent'ı konsol modunda başlatır.

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

web¶

Yalnızca web sunucusu bileşenlerini başlatır. Arka plan işleri veya SMTP gibi diğer hizmetler başlatılmaz.

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

agent¶

Yalnızca agent bileşenlerini başlatır. Web sunucusu ve SMTP hizmetleri başlatılmaz.

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

smtp¶

Yalnızca SMTP hizmeti modunu başlatır.

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

fulltext¶

Yalnızca tam metin hizmeti modunu başlatır.

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

market¶

Yalnızca Market web hizmetini başlatır. Bu açık komut, şu durumda bile Market'i başlatır: Market:Enabled ise false; bu komut uygulama web'ini, Host Administration'ı, worker'ı veya Push hizmetini başlatmaz.

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

push¶

Yalnızca Push web hizmetini başlatır. Bu açık komut, şu durumda bile Push'ı başlatır: Push:Enabled ise false; bu komut uygulama web'ini, Host Administration'ı, worker'ı veya Market hizmetini başlatmaz.

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

Push, yapılandırılmış HTTP/HTTPS uç noktalarını, genellikle 5110 ve 5111üzerinden dinler. Lisans oluşturmak için ayrıca yapılandırılmış ProductCertificate PFX dosyası ve parolası gerekir.

Bakım Komutları¶

cleanup¶

Temizleme görevlerini yürütür.

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

Warning

Bu komut yıkıcıdır ve temizleme işlemleri geri alınamaz. Dikkatli kullanın.

Temizleme işlemi aşağıdaki görevleri gerçekleştirir:

Alanadı üyelik tablolarındaki sahipsiz kayıtları siler:
sahipsiz grup üyeleri
sahipsiz organizasyon birimi pozisyonları
sahipsiz organizasyon birimi pozisyon üyeleri
sahipsiz kullanıcı oturum açma kayıtları
Tüm kiracıların tam metin veritabanlarını iyileştirir.
Uygulamanın tam metin veritabanını iyileştirir.
Sahipsiz XML veritabanlarını yedekler ve veritabanından kaldırır.
Sahipsiz form verilerini siler.

fslist¶

Yapılandırılmış bir dosya deposundaki dosya yollarını CSV dosyasına aktarır.

.\AltiKare.Workflow.Agent.exe fslist <applicationName> <repositoryName> <csvPath> [path] [recursive]

applicationName ana bilgisayar uygulamasını belirtir ve repositoryName bu uygulama için yapılandırılmış FileRepositories öğelerden birini belirtir.

Dışa aktarılan CSV dosyası her zaman aşağıdaki başlığı içerir:

1	`FullPath,Size,DestinationFullPath`

FullPath tam depolama yolunu içerir, Size dosya boyutunu içerir ve DestinationFullPath dosyanın daha sonra şu komutla yeniden kullanılabilmesi için boş bırakılır fsmove.

Eğer path belirtilmezse, komut depoyu kök yoldan itibaren listeler. recursive isteğe bağlıdır ve varsayılan değeri falseolur. Örneğin true, yesve 1 gibi değerler özyinelemeli listelemeyi etkinleştirir.

.\AltiKare.Workflow.Agent.exe fslist myemakin.com Repo1 repo-files.csv

.\AltiKare.Workflow.Agent.exe fslist myemakin.com Repo1 published-files.csv published/ true

Note

Bu komut, seçilen dosya deposu sağlayıcısının yol tabanlı listelemeyi desteklemesine bağlıdır. Bu özelliği uygulamayan sağlayıcılar desteklenmiyor hatası döndürür.

fsmove¶

CSV dosyasını okuyarak yapılandırılmış bir dosya deposundaki dosya yollarını taşır.

.\AltiKare.Workflow.Agent.exe fsmove <applicationName> <repositoryName> <csvPath>

Komutu çalıştırmadan önce, şu komutun oluşturduğu CSV dosyasındaki DestinationFullPath sütununu doldurun: fslist.

FullPath,Size,DestinationFullPath
published/a/file1.pdf,1024,archive/a/file1.pdf
published/a/file2.pdf,2048,archive/a/file2.pdf

Kaynak ve hedef yolları aynı olan satırlar atlanır. Bir veya daha fazla satır başarısız olursa, kalan satırlar işlenmeye devam eder ve özet yazdırıldıktan sonra komut hatayla sonlanır.

.\AltiKare.Workflow.Agent.exe fsmove myemakin.com Repo1 published-files.csv

Warning

Bu komut yıkıcıdır. Taşıma başarılı olduktan sonra özgün kaynak yolu depodan silinir.

fulltextmerge¶

Veritabanını iyileştirmek için etkin tam metin hizmetinde tam metin birleştirme işlemini yürütür.

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

Bu komut, kayıt sayısına bağlı olarak uzun sürebilir ve canlı kullanım sırasında performans düşüşüne neden olabilir.

fulltextlist¶

Şu anda tanımlı tam metin katalog veritabanı adlarını listeler.

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

Veritabanı adları düz metin olarak listelenir.

.\AltiKare.Workflow.Agent.exe fulltextlist

emakin.com-c75ca4bd244e43b4a0342a69fad19be2
mydomain-41aedbcf01a445178a2e4c669d432652

fulltextdump¶

Tam metin araması yürütür ve tanılama amacıyla sonucu konsola döker.

.\AltiKare.Workflow.Agent.exe fulltextdump <query> [domain]

Bu komut, tam metin veritabanı kayıtlarını incelemek için kullanılır ve eşleşen her kaydı belge olarak yazdırır.

Alanadı adı parametresi isteğe bağlıdır. Belirtilmezse arama uygulama veritabanında yürütülür.

.\AltiKare.Workflow.Agent.exe fulltextdump "123***789"

Found document (7951).
_assignedtoid(I)(S)(S)="NULL"
_channelid(I)(S)(S)="c5f3e959-0098-40c3-b52f-86cc4efb34cc"
_content(I)(S)(S)="<longtext>"
.....
number(I)(S)(S)="000000000000000026186"
priority(I)(S)(S)="000000000000000000002"
subject(I)(S)(S)="<longtext>"
totaltimespent(I)(S)(S)="-00000000000000000000"
updatedat(I)(S)(S)="202210040637"

Alanadı adı parametresi belirtildiğinde arama alanadı veritabanında yürütülür.

.\AltiKare.Workflow.Agent.exe fulltextdump "123***789" myDomain

Found document (7951).
_assignedtoid(I)(S)(S)="NULL"
.....
subject(I)(S)(S)="<longtext>"
totaltimespent(I)(S)(S)="-00000000000000000000"
updatedat(I)(S)(S)="202210040637"

fulltextreset¶

Tam metin dizinini sıfırlar ve yeniden dizin oluşturma işlemini başlatır.

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

İsteğe bağlı olarak sıfırlamayı belirli bir alanadıyla and/or belirli dizin türleriyle sınırlayabilirsiniz.

.\AltiKare.Workflow.Agent.exe fulltextreset [domainId] [types]

domainId isteğe bağlıdır. Belirtilmezse sıfırlama tüm alanadlarına uygulanır.
types isteğe bağlıdır. Belirtilmezse desteklenen tüm türler sıfırlanır.
Desteklenen types değerler instance, case, documentve şunlardır: channel.
Birden fazla tür, virgülle veya noktalı virgülle ayrılmış bir liste olarak belirtilebilir; örneğin case,document.
channel şunun takma adı olarak değerlendirilir: case.

Örnekler:

.\AltiKare.Workflow.Agent.exe fulltextreset 3f7d7642-9db5-4e48-a78f-f7774c70b5b3
.\AltiKare.Workflow.Agent.exe fulltextreset case,document
.\AltiKare.Workflow.Agent.exe fulltextreset 3f7d7642-9db5-4e48-a78f-f7774c70b5b3 instance

Şu types sağlandığında yalnızca seçilen tam metin koleksiyonları temizlenip yeniden oluşturulur. Diğer dizin türlerine dokunulmaz.

Bu işlem veritabanının içeriğini boşalttığı için, dizin oluşturma tamamlanana kadar kullanıcılar arayüzde boş listeler görebilir. Bu nedenle yoğun kullanım saatlerinde önerilmez.

fulltextindex¶

Tam metin kataloğundaki bir veya daha fazla öğeyi yeniden dizinler.

.\AltiKare.Workflow.Agent.exe fulltextindex <item1>;<item2>

Bu işlem birden fazla kayıt içerebilir. Kayıt numaraları , veya ;.

.\AltiKare.Workflow.Agent.exe fulltextindex 91212902-c218-4d99-9b41-c736a3fc362c

.\AltiKare.Workflow.Agent.exe fulltextindex 91212902-c218-4d99-9b41-c736a3fc362c;b0ea5b37-958c-4b2c-a178-932751794672

ssltest¶

Hedef ana bilgisayara yönelik bir SSL bağlantı testi gerçekleştirir.

.\AltiKare.Workflow.Agent.exe ssltest <host> [port]

Bu komut, belirtilen ana bilgisayarla SSL bağlantısını denetler ve yaygın SSL/TLS protokol sürümlerinin sonuçlarını yazdırır.

Bağlantı noktası parametresi isteğe bağlıdır. Belirtilmezse bağlantı noktası 443 kullanılır.

.\AltiKare.Workflow.Agent.exe ssltest mydomain.emakin.com

Protocol:Ssl2       Success:False
System.Security.Authentication.AuthenticationException: Authentication failed, see inner exception.
 ---> Interop+AppleCrypto+SslException: illegal parameter
   at AltiKare.Workflow.Agent.Instance.SslTest(String hostname, String port)
********************************************************************************
Protocol:Ssl3       Success:False
System.Security.Authentication.AuthenticationException: Authentication failed, see inner exception.
 ---> Interop+AppleCrypto+SslException: handshake failure
   at AltiKare.Workflow.Agent.Instance.SslTest(String hostname, String port)
********************************************************************************
Protocol:Tls        Success:False
System.Security.Authentication.AuthenticationException: Authentication failed, see inner exception.
 ---> Interop+AppleCrypto+SslException: bad protocol version
   at AltiKare.Workflow.Agent.Instance.SslTest(String hostname, String port)
********************************************************************************
Protocol:Tls11      Success:False
System.Security.Authentication.AuthenticationException: Authentication failed, see inner exception.
 ---> Interop+AppleCrypto+SslException: bad protocol version
   at AltiKare.Workflow.Agent.Instance.SslTest(String hostname, String port)
********************************************************************************
Protocol:Tls12      Success:True
CipherAlgorithm:Aes128 CipherSuite:TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
********************************************************************************

Komut Satırı Arayüzü¶

CLI Modu Ne Zaman Kullanılır¶

Komut Grupları¶

Komutlar¶

help¶

Yükleme Komutları¶

install¶

uninstall¶

basex¶

ubasex¶

redis¶

uredis¶

Yapılandırma Komutları¶

setconfig¶

registerstore¶

Agent Komutları¶

start¶

web¶

agent¶

smtp¶

fulltext¶

market¶

push¶

Bakım Komutları¶

cleanup¶

fslist¶

fsmove¶

fulltextmerge¶

fulltextlist¶

fulltextdump¶

fulltextreset¶

fulltextindex¶

ssltest¶

İlgili Sayfalar¶