Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

CLI는 명령 창 모드에서 MCCS 서비스에 명령을 전달 할 수 있는 기능을 말합니다.
MCCS 가 제공하는 CLI 종류로는 로그에 임의의 로그를 추가 할 수 있는 mclog, 그룹에 명령을 내릴 수 있는 mcgroup, 리소스에 명령을 내릴 수 있는 mcres가 있습니다.
일반적으로 CLI는 스크립트(*.bat, *.cmd) 파일을 작성하여 다양한 명령을 MCCS 서비스에 전달하는 용도로 사용합니다.
CLI는 %MCCS_HOME%\bin에 존재합니다.


이 페이지의 주요 내용

클러스터 CLI 사용 (mccluster 명령)

MCCS 클러스터의 속성 값을 수정할 때 사용합니다. CLI를 사용하여 사용자가 원하는 속성 값을 수정할 수 있습니다.

MCCS 는 설치 시 최초 사용자 계정으로 id 가 'admin' 암호가 'password'인 계정을 생성합니다.
CLI 명령을 실행 시 id 와 password를 입력하지 않으면 , 위의 최초 사용자 계정의 id와 암호로 실행됩니다.
따라서 최초 사용자의 패스워드 변경 시, 필수적으로 CLI 명령에 id와 password를 옵션으로 입력해야하만 합니다.


Syntax

mccluster [-u userid -pw password] [-c clusterName] [-a attribute] attribute_value


Options

옵션설명

-h

도움말을 출력합니다.

-u 사용자 ID를 지정합니다.
-pw -u 옵션의 사용자 비밀번호를 지정합니다.

-c

명령을 실행하기 위해 접근할 클러스터를 지정합니다.

-a

수정하기 위한 속성값 이름을 지정합니다. 



Example

modify

testCluster의 클러스터 속성을 수정합니다.

mccluster -u admin -pw password -modify -c testCluster -a attribute attribute_value

list

클러스터 상태를 출력합니다.

mccluster -u admin -pw password -list


노드 CLI 사용(mcnode 명령)

노드에 관한 명령을 전달합니다. 노드에 대해 속성 조회, 속성 값 변경, 라이선스 입력, 서포트 파일 다운로드 명령을 내릴 수 있습니다.

MCCS 는 설치시 최초 사용자 계정으로 id 가 'admin' 암호가 'password'인 계정을 생성합니다.
CLI 명령을 실행시 id 와 password를 입력하지 않으면 , 위의 최초 사용자 계정의 id와 암호로 실행됩니다.
따라서 최초 사용자의 패스워드 변경시, 필수적으로 CLI 명령에 id와 password를 옵션으로 입력해야만 합니다.


Syntax

mcnode [-u userid -pw password] [-ip node_ip_address] -command [-a attribute] [-l license] [-path download_path]


Options 

옵션설명

-h

도움말을 출력합니다.

-u사용자 계정을 지정합니다. 
-pw사용자 Password를 지정합니다. 

-ip

명령을 실행하기 위해 접근할 IP를 지정합니다. 
생략 시 로컬 노드에 대해서 명령을 실행하기 위해 접근합니다.

-a

[modify] 명령일 경우 변경할 속성과 속성 값을 지정합니다.
attribute : 그룹의 속성을 지정합니다.

-path

서포트 파일 다운 받을 경로를 지정합니다. 경로 지정을 생략하면 user.home에 다운로드 됩니다.

-l지정한 노드의 입력할 라이선스 값을 지정합니다.


Example

modify

testNode-1 노드의 속성 값을 수정합니다.

mcnode -u admin -pw password -modify -n TestNode-1 -a attribute attribute_value


license

testNode-1 노드의 라이선스를 입력합니다.

mcnode -u admin -pw password -license -n TestNode-1 license_value


support

testNode-1 노드의 서포트 파일을 c:\에 다운로드 받습니다.
(-all 입력 시 노드 전체에 대하여 서포트 파일을 생성한 후 다운로드 합니다.)

mcnode -u admin -pw password -support -n TestNode-1 [ -all ] -path c:\


list

노드의 속성 리스트를 보여줍니다.
(NodeName 입력 시 입력한 해당 노드에 대한 속성 값만 출력합니다.)

mcnode -u admin -pw password -list [-n nodename]


리소스 그룹 CLI 사용(mcgroup 명령)

