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 agent komut satırı arayüzünü kullanın. Varsayılan olarak agent genellikle Windows hizmeti veya daemon 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 özellikle şu işler için kullanışlıdır:

ilk yükleme ve hizmet kaydı
korumalı yapılandırma güncellemeleri
web, agent, SMTP veya tam metin modüllerini hedefleyerek başlatma
bakım ve tanılama

Not: Bazı komutlar işletim sistemine özeldir 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 destekleniyorsa 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 ayarlar.

.\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 belirlenir ve isteğe bağlı ortam değişkeniyle değiştirilebilir: AK_CONFIGURATION_DATA_PATH ortam değişkeni:

<configuration-data-path>/protectedsettings.json

Warning

Şifrelenmiş yapılandırma ayarları yazılabilir ancak okunamaz. Bu dosya kaybolursa içindeki saklanan değerler 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ımlı değilse bu yol <installdir>/Configuration/Data.

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

şu kaynaktaki herhangi bir yapılandırma değeri <installdir>/appsettings.json şununla ayarlanabilir: setconfigve alt bölümlere şu ayırıcıyla : başvurulabilir.

.\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ı şu önekle başlamalıdır: PS_ önek.

.\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 olarak 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 hizmetini, Sistem Yönetimi'ni, çalışanı 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 hizmetini, Sistem Yönetimi'ni, çalışanı veya Market hizmetini başlatmaz.

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

Push, yapılandırılmış uç noktalarında dinleme yapar; bunlar genellikle HTTP/HTTPS uç noktalarıdır; normalde 5110 ve 5111. Lisans oluşturma için ayrıca yapılandırılmış ProductCertificate PFX 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 aksiyonları geri alınamaz. Dikkatli kullanın.

Temizleme aksiyonu şu 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ı en iyi duruma getirir.
Uygulamanın tam metin veritabanını en iyi duruma getirir.
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ış öğelerden birini belirtir FileRepositories .

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

1	`FullPath,Size,DestinationFullPath`

FullPath tam depolama yolunu içerir, Size dosya boyutunu içerir ve DestinationFullPath boş bırakılır; böylece dosya daha sonra şu komutla yeniden kullanılabilir: fsmove.

Eğer path atlanırsa komut depoyu kök yoldan listeler. recursive isteğe bağlıdır ve varsayılan değeri falseolur. Şu değerler gibi true, yesve 1 ö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çili 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 komutla oluşturulan bir 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 hata ile tamamlanı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ı en iyi duruma getirmek 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 yol açabilir.

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ı yapar 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 yapı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 yapı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 sürecini başlatır.

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

Sıfırlama işlemini isteğe bağlı olarak belirli bir alanadı and/or ve 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ı için 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 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 kabul edilir: 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

Belirtildiğinde types yalnızca seçilen tam metin koleksiyonları temizlenir ve yeniden oluşturulur. Diğer dizin türlerine dokunulmaz.

Bu işlem veritabanı içeriğini boşalttığından, dizin oluşturma tamamlanana kadar kullanıcılar arayüzde boş listeler görebilir. Bu nedenle yoğun kullanım saatlerinde yapılması ö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ı şu işaretlerle ayrılabilir: , 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 SSL bağlantı testi gerçekleştirir.

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

Bu komut, belirtilen ana bilgisayara SSL bağlantısını kontrol eder 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¶