Command Line Console (CLC)'yi Kullanma

Command Line Console (CLC), yöneticilerin çözüm tanımları (SPD'ler) ve kurulum paketleri (KP'ler)'de belirli GAX fonksiyonlarını yürütmelerine olanak tanır. Örnek olarak CLC'yi, uzak ana makinelere sessizce SPD'leri dağıtmak için kullanabilirsiniz.

CLC'yi kullanmak için, işletim sisteminin komut satırı arayüzüne erişebilmeniz gerekmektedir. Eğer GAX ana bilgisayar makinesinde değilseniz, yerel makinede CLC (gaxclc.jar) aracı bulunmalıdır.

CLC ekli Yardım dosyasına erişmek için, şu komutlardan birini yürütün:

java –jar gaxclc.jar help

java –jar gaxclc.jar ?

Important

CLC ile komutlar yürüttüğünüzde, aracın yürütüldüğü aynı konumda bir log dosyası oluşturulur.

Yapı

CLC, şu yapıları kullanan komutları destekler:

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> <function> <operation> <args>

Yukarıda bulunan örnekte:

• -u:user Yapılandırma Sunucusu'nda oturum açmak için kullanıcı adı.
• -p:password Yapılandırma Sunucusu'nda oturum açmak için kullanıcı parola. Eğer bu bayrak herhangi bir değeri belirtmiyorsa, CLC bir parola olmadığını varsayar.
• -s GAX sunucusuna güvenli bir https bağlantısı kullanma talimatı verir. Eğer bu bayrak belirlenmediyse, CLC http kullanır.
• -h:<host>:<port> GAX sunucusunun ana bilgisayar ve bağlantı noktasını belirler. Eğer bu bayrak belirlenmediyse, CLC şu değeri kullanır: -h:localhost:8080.
• <function>, ip veya spd olabilir.
• <operation> bu işlemin yürütüleceğini belirtir. Bu bayrak için geçerli değerler, bir önceki adımda belirlediğiniz fonksiyona özgüdür (ip veya spd).
• <args> işlem bağımsız değişkenleri belirtir. Bu bayrak için geçerli değerler, bir önceki adımda belirlediğiniz <function> ve <operation> parametreleridir.

Aşağıdaki bir CLC komut örneğidir:

java -jar gaxclc.jar -u:default -p:password -h:localhost:8080 spd execute 10054 1 "C:/GAX/input.txt"

SPD’ler

CLC, SPD'ler için şu işlemleri destekler:

• add
• query
• querybyid
• execute
• delete
• şifrele (bkz. yürüt sekmesi)

add

Genel Bakış

Bu işlem, GAX veritabanına bir SPD ekler. Eğer SPD zaten mevcutsa, SPD,XML'de ad ve sürüm tarafından belirlendiği gibi, bu işlem varılan SPD'yi değiştirir.

Eğer başarılı bir şekilde tamamlanırsa, işlem eklenen SPD'nin ID'sini geri döndürür.

Biçim

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> spd add "file path"

• "dosya yolu"—XML dosyasının yolu.

Örnek

java -jar gaxclc.jar -u:default -p:password spd add "c:\GAX\newSpd.xml"

query

Genel Bakış

Bu işlem, tüm SPD'leri sorgular ve her SPD için şu detayları listeleyen bir tablo görüntüler:

• ID numarası
• İsim
• Sürüm
• Kiracı DBID

Aşağıda bir örnek verilmiştir:

10054 gvp 8.1.5 1
10060 genesysOne 8.1.5 1
10060 eServices 8.1.5 1

Biçim

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> spd query

Örnek

java -jar gaxclc.jar -u:default -p:password -s -h:132.45.43.45:443 spd query

querybyid

Genel Bakış

Bu işlem, bir SPD'yi kimliği ile sorgular. Eğer SPD bulunmuyorsa, işlem başarısız olur.

Başarılıysa, işlem SPD hakkında şu detayları listeleyen bir tablo görüntüler:

• Profil Kimliği
• İsim

Örneğin:

1 Install

Biçim

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> spd query SPDID

• SPDID—Sorgulanan SPD’nin Kimliği.

Örnek

java -jar gaxclc.jar -u:default -p:password -h:132.45.43.45:8080 spd query 4374

execute

Genel Bakış

Bu işlem, bir SPD'yi yürütür.