그룹에 관한 명령을 전달합니다. 그룹에 대해 추가, 삭제, 온라인, 오프라인, 속성 편집 등의 명령을 내릴 수 있습니다.

MCCS는 설치 시 최초 사용자 계정으로 ID는 'admin', 비밀번호는 'password'인 계정이 생성됩니다.
CLI 명령을 실행 시 ID 와 비밀번호를 입력하지 않으면, 위의 최초 사용자 계정의 ID와 비밀번호로 실행됩니다.
따라서 최초 사용자의 비밀번호 변경 시, 필수적으로 CLI 명령에 ID와 비밀번호를 옵션으로 입력해야 합니다.


Syntax

mcgroup [-u userid -pw password] [-ip node_ip_address] [-p port] -command [ group ] [-a attribute] [-r resource] [-n node]

Options

옵션설명

-h

도움말을 출력합니다.

-u사용자 ID를 지정합니다.
-pw

사용자 비밀번호를 지정합니다.

-ip

명령을 실행하기 위해 접근할 IP를 지정합니다.
생략 시 로컬 노드에 대해서 명령을 실행하기 위해 접근합니다.

-p

명령을 실행하기 위해 접근할 포트를 지정합니다.
생략 시 기본 포트로 접근하며, 핫빗 포트가 변경이 되면 명령 실행 시 포트를 지정해 주어야 합니다.

-groupcommand

그룹에 내릴 명령을 지정합니다.
(add, delete, online, offline, move, clear, flush, modify, list, lock, unlock, state, monitor)

group

작업의 대상이 되는 그룹을 지정합니다.

-a

[list] 명령일 경우 속성값을 나열할 속성을 지정합니다.
[modify] 명령일 경우 변경할 속성과 속성값을 지정합니다.
[attribute] 그룹의 속성을 지정합니다.
[attribute_value] 변경할 속성 값을 지정합니다.

-r

작업 할 리소스를 지정합니다.

-n

작업 할 노드명을 지정합니다.

-t시간주기를 지정합니다.
-dep그룹이나 리소스의 의존성을 표시합니다.


Example

add

그룹 testGroup을 생성합니다.


mcgroup -u admin -pw password -add testGroup

delete

그룹 testGroup을 삭제합니다.


mcgroup -u admin -pw password -delete testGroup

online

testNode에서 testGroup을 온라인 시킵니다.


mcgroup -u admin -pw password -online testGroup [-n testNode]

offline

testNode에서 testGroup을 오프라인 시킵니다.


mcgroup -u admin -pw password -offline testGroup [-n testNode]

move

testNode로 testGroup을 페일오버 시킵니다.


mcgroup -u admin -pw password -move testGroup [-n testNode]

clear

testNode에서 testGroup의 장애 표시를 제거합니다.


mcgroup -u admin -pw password -clear testGroup [-n testNode]

flush

testNode의 testGroup을 초기화 시킵니다.


mcgroup -u admin -pw password -flush testGroup -n testNode

modify

testNode의 testGroup 속성을 수정합니다.


mcgroup -u admin -pw password -modify test -a attribute attribute_value -n testNode

testNode의 testGroup 속성인 AutoStart를 true로 변경합니다.


mcgroup -u admin -pw password -modify testGroup -a AutoStart true -n testNode

list

그룹 상태를 출력합니다.

mcgroup -u admin -pw password -list [group [-all] | [-dep [-r resource]] | [-a attribute] [-n testNode]]

그룹의 모든 속성값을 출력합니다.


mcgroup -u admin -pw password [-ip node_ipaddress] [-p port] -list [group [ -all]]

그룹에 속한 리소스의 의존성을 보여줍니다.


mcgroup -u admin -pw password [-ip node_ipaddress] [-p port] -list [-dep [-r resource]]

그룹의 속성값을 확인합니다.


mcgroup -u admin -pw password [-ip node_ipaddress] [-p port] -list [-a attribute] [-n testNode]]

리소스 간의 의존 관계를 생성합니다.

resource1을 부모로 resource2를 자식으로 의존 관계를 생성합니다. 


mcgroup -u admin -pw password -link resource1 resource2 [onlineDependency offlineDependency]

리소스 의존 관계를 삭제합니다. 


mcgroup -u admin -pw password -unlink resource1 resource2

lock

testGroup을 임시 잠금 상태로 합니다.


mcgroup -u admin -pw password -lock testGroup

testGroup을 영구 잠금 상태로 합니다.


