CLC(명령줄 콘솔) 사용

관리자는 CLC(Command Line Console)에서 명령줄을 사용하여 SPD(솔루션 정의) 및 IP(설치 패키지)에 대한 특정 GAX 기능을 실행할 수 있습니다. 예를 들어 CLC를 사용하여 원격 호스트에 SPD를 자동으로 배포할 수 있습니다.

CLC를 사용하려면 운영 체제의 명령줄 인터페이스에 액세스할 수 있어야 합니다. GAX 호스트 컴퓨터에 로그인하지 않은 경우 로컬 컴퓨터에서 CLC 도구(gaxclc.jar)를 사용할 수 있어야 합니다.

CLC의 내장된 도움말 파일에 액세스하려면 다음 명령 중 하나를 실행합니다.

java –jar gaxclc.jar help

java –jar gaxclc.jar ?

중요

CLC에서 명령을 실행할 때 해당 도구가 실행되는 동일 위치에 로그 파일이 생성됩니다.

구조

CLC는 다음 구조를 사용하는 명령을 지원합니다.

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

다음은 위의 예를 세부적으로 살펴봅니다.

• -u:user는 Configuration Server에 로그인하는 사용자 이름입니다.
• -p:password는 Configuration Server에 로그인할 때 사용하는 암호입니다. 이 플래그에 값을 지정하지 않은 경우 CLC 는 암호가 없는 것으로 가정합니다.
• -s를 사용하면 CLC에서 GAX 서버에 연결할 때 보안 https 연결을 사용합니다. 이 플래그를 지정하지 않으면 CLC에서 http를 사용합니다.
• -h:<host>:<port>는 GAX 서버의 호스트 및 포트를 지정합니다. 이 플래그를 지정하지 않으면 CLC에서 다음 값을 사용합니다. -h:localhost:8080.
• <function>에는 ip 또는 spd를 지정할 수 있습니다.
• <operation>은 실행할 작업을 지정합니다. 이 플래그의 유효 값은 이전 단계에서 지정한 기능(ip 또는 spd)에 따라 달라집니다.
• <args>는 작업 인수를 지정합니다. 이 플래그의 유효 값은 이전 단계에서 지정한 <function> 및 <operation> 매개변수에 따라 달라집니다.

다음은 CLC 명령의 예입니다.

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

SPD

CLC에서는 SPD에 대해 다음 작업을 지원합니다.

• add
• query
• querybyid
• execute
• delete
• encrypt(execute 탭 참조)

add

개요

이 작업은 GAX 데이터베이스에 SPD를 추가합니다. SPD가 이미 있는 경우 이 작업은 SPD XML의 이름 및 버전에 따라 기존 SPD를 대체합니다.

이 작업이 제대로 실행된 경우 추가된 SPD의 ID가 반환됩니다.

형식

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

• "file path"— - XML 파일의 경로입니다.

예

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

query

개요

이 작업은 모든 SPD를 쿼리하고 각 SPD의 다음 요소를 나열하는 테이블을 표시합니다.

• ID 번호
• 이름
• 버전
• 테넌트 DBID

예는 다음과 같습니다.

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

형식

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

예

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

querybyid

개요

이 작업은 해당 ID로 SPD를 쿼리합니다. SPD가 존재하지 않은 경우 작업이 실패합니다.

이 작업이 제대로 실행된 경우 SPD에 관한 다음 세부사항을 나열하는 테이블이 표시됩니다.

• 프로필 ID
• 이름

예:

1 Install

형식

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

• SPDID— - 쿼리되는 SPD의 ID입니다.

예

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

execute

개요

이 작업은 SPD를 실행합니다.

형식

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

• SPDID— - 실행될 SPD의 ID입니다.
• profileName|-profileID:profileID|-profileName:profileName—실행될 SPD 프로파일입니다.

중요

지정한 플래그가 없는 경우 profileName을 실행할 SPD 프로파일인 것으로 가정합니다.

• -encrypted— - 지정한 경우 입력 파일이 암호화되는지를 나타냅니다.

[+] 사용 표시

CLC에서는 암호와 같은 중요한 데이터가 포함된 입력 파일에 대해 암호화를 지원합니다.

형식:

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

암호화된 입력 파일은 "encrypted output file path"에서 지정한 위치에 저장됩니다. 이 위치에 파일이 이미 있는 경우 그 파일을 덮어씁니다.

예:

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 매개변수가 포함된 입력 파일을 지정합니다. -encrypted를 설정한 경우 입력 파일이 암호화됩니다.

입력 파일은 JSONObject 형식이어야 하며 특정 프로필의 SPD 매개변수를 포함해야 합니다. 파일은 UTF-8 형식으로 인코딩되어야 합니다.

[+] 사용 표시

STRING 형식

