system config dump
sys conf dump

-

-

시스템 구성 파일의 내용을 JSON으로 출력.

system config dump-xml
sys conf dump-xml

-

-

시스템 구성 파일의 내용을 XML로 출력.

system config show
sys conf show

-

-

동작 중인 시스템 구성 내용을 JSON으로 출력.

system config adjust
sys conf adjust

-

-

시스템 구성 파일의 내용을 동작 중인 리소스에 적용하고 활성화한다.

system config edit
sys conf edit

-u, -user

텍스트 에디터로 수정

시스템 구성 내용을 대화형으로 편집하고 적용한다.

system config property get {key}
sys conf prop get {key}

-

-

시스템 구성 파일의 지정 속성 값을 출력한다.

system config property set <key> <value>
sys conf prop set <key> <value>

--adjust
-a

리소스에 적용한다

시스템 구성 파일의 지정 속성 값을 변경한다.

system config property unset <key>
sys conf prop unset <key>

-

-

상동

시스템 구성 파일의 지정 속성을 기본 값으로 변경한다.

control config dump <id|all>
conf dump <id>

-

-

리소스 구성 파일의 내용을 JSON으로 출력.

control config dump-xml <id|all>
conf dump-xml <id>

-

-

리소스 구성 파일의 내용을 XML로 출력.

control config show <id|all>
conf show <id|all>

-

-

동작 중인 리소스 구성 내용을 JSON으로 출력.

control config adjust <id|all>
conf adjust <id|all>

-

-

리소스 구성 파일의 내용을 동작 중인 리소스에 적용하고 활성화한다.

control config add <id>
conf add <id>

--force
-f

강제로 덮어 씌우기

리소스 구성 파일을 추가한다.

--interactive
-i

대화형 설정 모드

control config del <id>
conf del <id>

--force
-f

강제 삭제

리소스 구성 파일을 삭제한다.

control config edit <id>
conf edit <id>

--user
-u

텍스트 에디터로 수정

리소스 구성 내용을 대화형으로 편집하고 적용한다.

control config property get <id> {key}
conf prop get <id> {key}

-

-

리소스 구성 파일의 지정 속성 값을 출력한다.

control config property add <id> <key> <value>
conf prop add <id> <key> <value>

--adjust
-a

리소스에 적용한다

리소스 구성의 지정 속성에 값을 추가한다.
목록 형태의 속성에만 유효하다.

--index <숫자>

• i

<숫자>

지정 인덱스에 삽입

control config property del <id> <key>
conf prop del <id> <key>

--adjust
-a

리소스에 적용한다

상동

리소스 구성의 지정 속성을 삭제한다.
목록 형태의 속성에만 유효하다.

control config property set <id> <key> <value>
conf prop set <id> <key> <value>

상동

상동

상동

리소스 구성 파일의 지정 속성 값을 변경한다.

control config property unset <id> <key>
conf prop unset <id> <key>

상동

상동

상동

리소스 구성 파일의 지정 속성을 기본 값으로 변경한다.

control meta create <id|all>
meta create <id|all>

--force
-f

강제로 덮어 씌우기

리소스 메타 데이터 생성.
리소스가 분리된 상태에서만 수행 가능하다.

control meta delete <id|all>
meta delete <id|all>

--force
-f

강제로 삭제

리소스 메타 데이터 삭제.
리소스가 분리된 상태에서만 수행 가능하다.

control meta cleanup
meta cleanup

-

-

사용하지 않는 메타 데이터 정리.

control add <id|all>
add <id|all>

-

-

리소스 구성 파일을 읽어 리소스 목록에 적재.

control del <id|all>
del <id|all>

-

-

적재 된 리소스를 목록에서 제거.

control attach <id|all>
attach <id|all>

-

-

리소스 파일 적재.

control detach <id|all>
detach <id|all>

-

-

리소스 파일 분리.

control up <id|all>
up <id|all>

-

-

리소스 활성화. (적재, 파일 적재, 연결)

control down <id|all>
down <id|all>

-

-

리소스 비활성화. (연결 종료, 파일 분리, 분리)

control primary <id|all>
primary <id|all>

--force
-f

강제 승격

리소스를 Primary로 승격.

--unlock
-u

파일 잠금 해제

control secondary <id|all>
secondary <id|all>

--timeout <숫자>
-t <숫자>

시간 제한