mcgroup -u admin -pw password -lock testGroup -p

unlock

testGroup의 잠금 상태를 해제합니다.


mcgroup -u admin -pw password -unlock testGroup

state

test Node의 testGroup 상태를 출력합니다.


mcgroup -u admin -pw password -state testGroup [-n testNode]

monitor

testGroup 상태를 interval 간격으로 모니터링 합니다.


mcgroup -u admin -pw password -monitor testGroup [-t interval(seconds)]

리소스 타입 CLI 사용(mctype 명령)

리소스 타입에 관한 명령을 전달합니다. 리소스 타입에 대해 속성 조회, 속성 값 변경 명령을 내릴 수 있습니다.

 MCCS는 설치 시 최초 사용자 계정으로 ID는 'admin' 비밀번호는 'password'인 계정이 생성됩니다.
CLI 명령을 실행 시 ID 와 비밀번호를 입력하지 않으면, 위의 최초 사용자 계정의 ID와 비밀번호로 실행됩니다.
따라서 최초 사용자의 비밀번호 변경 시, 필수적으로 CLI 명령에 ID와 비밀번호를 옵션으로 입력해야 합니다.


Syntax

mctype -u admin -pw password -t resoruceType -a attribute

Options

옵션설명

-h

도움말을 출력합니다.

-u사용자 ID를 지정합니다.
-pw-u 옵션의 사용자 비밀번호를 지정합니다.

- r

수정할 리소스 타입 이름을 지정합니다.

- a

수정할 리소스 타입의 속성 이름을 지정합니다.

- list

리소스 타입 리스트가 나열됩니다.
[ -t resourceType ] 특정 리소스 타입 지정 시 지정한 리소스 타입에 대하여 나열됩니다.


Example

modify

MirrorDisk의 MonitorInterval 속성 값을 수정합니다.


mctype -u admin -pw password -modify -t resoruceType -a attribute attribute_value

list

모든 리소스 타입에 대한 속성 값을 출력합니다.

(-t resourceType 입력 시 지정한 리소스 타입에 대한 속성 값이 출력됩니다.)


mctype -u admin -pw password -list [-t resourceType]


리소스 CLI 사용(mcres 명령)

리소스에 관한 명령을 전달 합니다. 리소스에 대해 추가, 삭제, 온라인, 오프라인, 속성 편집 등의 명령을 내릴 수 있습니다.

MCCS 는 설치시 최초 사용자 계정으로 id 가 'admin' 암호가 'password'인 계정을 생성합니다.
CLI 명령을 실행시 id 와 password를 입력하지 않으면 , 위의 최초 사용자 계정의 id와 암호로 실행됩니다.
따라서 최초 사용자의 패스워드 변경시, 필수적으로 CLI 명령에 id와 password를 옵션으로 입력해야만 합니다.


Syntax


mcres [-u userid -pw password] [-ip node_ip_address] [-p port] -command [ resource ] [ -g group ] [ -n node]
mcres [-u userid -pw password] [-ip node_ip_address] [-p port] -add [ resource ] [ -t resource_type ] [ -g group ]
mcres [-u userid -pw password] [-ip node_ip_address] [-p port] -monitor [ group_name ] [ -t interval(seconds)]
mcres [-u userid -pw password] [-ip node_ip_address] [-p port] -modify [ resource ] [-a attribute attribute_value] [ -g group ] [ -n node]

Options

옵션설명

-h

도움말을 출력합니다.

-u사용자 ID를 지정합니다.
-pw-u 옵션의 사용자 비밀번호를 지정합니다.

-ip

명령을 실행하기 위해 접근할 IP를 지정합니다. 
생략 시 로컬 노드에 대해서 명령을 실행하기 위해 접근합니다.

-p

명령을 실행하기 위해 접근할 포트를 지정합니다. 생략시 기본 포트로 접근하며, 핫빗 포트가 변경이 되면 명령실행시 포트를 지정해 주어야 합니다.

-resourcecommand

리소스에 내릴 명령을 지정합니다.

(add, delete, enable, disable, monitor, modify, link, unlink, local, Global, Online, Offline, Offlineprop, Probe, clear, list)

resource

작업할 리소스명을 입력합니다.

-a

[list] 명령일 경우 나열할 속성값을 지정합니다. [modify] 명령일 경우 변경할 속성과 속성값을 나열해 줍니다. 
attribute : 그룹의 속성을 지정합니다. attribute_value : 변경할 속성을 지정합니다.