Biçim

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> spd execute SPDID profileName|-profileID:profileID|-profileName:profileName -encrypted "input file"

• SPDID—Yürütülen SPD’nin Kimliği.
• profilAdı|-profilKimliği:profilKimliği|-profilAdı:profilAdı—Yürütülecek SPD profili.

Important

Eğer herhangi bir bayrak belirlenmediyse, profileName yürütülecek SPD profili olarak varsayılır.

• -encrypted—Eğer belirlendiyse, girdi dosyasının şifrelenmiş olduğunu belirtir.

[+] Kullanımı Göster

CLC, parolalar gibi hassas verilerin bulunduğu girdi dosyaları için şifreleme desteği sağlar.

Biçim:

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> spd encrypt "input file path" "encrypted output file path"

Şifrelenen giriş dosyası "şifrelenen çıkış yolu dosyası" ile belirtilen konumda depolanır. Eğer dosya zaten bu konumda bulunuyorsa, üzerine yazılır.

Örnek:

java -jar gaxclc.jar -u:default -p:password spd -encrypted "c:\GAX\input.txt" "c:\GAX\encrypted.txt"

java -jar gaxclc.jar -u:default -p:password spd -encrypted "input.txt" "encrypted.txt"

• "giriş dosyası"—SPD parametrelerini içeren giriş dosyasını belirler. Eğer -encrypted ayarlandıysa, girdi dosyası şifrelenir.

Girdi dosyası, JSONObject biçiminde olmalı ve belirli bir profil için SPD parametreleri içermelidir. Dosya UTF-8 biçiminde kodlanmış olmalıdır.

[+] Kullanımı göster

STRING Türü

Bir dizi türü için giriş yapısı aşağıda açıklanmıştır:

{
	"Dialog name" : {
		"Input name" : "string"
	}
}

Örnek

SPD Profili

<profile name="Install">
 <dialog step="Step1">
	<input name="NAME_PARAM1" title="PERSON NAME"  default="birit" type="string" required="true">
	   <description>Please enter the person name</description>
	</input>
 </dialog>
 <dialog step="Step2">
	<input name="NAME_PARAM2" title="PERSON NAME"  default="birit" type="string" required="true">
	   <description>Please enter the person name</description>
	</input>
 </dialog>
 <execution>
	<script>
		log('string test' );
	</script>
 </execution>
</profile>

Profil Yükleme için Dosya Girme

{
	"Step1" : {
		"NAME_PARAM1" : "Kate"
	},
	"Step2" : {
		"NAME_PARAM2" : "John"
	}
}

BOOLEAN Türü

Bir boolean türü için giriş yapısı aşağıda açıklanmıştır:

{
	"Dialog name" : {
		"Input name" : true/false
	}
}

Örnek

SPD Profili

<profile name="Install">
 <dialog step="Step1">
	<input name="STATUS" title="status"  type="boolean" required="true">
	   <description>status field</description>
	</input>
 </dialog>
 <execution>
	<script>
		log('boolean test');
	</script>
 </execution>
</profile>

Profil Yükleme için Dosya Girme

{
	"Step1" : {
		"STATUS" : true
	}
}

INTEGER Türü

Bir tamsayı türü için giriş yapısı aşağıda açıklanmıştır:

{
	"Dialog name" : {
		"Input name" : <integer>
	}
}

Örnek

SPD Profili

<profile name="Install">
 <dialog step="Step1">
	<input name="NUMBER" title="number"  type="integer" required="true">
	   <description>number field</description>
	</input>
 </dialog>
 <execution>
	<script>
		log('number test');
	</script>
 </execution>
</profile>

Profil Yükleme için Dosya Girme

{
	"Step1" : {
		"NUMBER" : 132
	}
}

PASSWORD Türü

Bir parola türü için giriş yapısı aşağıda açıklanmıştır:

{
	"Dialog name" : {
		"Input name" : "password"
	}
}

Important

Şifreler gibi hassas verileri içeren giriş dosyaları SPD şifreleme işlemi ile şifrelenmelidir.

Örnek

SPD Profili

<profile name="Install">
 <dialog step="Step1">
	<input name="PASSWORD" title="password"  type="password" required="true">
	   <description>password field</description>
	</input>
 </dialog>
 <execution>
	<script>
		log('password test');
	</script>
 </execution>
</profile>

Profil Yükleme için Dosya Girme