리소스를 Secondary로 강등.
시간 제한 값이 있으면 해당 시간 동안 버퍼가 비워지는 것을 대기한다. 해당 시간 이후 버퍼를 강제로 비우고 강등한다.

--read-only 옵션은 --lock 옵션과 함께 사용해야한다.

--lock
-l

파일 잠금

--read-only

읽기 전용으로 잠금

control connect <id|all> {peer|all}
connect <id|all> {peer|all}

--discard-my-data

내 데이터를 버림

리소스를 상대 노드에 연결. connecting 상태로 변경 된다.

control disconnect <id|all> {peer|all}
disconnect <id|all> {peer|all}

-

-

상대 노드와의 연결 해제. standalone 상태로 변경 된다.

control invalidate <id|all> {peer}
invalidate <id|all> {peer}

--level <숫자>
-l <숫자>

동기화 수준

상대 노드를 소스로 동기화 시작.

--report <모드>

보고서 생성 범위

control invalidate-remote <id|all> {peer|all}
invalidate-remote <id|all> {peer|all}

--level <숫자>
-l <숫자>

동기화 수준

이 노드를 소스로 동기화 시작.

--report <모드>

보고서 생성 범위

control verify <id|all> {peer}
verify <id|all> {peer}

-

-

상대 노드를 소스로 정합성 검증 시작.

control pause <id|all> {peer|all}
pause <id|all> {peer|all}

-

-

동기화 또는 복제 일시 중지.

control resume <id|all> {peer|all}
resume <id|all> {peer|all}

-

-

동기화 또는 복제 재개.

control lock <id|all>
lock <id|all>

--read-only

읽기 전용으로 잠금

파일 보호 시작.

control unlock <id|all>
unlock <id|all>

-

-

파일 보호 해제.

control close-files <id|all>
close-files <id|all>

-

-

복제를 위해 열려있는 파일의 핸들을 닫는다.

control override network-limit <res-id|all> <peer-node|all> <value>
override network-limit <res-id|all> <peer-node|all> <value>

-

-

네트워크 대역폭을 임의로 변경한다.

control restore network-limit <res-id|all> {peer-node|all}
restore network-limit <res-id|all> {peer-node|all}

-

-

네트워크 대역폭을 구성 값으로 되돌린다.

system info
sys info

-

-

엔진 정보 출력.

control status {id|all}
status {id|all}

--verbose
-v

상세 출력

리소스와 연결의 상태 출력.

--watch
-w

모니터링

--interval <시간>
-i <시간>

모니터링 시 갱신 주기

control perf {id|all}
perf {id|all}

--verbose
-v

상세 출력

리소스 연결의 버퍼와 네트워크 등의 성능 통계 출력.

--watch
-w

모니터링

--interval <시간>
-i <시간>

모니터링 시 갱신 주기

control result <id> {dir-index} {filename}
result <id> {dir-index} {filename}

--verbose
-v

상세 출력

가장 최근의 동기화 또는 정합성 검증의 결과 출력.
결과는 타겟에 저장되므로 타겟에서만 출력 가능하다.
디렉토리 및 파일명을 지정하면 요약 정보를 생략하고 지정한 파일의 결과를 출력한다.

control rid show <id|all>
rid show <id|all>

--verbose
-v

상세 출력

리소스의 RID 출력.
기본적으로 Old ULID를 2개만 출력하며, 긴 버전 옵션이 지정된 경우에는 32개를 모두 출력한다.

--long
-l

긴 버전의 RID 출력

events
ev

--json
-j

JSON 포맷으로 출력

이벤트 모니터링.
동기화 진행률과 성능 통계는 기본적으로 갱신 주기 마다 전달되지만, 이전 데이터와 변화가 없는 경우 생략된다.

--sync

동기화 진행률 포함

--perf

성능 통계 포함

--interval <시간>
-i <시간>

동기화 진행률과 성능 통계 갱신 주기

log
l

--home <경로>

엔진 홈 경로

로그 파일의 내용을 출력한다.
tail 명령과 유사하게 동작하며, 엔진의 시스템 구성 파일을 직접 읽어 로그 파일의 위치를 파악하므로 엔진이 종료되어 있어도 사용 가능하다.
gRPC를 통해 리소스 적재 이벤트를 받아 출력해야 하는 로그 파일을 실시간으로 변경한다.

--lines <숫자>
-n <숫자>

출력 할 라인 수

--resource <id>
-t <id>

리소스 지정

--no-main

메인 로그 비활성화

--no-resource

리소스 로그 비활성화

