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ıdaki ö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"

SPDs

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

• ekle
• sorgu
• querybyid
• yürüt
• sil
• şifrele (bkz. yürüt sekmesi)

ekle

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"

• "file path"—XML dosyasına yol.

Örnek

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

sorgu

Genel Bakış

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

• Kimlik numarası
• Ad
• Sürüm
• Kiracı DBID

Aşağıdaki bir örnektir:

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
• Ad

Örnek olarak:

1 Kurulum

Biçim

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

• SPDID—Sorgulanan SPD'nin ID'si.

Örnek

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

yürüt

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ülecek SPD'nin ID'si.
• profileName|-profileID:profileID|-profileName:profileName—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 girdi dosyası, "encrypted output file path" tarafından belirtilen konumda saklanı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"

• "input file"—SPD parametrelerini içeren girdi 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

The input file must be in JSONObject format and include SPD parameters for a specific profile. The file must be encoded in UTF-8 format.

The input structure for a string type is described below:

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

Example

SPD Profile

<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>

Input File for Install Profile

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

The input structure for a boolean type is described below:

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

Example

SPD Profile

<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>

Input File for Install Profile

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

The input structure for an integer type is described below:

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

Example

SPD Profile

<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>

Input File for Install Profile

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

The input structure for a password type is described below:

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

Important

Input files that include sensitive data such as passwords should be encrypted using the SPD encrypt operation.

Example

SPD Profile

<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>

Input File for Install Profile

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

The input structure for a selectOne type with an <objectselect> tag is described bellow:

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

Important

CLC intersects (AND) filters defined in the SPD file and input file for a selectOne input. The filter criteria should be different in an SPD input file and filter names should differ in the same filter definition.

Example

SPD Profile

<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>

Input File for Install Profile

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

The input structure for a selectMultiple type with <objectselect> tag is described below:

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

Filters defined in an SPD input file are joined in union (OR) and then intersect (AND) with filters defined in an SPD file for a selectMultiple input.

Example

SPD Profile

<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>

Input File for Install Profile

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

The operation returns two applications named SIP_lrm26 and SIP_lrm27.

The input structure for a selectOne/selectMultiple/boolean type with <selection> tag is described below:

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

CLC selects options defined in the SPD input file. Multiple options can be specified only for the selectMultiple input type.

Example

SPD Profile

<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>

Input File for Install Profile

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

Important

• If the input file does not specify a value for a SPD parameter, the value defined in the default attribute of the input element will be used.
• If an SPD input element has the required attribute set to true, but there is no corresponding input value that is supplied in either the SPD (as a default) or in the input file, then the SPD execution fails.
• If an SPD input element has the readonly attribute value set to true, then the value in the default attribute value is used for the execution, if defined. If the readonly attribute value is set to true, required is set to false, and the default attribute is not defined, then the following logic is used for input value determination:
  1. For the boolean input type, the input value is set to false.
  2. For the string and password input types, the input value is set to "".
  3. For the integer input type, the input is not propagated.
• If a dialog cond attribute value evaluates to false, the dialog is skipped by the CLC tool. Example:

   <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"

sil

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—Silinecek SPD'nin ID'si.

Örnek

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

IPs

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

• ekle
• sorgu
• querybyid
• sil

ekle

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"

sorgu

Genel Bakış

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

• Kimlik numarası
• Ad
• Sürüm
• İşletim Sistemi
• Yerel
• 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:

• Kimlik numarası
• Ad
• Sürüm
• İşletim Sistemi
• Yerel
• Durum

Biçim

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

• IPID—Sorgulanacak IP'nin ID'si.

Örnek

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

sil

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 IP'nin ID'si.

Örnek

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

category:Genesys Administrator Extension category:Genesys Administrator Extension Help