{
	"Step1" : {
		"PASSWORD" : "xyz9846gdkjg"
	}
}

SELECTONE Türü

Bir <objectselect> etiketine sahip bir biriniSeç türü için giriş yapısı aşağıda açıklanmıştır:

{
	"Dialog name" : {
		"Input name" : {
			"objectselect" : {
				"filter" : [{
						"value" : "filter value",
						"name"  : "filter name"
					}
				]
			}
		}
	}
}

Important

CLC (AND) SPD dosyası içinde tanımlanmış filtreler ve biriniSeç girişi için giriş dosyası ile kesişir. Filtre kriteri SPD giriş dosyasında farklı olmalıdır ve filtre adları aynı filtre tanımı içinde farklılık göstermelidir.

Örnek

SPD Profili

<profile name="Install">
 <dialog step="Step1">
	<input name="APP_OBJ_SELECT_ONE" title="Application Name" hidden="false" type="selectOne" default="">
				<description>select application</description>
				<objectselect>
					<filter value="CfgApplication" name="type"/>
				</objectselect>
	</input>
 </dialog>
 <execution>
	<script>
		log('test select one' );
	</script>

 </execution>

Profil Yükleme için Dosya Girme

{
	"Step1" : {
		"APP_OBJ_SELECT_ONE" : {
			"objectselect" : {
				"filter" : [{
						"value" : "SIP_lrm26",
						"name"  : "name"
					}
				]
			}
		}
	}
}

SELECTMULTIPLE Türü

<objectselect> etiketli bir ÇokluSeçim türü için giriş yapısı aşağıda açıklanmıştır:

{
	"Dialog name" : {
		"Input name" : {
			"objectselect" : {
				"filter" : [{
						"value" : "filter value",
						"name"  : "filter name"
					}
				]
			}
		}
	}
}

Bir SPD giriş dosyası içinde tanımlanmış filtreler bir araya getirilerek birleştirilir (OR) ve sonra çokluSeçim girişi için SPD dosyası içinde tanımlanmış filtrelerle kesiştirilir (AND).

Örnek

SPD Profili

<profile name="Install">
 <dialog step="Step1">
	<input name="APP_OBJ_SELECT_MULTIPLE" title="Application Name" hidden="false" type="selectMultiple" default="">
				<description>select application</description>
				<objectselect>
					<filter value="CfgApplication" name="type"/>
				</objectselect>
	</input>
 </dialog>
 <execution>
	<script>
		log('test select multiple' );
	</script>

 </execution>

Profil Yükleme için Dosya Girme

{
	"Step1" : {
		"APP_OBJ_SELECT_MULTIPLE" : {
			"objectselect" : {
				"filter" : [{
						"value" : "SIP_lrm26",
						"name"  : "name"
					},{
						"value" : "SIP_lrm27",
						"name"  : "name"
					}
				]
			}
		}
	}
}

İşlem SIP_lrm26 ve SIP_lrm27 adlarında iki uygulama getirir.

SELECTONE Türü

<selection> etiketli BiriniSeç/ÇokluSeçim/boolean türü için giriş yapısı aşağıda açıklanmıştır:

{
	"Dialog name" : {
		"Input name" : {
			"selection" : {
				"option" : [{
						"value" : "option value assigned to the input parameter",
						"name"  : "option name is displayed in UI"
					}
				]
			}
		}
	}
}

CLC, SPD giriş dosyası içinde tanımlanmış seçenekleri seçer. Birden fazla seçenek sadece Çokluseçim giriş tipi çin seçilebilir.

Örnek

SPD Profili

<profile name="Install">
 <dialog step="Application Parameters">
	<input name="DATA_MODEL" title="Binary Version (32-bit or 64-bit)" default="64" type="selectOne" required="true">
	    <description>This parameter defines the 32-bit or the 64-bit version of the binary to be deployed.  </description>
		<selection>
		    <option name="32" value="32"/>
		    <option name="64" value="64"/>
		</selection>
	</input>
 </dialog>
 <execution>
	<script>
		log('test selection support' );
	</script>

 </execution>

Profil Yükleme için Dosya Girme

{
	"Application Parameters" : {
		"DATA_MODEL" : {
			"selection" : {
				"option" : [{
						"value" : "64",
						"name"  : "64"
					     }
				]
			}
		}
	}
}

Important