--no-color

생상을 입히지 않음

--follow
-f

지속 출력

perfmon {id|all}
p {id|all}

--json <파일명>
-j <파일명>

JSON 파일로 내보내기

성능 모니터의 정보를 출력한다.
JSON이나 CSV로 내보내는 옵션을 사용하지 않으면 콘솔 화면에 출력한다.

--display 옵션을 사용하면 파일로 내보내면서 화면에도 출력이 가능하다.

--csv <파일명>
-c <파일명>

CSV 파일로 내보내기

--interval <시간>
-i <시간>

정보 갱신 주기

--display
-d

콘솔 화면에 출력

--watch
-w

모니터링 모드

RPC 연결 상태

rpc

state

연결 상태

connected, disconnected

-

cause

오류 내용

disconnected 상태에서만 사용 됨

프로그램 기동/종료

program

state

프로그램 기동 상태

started, exit

-

cause

오류 내용

exit 상태에서만 사용 됨

시스템 설정 갱신

system_updated

-

-

adjust 수행 시 발생한다

-

리소스 추가

added

resource

리소스 ID

-

-

node

자신의 노드명

-

리소스 삭제

deleted

resource

리소스 ID

-

-

node

자신의 노드명

-

리소스 상대 노드 추가

peer_added

resource

리소스 ID

-

-

node

자신의 노드명

-

peer

상대 노드명

-

리소스 상대 노드 제거

peer_deleted

resource

리소스 ID

-

-

node

자신의 노드명

-

peer

상대 노드명

-

리소스 노드명 변경

renamed

resource

리소스 ID

-

-

node

자신의 노드명

-

value

새로운 노드명

-

리소스 노드명 변경 (상대)

peer_renamed

resource

리소스 ID

-

-

node

자신의 노드명

-

peer

상대 노드명

-

value

상대의 새로운 노드명

-

리소스 설정 갱신

updated

resource

리소스 ID

adjust 수행 시 발생한다

-

node

자신의 노드명

-

리소스 연결 상태

state

resource

리소스 ID

-

-

node

자신의 노드명

-

peer

상대 노드명

-

value

상태 값

standalone, established 등

리소스 연결 상태 (상대)

peer_state

resource

리소스 ID

-

-

node

자신의 노드명

-

peer

상대 노드명

-

value

상태 값

standalone, established 등

리소스 파일 상태

file_state

resource

리소스 ID

-

node

자신의 노드명

-

value

상태 값

inconsistent, consistent 등

리소스 파일 상태 (상대)

peer_file_state

resource

리소스 ID

-

-

node

자신의 노드명

-

peer

상대 노드명

-

value

상태 값

inconsistent, consistent 등

리소스 역할

role

resource

리소스 ID

-

-

node

자신의 노드명

-

value

역할 값

primary, secondary

리소스 역할 (상대)

peer_role

resource

리소스 ID

-

-

node

자신의 노드명

-

peer

상대 노드명

-

value

역할 값

primary, secondary

노드 연결 동작

connection

resource

리소스 ID

-

-

node

자신의 노드명

-

peer

상대 노드명

-

state

연결 상태

connected, accepted, disconnected

url

IP:Port

상대 노드의 주소

cause

오류 내용

disconnected에서만 사용 됨

상대 노드로부터 연결이 거부 됨

refuse

resource

리소스 ID

-

-

node

자신의 노드명

-

peer

상대 노드명

-

cause

거부 이유

irrelevance(관계 없는 노드), split-brain
two-primary, invalid-direction

younger

younger 노드명

-

쓰기 오류

write_error

resource

리소스 ID

-

-

node

자신의 노드명

-

filename

파일명

절대 경로

cause

오류 내용

-

디스크 공간 상태

diskspace

resource

리소스 ID

-

-

node

자신의 노드명

-

state

공간 상태

not_enough, enough

remain

남은 용량

바이트 단위. 문자열 형식

성능 정보

perf

resource

리소스 ID

-

--perf 옵션 필요

node

자신의 노드명

-

peer

상대 노드명

-

perf

성능 정보

REST-API의 성능 정보와 같다.

동기화 상태

sync

resource

리소스 ID

-

--sync 옵션 필요

node

자신의 노드명

-

peer

상대 노드명

-

status

동기화 상태

REST-API의 동기화 상태와 같다.

파일 잠금

file_lock

resource

리소스 ID

-

-

state

잠금 상태

REST-API의 파일 잠금 상태와 같다.