문자열 형식의 입력 구조는 아래에 설명되어 있습니다.

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

예

SPD 프로필

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

설치 프로필의 입력 파일

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

BOOLEAN 형식

부울 형식의 입력 구조는 아래에 설명되어 있습니다.

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

예

SPD 프로필

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

설치 프로필의 입력 파일

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

INTEGER 형식

정수 형식의 입력 구조는 아래에 설명되어 있습니다.

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

예

SPD 프로필

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

설치 프로필의 입력 파일

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

PASSWORD 형식

암호 형식의 입력 구조는 아래에 설명되어 있습니다.

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

중요

중요한 데이터(예: 암호)를 포함하는 입력 파일은 SPD 암호화 작업을 사용하여 암호화해야 합니다.

예

SPD 프로필

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

설치 프로필의 입력 파일

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

SELECTONE 형식

<objectselect> 태그가 있는 selectOne 형식의 입력 구조는 아래에 설명되어 있습니다.

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

중요

CLC는 selectOne 입력의 입력 파일 및 SPD 파일에 정의된 필터를 교차합니다(AND). 필터 기준은 SPD 입력 파일에서 달라야 하며 파일 이름은 동일한 필터 정의에서 달라야 합니다.

예

SPD 프로필

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

설치 프로필의 입력 파일

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

SELECTMULTIPLE 형식

<objectselect> 태그가 있는 selectMultiple 형식의 입력 구조는 아래에 설명되어 있습니다.

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

SPD 입력 파일에 정의된 필터는 공용(OR)으로 결합된 후 selectMultiple 입력의 SPD 파일에 정의된 필터와 교차합니다(AND).

예

SPD 프로필

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

설치 프로필의 입력 파일

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

이 작업은 SIP_lrm26 및 SIP_lrm27라는 두 가지 어플리케이션을 반환합니다.

SELECTONE 형식

<selection> 태그가 있는 selectOne/selectMultiple/boolean 형식의 입력 구조는 아래에 설명되어 있습니다.

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

CLC는 SPD 입력 파일에 정의된 옵션을 선택합니다. selectMultiple 입력 형식에 대해서만 여러 옵션을 지정할 수 있습니다.

예

SPD 프로필

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

설치 프로필의 입력 파일

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

중요

• 입력 파일이 SPD 매개변수의 값을 지정하지 않은 경우 입력 요소의 default 특성에 정의된 값이 사용됩니다.
• SPD 입력 요소의 required 특성이 true로 설정되었지만 SPD(기본값) 또는 입력 파일에 제공된 입력값이 없는 경우 SPD 실행이 실패합니다.
• SPD 입력 요소의 readonly 특성값이 true로 설정된 경우 default 특성값(정의된 경우)이 실행에 사용됩니다. readonly 특성이 true로 설정되고, required가 false로 설정되고 default 특성이 정의되지 않은 경우 다음 논리가 입력값 결정에 사용됩니다.
  1. boolean 입력 형식의 경우 입력값은 false로 설정됩니다.
  2. string 및 password 입력 형식의 경우 입력값은 ""로 설정됩니다.
  3. integer 입력 형식의 경우 입력은 전파되지 않습니다.
• 대화 상자 cond 특성값이 false로 평가되면 이 대화 상자는 CLC 도구를 통해 건너뜁니다. 예:

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

  
  

예

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

개요

이 작업은 SPD를 삭제합니다. SPD가 존재하지 않은 경우 작업이 실패합니다.

형식

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

• SPDID— - 삭제될 SPD의 ID입니다.

예

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

IP

CLC에서는 ip에 대해 다음 작업을 지원합니다.

• add
• query
• querybyid
• delete

add

개요

이 작업은 GAX 데이터베이스에 IP(.zip 파일로 패키지됨)를 추가합니다. IP가 이미 있다면 해당 IP를 대체합니다.

이 작업이 제대로 실행된 경우 IP의 ID가 표시됩니다.

중요

.zip 파일에는 IP 및 IP의 템플릿 폴더가 포함되어 있어야 합니다.

형식

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

예

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

query

개요

이 작업은 모든 IP를 쿼리하고 각 IP의 다음 세부사항을 나열하는 테이블을 표시합니다.

• ID 번호
• 이름
• 버전
• OS
• 로캘
• 상태

형식

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

예

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

querybyid

개요

이 작업은 해당 ID별로 IP를 쿼리하고 다음 세부사항을 나열하는 테이블을 표시합니다.

• ID 번호
• 이름
• 버전
• OS
• 로캘
• 상태

형식

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

• IPID— - 쿼리할 IP의 ID입니다.

예

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

delete

개요

이 작업은 IP를 삭제합니다.

형식

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

• IPID— - 삭제할 IP의 ID입니다.

예

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

category:Genesys Administrator Extension category:Genesys Administrator Extension Help