-t

[-add] 명령일 경우 리소스 타입을 지정합니다. [-monitor] 명령일 경우 시간 주기를 지정합니다.

-g

작업할 그룹을 지정합니다.

-n

작업할 노드를 지정합니다.

 

Example

add

testGroup그룹에 복합 응용 타입으로 testResource 를 생성합니다. 


mcres -u admin -pw password -add testResource -t resourceType -g testGroup

delete

testResource 리소스를 삭제합니다. 


mcres -u admin -pw password -delete testResource

enable

testResource 리소스를 활성화시킵니다. 


mcres -u admin -pw password -enable testResource

disable

testResource 리소스를 비활성화 시킵니다. 


mcres -u admin -pw password -disable testResource

monitor

testGroup 에 속한 모든 리소스를 interval 간격으로 모니터링 합니다. 주기가 지정되지 않은 경우에는 3초가 기본값으로 지정됩니다. 


mcres -u admin -pw password -monitor [testGroup] [-t interval(seconds)]

testGroup을 10초 간격으로 모니터링 합니다. 


mcres -u admin -pw password -monitor testGroup -t 10

modify

testResource 리소스의 attribute를 value 값으로 수정합니다. 


mcres -u admin -pw password -modify testResource -a attribute attribute_value [ -n node ]

testGroup의 testResource 리소스의 User속성 값을 administrator로 수정합니다. 


mcres -u admin -pw password -modify testResource -a User administrator -n testGroup

local

testResource 속성 값을 모든 노드들의 속성값에 대하여 서로 다른 값을 입력할 수 있도록 지역화 합니다.

(실제 속성 값 수정은 modify 명령을 통해 수정해 주어야 합니다.)  


mcres -u admin -pw password -local -r testResource -a attribute

global

testResource 의 속성을 모든 노드들의 속성값에 대하여 공통된 값을 입력할 수 있도록 공용화 합니다. 


mcres -u admin -pw password -global -r testResource -a attribute [value]

testResource 의 속성 User를 전체 속성으로 값을 administrator로 설정합니다. 


mcres -u admin -pw password -global -r testResource -a User administrator

 

online 

testNode에 있는 testResource 리소스를 온라인 시킵니다.


mcres -u admin -pw password -online testResource -n testNode

offline

testNode의 testResource 리소스를 오프라인 시킵니다. 


mcres -u admin -pw password -offline testResource -n testNode

offlineprop

testNode의 testResource 리소스의 자식 리소스를 오프라인 시킵니다. 


mcres -u admin -pw password -offlineprop testResource -n testNode

probe

testNode의 testResource 리소스를 탐색합니다.


mcres -u admin -pw password -probe testResource -n testNode


clear

testNode의 testResource 리소스의 에러를 제거합니다.


mcres -u admin -pw password -clear testResource [ -n testNode ]

list

현재 리소스 상태를 출력합니다.


mcres -u admin -pw password -list [resource [ -a attribute]] | [-g group [-a attribute]]


핫빗 CLI 사용(mchb 명령)

핫빗에 관한 명령을 전달합니다. 핫빗 구성 리스트, 핫빗 구성 , 핫빗 수정, 클러스터명 수정, 핫빗 포트 수정 명령을 내릴 수 있습니다.

MCCS 는 설치 시 최초 사용자 계정으로 ID는 'admin' 비밀번호는 'password'인 계정이 생성됩니다.
CLI 명령을 실행 시 ID 와 비밀번호를 입력하지 않으면, 위의 최초 사용자 계정의 ID와 비밀번호로 실행됩니다.
따라서 최초 사용자의 비밀번호 변경 시, 필수적으로 CLI 명령에 ID와 비밀번호를 옵션으로 입력해야 합니다.


Syntax


mchb [-u userid] [-pw password] -options [-c newClustername ] [ -hbport port ] [ -node nodeName]

Options

옵션설명

-h

도움말을 출력합니다.

-u사용자 ID를 지정합니다.
-pw

-u 옵션의 사용자 비밀번호를 지정합니다.

-show

현재 구성된 핫빗 내용을 보여줍니다.

-clustermodify

변경하기 위한 새로운 클러스터 명을 입력합니다.

-hbport

변경할 새로운 핫빗 포트를 입력합니다.

-hbmodify