• Giriş dosyası SPD parametresi için bir değer belirtmiyorsa, giriş ögesinin varsayılan öz niteliği kullanılacaktır.
• Bir SPD giriş öğesinin gerekli öz niteliği doğru olarak ayarlanmış ancak ne SPD (varsayılan olarak) ne de giriş dosyası içinde buna karşılık gelen değer yoksa bu durumda SPD yürütme başarısız olur.
• Bir SPD giriş öğesinin salt okunur öz niteliği doğru olarak ayarlandıysa, bu durumda tanımlandıysa yürütme için varsayılan öz niteliği kullanılır. Salt okunur öz niteliği değeri doğru olarak ayarlandıysa, gerekli yanlış olarak ayarlanır ve varsayılan öz nitelik tanımlanmaz, daha sonra giriş değerini belirlemek için aşağıdaki mantık kullanılır:
  1. boolean giriş tip için giriş değeri false olarak ayarlanır.
  2. dizi ve şifre giriş tip için giriş değeri "" olarak ayarlanır.
  3. tam sayı giriş tipi için giriş yayılmaz.
• Bir iletişim kutusu koşul öz niteliği değeri yanlış olarak değerlenirse, iletişim kutusu CLC aracı tarafından atlanır. Örnek:

   <dialog step="Role input" cond="false">
    <input name="ROLE" title="Role" hidden="false" type="selectOne" required="true">
  	<description>Please indicate the role</description>
  		<objectselect>
  			<filter value="CfgRole" name="type"/>
  		</objectselect>
  	</input>
   </dialog>

  
  

Örnek

java -jar gaxclc.jar -u:default -p:password -s -h:localhost:8080 spd execute 10054 -profileID:1 "C:/GAX/input.txt"

java -jar gaxclc.jar -u:default -p:password -h:localhost:8080 spd execute 10054 -profileName:"Install profile" "C:/GAX/input.txt"

java -jar gaxclc.jar -u:default -p:password -s -h:localhost:8080 spd execute 10054 1 -encrypted "C:/GAX/encryptedinput.txt"

delete

Genel Bakış

Bu işlem, bir SPD siler. Eğer SPD bulunmuyorsa, işlem başarısız olur.

Biçim

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> spd delete SPDID

• SPDID—Silinen SPD’nin Kimliği.

Örnek

java -jar gaxclc.jar -u:default -p:password spd delete 5436

KP’ler

CLC, ip fonksiyonları için şu işlemleri destekler:

• add
• query
• querybyid
• delete

add

Genel Bakış

Bu işlem, GAX veritabanına bir IP (.zip dosyası olarak sıkıştırılmış) ekler. Eğer IP zaten bulunuyorsa, değiştirilir.

Eğer başarılı bir şekilde tamamlanırsa, işlem IP'nin ID'sini görüntüler.

Important

.zip dosyası IP için, IP ve şablonlar klasörünü içermelidir.

Biçim

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> ip add "path to IP zip file"

Örnek

java -jar gaxclc.jar -u:default -p:password ip add "C:\GAX\TESTS\zippedIpUpload\PRODUCTION\IP_TSrvSIP64_18100079b1_ENU_windows.zip"

query

Genel Bakış

Bu işlem, tüm IP'leri sorgular ve her IP için şu detayları listeleyen bir tablo görüntüler:

• ID numarası
• İsim
• Sürüm
• OS
• Yerel Ayar
• Durum

Biçim

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> ip query

Örnek

java -jar gaxclc.jar -u:default -p:password -s -h:132.45.43.45:443 ip query

querybyid

Genel Bakış

Bu işlem, ID'si ile bir IP sorgular ve şu detayları listeleyen bir tablo görüntüler:

• ID numarası
• İsim
• Sürüm
• OS
• Yerel Ayar
• Durum

Biçim

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> ip query IPID

• IPID—Sorulacak KP’nin kimliği.

Örnek

java -jar gaxclc.jar -u:default -p:password -h:132.45.43.45:8080 ip query 543

delete

Genel Bakış

Bu işlem, bir IP siler.

Biçim

java –jar gaxclc.jar -u:user -p:password -s -h:<host>:<port> ip delete IPID

• IPID—Silinecek KP’nin kimliği.

Örnek

java -jar gaxclc.jar -u:default -p:password ip delete 547

category:Genesys Administrator Extension category:Genesys Administrator Extension Help