node

자신의 노드명

-

RID

rid

resource

리소스 ID

-

node

자신의 노드명

value

RID 값

consistency

플래그

파일 상태가 Consistent 이상인 경우 true

outdated

플래그

파일 상태가 Outdated인 경우 true

primary

플래그

승격된 경우 true

crashed_primary

플래그

Primary 상태에서 비정상 종료된 경우 true

파일 버퍼 사용량 경고

file_buf_warn

resource

리소스 ID

-

0.9.1

node

자신의 노드명

-

peer

상대 노드명

-

버퍼 넘침

overflowed

resource

리소스 ID

-

0.9.1

node

자신의 노드명

-

peer

상대 노드명

-

라이선스 상태

license

status

라이선스 상태

invalid, expired, not exist, valid

-

license-type

라이선스 유형

temporary, permanent

expires-at

기간 제한 (날짜)

년-월-일 (예: 2020-11-30)

expires-in

기간 제한 (남은 일자)

-

efs analyze dir <dir…>
efs analyze by-dir <dir…>

--json
-j

JSON 포맷으로 출력

지정한 디렉토리 하위의 암호화 된 파일을 조회하여 복호화에 필요한 인증서 목록과 설치 상태를 분석한다.

--verbose
-v

상세 출력

efs analyze resource <id>
efs analyze by-res <id>

--json
-j

JSON 포맷으로 출력

지정한 리소스의 복제 경로 하위의 암호화 된 파일을 조회하여 복호화에 필요한 인증서 목록과 설치 상태를 분석한다.

--verbose
-v

상세 출력

efs cert list

-

-

인증서 스토어의 인증서 목록을 출력한다.

efs cert export <thumbprint> <file>

--password <password>
-p <password>

인증서 비밀번호

지정한 리소스의 복제 경로 하위의 암호화 된 파일을 조회하여 복호화에 필요한 인증서 목록과 설치 상태를 분석.

efs cert import <file>

--password <password>
-p <password>

인증서 비밀번호

지정 파일의 인증서를 가져와 인증서 스토어에 등록

--set-current
-c

현재 인증서로 지정

efs cert set-current <thumbprint>

-

-

인증서 스토어의 지정 인증서를 암호화를 위한 현재 인증서로 지정

efs cert delete <thumbprint>

-

-

인증서 스토어에서 지정 인증서 삭제

efs usercert list

-

-

인증서 스토어의 인증서 목록을 출력한다.

efs usercert export <thumbprint> <file>

--password <password>
-p <password>

인증서 비밀번호

지정한 리소스의 복제 경로 하위의 암호화 된 파일을 조회하여 복호화에 필요한 인증서 목록과 설치 상태를 분석.

efs usercert import <file>

--password <password>
-p <password>

인증서 비밀번호

지정 파일의 인증서를 가져와 인증서 스토어에 등록

--set-current
-c

현재 인증서로 지정

efs usercert set-current <thumbprint>

-

-

인증서 스토어의 지정 인증서를 암호화를 위한 현재 인증서로 지정

efs usercert delete <thumbprint>

-

-

인증서 스토어에서 지정 인증서 삭제

드라이버 설치

driver install

--force
-f

강제 설치

-

드라이버를 설치한다. 드라이버가 적재 중일때는 실패한다.
강제 설치 옵션 사용 시 적재 중인 드라이버를 분리 한 뒤 설치한다.

드라이버 제거

driver uninstall

--force
-f

강제 제거

-

드라이버를 제거한다. 드라이버가 적재 중일때는 실패한다.
강제 설치 옵션 사용 시 적재 중인 드라이버를 분리 한 뒤 제거한다.

엔진 재시작

system restart
sys restart

-

현재 프로세스 PID는 유지하면서 엔진의 동작 전체를 재시작한다.

엔진 종료

system stop
sys stop

-

실행 중인 엔진에 종료 명령을 전달하여 스스로 종료하도록 한다. 서비스로 실행중이면 자동으로 재 시작 된다.

RID 비교

control rid compare <rid1> <rid2>
rid compare <rid1> <rid2>

-

-

두 RID의 비교 결과를 출력한다.

서포트 파일
생성

system support
sys su

--dump <file>
-d <file>

포함할 덤프 파일 지정

서포트 파일 생성

설정

license set <license-file>

-

지정한 파일을 읽어 라이선스를 설정한다.

조회

license show

-

현재 라이선스 상태를 출력한다.