핫빗 구성을 변경합니다

-newconfig최초 핫빗 구성 시 사용합니다.

Example

show

구성되어 있는 핫빗 정보를 볼 수 있습니다.


mchb -u admin -pw password -show

clustermodify

testCluster 클러스터를 이름을 newCluster로 변경합니다.


mchb -u admin -pw password -clustermodify -c newCluster

hbport

핫빗 포트를 12345로 변경합니다.


mchb -u admin -pw password -hbport 12345

hbmodify

구성되어 있는 핫빗 라인중에 Primary1 핫빗을 200.200.200.1 과 200.200.200.2 로 변경합니다.


mchb -u admin -pw password -hbmodify -node Active 200.200.200.1,100.100.100.1,10.10.7.71 -node -StandBy 200.200.200.2,100.100.100.2,10.10.7.72

newcofig

핫빗을 구성합니다. 
클러스터 이름 : MCCS_Cluster
핫빗 포트 : 14321 , 상대방 노드 네트워크 주소 : 10.10.7.72
노드 이름  : Active , StandBy


mchb -u admin -pw password -newcofig -clustername MCCS_Cluster -hbport 14321 -remote 10.10.7.72 -node Active 100.100.100.1,200.200.200.1,10.10.7.71 -node StandBy 100.100.100.2,200.200.200.2,10.10.7.72




CLI를 이용한 script (CLI 활용 예)

그룹 CLITestGroup 생성

CLITestGroup 생성
@echo on 
@echo ### CLITestGroup 그룹이 없다면 신규 그룹을 생성합니다. 
set mclog="%MCCS_HOME%\bin\mclog.exe" 
set mcgroup="%MCCS_HOME%\bin\mcgroup.exe" 
%mclog% -n 192.168.100.2 -p 4321 -s CLITestGroup -l INFO -m "CLI 테스트 코드를 실행합니다." 

%mcgroup% -state CLITestGroup 
if not errorlevel 1 goto end 

@echo ### CLITestGroup을 생성합니다. 
%mclog% -n 192.168.100.2 -p 4321 -s CLITestGroup -l INFO -m "CLITestGroup이 존재 하지 않아 그룹을 생성합니다." 
%mcgroup% -u admin -pw password -add CLITestGroup 
%mcgroup% -u admin -pw password -modify CLITestGroup -a TargetNodeList Beta,Alpha 
%mclog% -n 192.168.100.2 -p 4321 -s CLITestGroup -l INFO -m "CLITestGroup을 생성했습니다."  

:end
%mclog% -n 192.168.100.2 -p 4321 -s CLITestGroup -l INFO -m "CLI 테스트 코드를 종료합니다."

그룹 CLITestGroup에 프로세스 CLITestProcess 생성 및 온라인

그룹 CTITestGroup에 CLITestProcess 생성 및 온라인
@echo on 
@echo ### CLITestProcess를 시작합니다. 
set mclog="%MCCS_HOME%\bin\mclog.exe" 
set mcres="%MCCS_HOME%\bin\mcres.exe" 

%mclog% -n 192.168.100.2 -p 4321 -s CLITestProcess -l INFO -m "CLI 테스트 코드를 실행합니다." 

@echo ### CLITestProcess가 있는지 검사합니다. 
%mcres% -u admin -pw password -list CLITestProcess 
if not errorlevel 3 goto end 

:cliTestProcessCreat 
@echo ### CLITestProcess 리소스를 생성한 후에 활성화 시킵니다. 
%mclog% -n 192.168.100.2 -p 4321 -s CLITestProcess -l INFO -m " CLITestProcess 리소스를 생성하고 온라인 시킵니다." 

%mcres% -u admin -pw password -add CLITestProcess -t Process -g CLITestGroup 
%mcres% -u admin -pw password -modify CLITestProcess -a Path c:\wordpad01.exe 
%mcres% -u admin -pw password -modify CLITestProcess -a InteractWithDesktop true 
%mcres% -u admin -pw password -enable CLITestProcess 
%mcres% -u admin -pw password -online CLITestProcess -n Beta 

:end 
@echo ### 그룹 상태를 모니터링 합니다. 
%mclog% -n 192.168.100.2 -p 4321 -s CLITestGroup -l INFO -m "CLI 테스트 코드를 종료합니다."
mclog -n 192.168.100.2 -p 4321 -s cli -l ERROR -m "mclog test message"


  • No labels