machcoordinatoradmin
Coordinator는 클러스터 전체 관리 도구입니다.
클러스터 에디션 패키지에만 존재합니다.
옵션 및 기능
machcoordinatoradmin의 옵션은 다음과 같습니다. 이전 섹션에서 설명한 기능은 생략되었습니다.
mach@localhost:~$ machcoordinatoradmin -h| 옵션 | 설명 |
|---|---|
| -u, –startup | Coordinator 프로세스 실행 |
| -s, –shutdown | Coordinator 프로세스 종료 |
| -k, –kill | Coordinator 프로세스 중지 |
| -c, –createdb | Coordinator 메타 생성 |
| -d, –destroydb | Coordinator 메타 제거, $MACHBASE_COORDINATOR_HOME/package의 패키지 파일 삭제 |
| -e, –check | Coordinator 프로세스 실행 여부 확인 |
| -i, –silent | 배너 출력 없이 실행 |
| –configuration[=name] | 설정의 키와 값 출력 (특정 키만 출력 가능) |
| –configure | 시스템 속성 목록 출력 |
| –activate | 클러스터 상태를 Service로 전환 |
| –deactivate | 클러스터 상태를 Deactivate로 전환 |
| –list-package[=package] | 등록된 패키지 정보 목록 출력 (특정 패키지만 출력 가능) |
| –add-package=package | 패키지 추가 |
| –remove-package=package | 패키지 삭제 |
| –list-node[=node] | 노드 정보 목록 출력 (특정 노드만 출력 가능) |
| –add-node=node | 노드 추가 |
| –remove-node=node | 노드 삭제 |
| –attach-node=node | 기존 노드를 클러스터 메타에 연결 |
| –detach-node=node | 노드를 클러스터 메타에서 분리 |
| –upgrade-node=node | 노드 업그레이드 |
| –startup-node=node | 노드 실행 |
| –shutdown-node=node | 노드 종료 |
| –kill-node=node | 노드 중지 |
| –startup-lookup | Lookup 노드 실행 |
| –shutdown-lookup | Lookup 노드 종료 |
| –set-lookup-master=node | Lookup master 노드 지정 |
| –cluster-status | 클러스터의 각 노드 상태 출력 |
| –cluster-status-full | 클러스터의 각 노드 상태를 상세히 출력 |
| –verbose | 클러스터 상태 출력 시 Deployer 상태를 함께 출력 |
| –cluster-node | 클러스터 정보 출력 |
| –set-group-state=`[normal | readonly]` |
| –set-warehouse-state=`[normal | scrapped]` |
| –force-restore-warehouse=node | scrapped Warehouse 노드 강제 복구 |
| –get-host-resource | 각 노드가 위치한 호스트 리소스 정보 출력 |
| –host-resource-enable | 각 노드의 호스트 리소스 정보 수집 시작 |
| –host-resource-disable | 각 노드의 호스트 리소스 정보 수집 중지 |
| –deactivate-broker=node | 지정 노드를 inactive 상태로 전환 |
| –activate-broker=node | 지정 노드를 normal 상태로 전환 |
| –snapshot-interval=sec | Snapshot 실행 주기 설정 |
| –exec-snapshot | Snapshot 실행 (--group 필요) |
| –snapshot-recover=node | 지정 노드 Snapshot 복구 |
| –exec-sync=node | 지정 노드 Sync 실행 |
| –snapshot-clean | Snapshot 정리 |
| 추가 옵션 | 설명 | 필수 옵션 |
|---|---|---|
| –file-name=filename | 파일 이름 | –add-package |
| –port-no=portno | 서비스 포트 번호 | –add-node, –attach-node |
| –http-port-no=portno | HTTP 관리 포트 번호 | –add-node, –attach-node |
| –deployer=node | Deployer 노드 이름 | –add-node |
| –package-name=packagename | 설치 소스가 될 패키지 이름 | –add-node, –upgrade-node |
| –home-path=path | Deployer 서버 기준, 현재 노드의 설치 경로 | –add-node, –attach-node |
| –node-type=`[broker | warehouse | lookup]` |
| –lookup-type=`[master | slave | monitor]` |
| –node=node | 상태 변경 대상 노드 이름 또는 alias | –set-warehouse-state |
| –alias=alias | 추가 또는 연결할 노드의 alias | –add-node, –attach-node |
| –dbs-path=path | Broker/Warehouse 데이터베이스 파일 경로 | –add-node |
| –group=groupname | 설치할 노드의 그룹 이름 | –add-node, –attach-node, –set-group-state, –exec-snapshot |
| –replication=host:port | 복제를 교환할 host:port | –add-node, –attach-node |
| –no-replicate | 설치할 노드에서 복제를 사용하지 않음 | –add-node, –attach-node |
| –primary=host:port | Secondary Coordinator 설치 시 Primary Coordinator의 노드 이름 지정 | -u, –startup |
| –host=host | 호스트 리소스 정보를 출력할 특정 호스트 지정 | –get-host-resource |
| –metric=`[cpu | memory | disk |
실행 상태 확인
예제:
mach@localhost:~$ machcoordinatoradmin -e
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Machbase Coordinator is running with pid(29245)!메타 생성 / 삭제
예제:
mach@localhost:~$ machcoordinatoradmin -c
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Coordinator metadata created successfully.
mach@localhost:~$ machcoordinatoradmin -d
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Coordinator metadata destroyed successfully.설정 출력
구문:
machcoordinatoradmin --configuration[=name]예제:
mach@localhost:~$ machcoordinatoradmin --configuration
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Name : CLUSTER
Value : 3
Name : DECISION
Value : ON
Name : HOST-RESOURCE
Value : OFF
mach@localhost:~$ machcoordinatoradmin --configuration=decision
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Name : DECISION
Value : ON
Format : text/plain시스템 속성 목록 출력
구문
machcoordinatoradmin --configure예제
mach@localhost:~$ machcoordinatoradmin --configure
CLUSTER_LINK_HOST=192.168.0.30
CLUSTER_LINK_PORT_NO=36110
CLUSTER_LINK_THREAD_COUNT=16
CLUSTER_LINK_MAX_LISTEN=512
CLUSTER_LINK_MAX_POLL=4096
CLUSTER_LINK_ACCEPT_TIMEOUT=5000000
CLUSTER_LINK_CHECK_INTERVAL=1000000
CLUSTER_LINK_CONNECT_RETRY_TIMEOUT=60000000
CLUSTER_LINK_CONNECT_TIMEOUT=5000000
CLUSTER_LINK_HANDSHAKE_TIMEOUT=5000000
CLUSTER_LINK_LONG_TERM_CALLBACK_INTERVAL=1000000
CLUSTER_LINK_LONG_WAIT_INTERVAL=1000000
CLUSTER_LINK_RECEIVE_TIMEOUT=5000000
CLUSTER_LINK_REQUEST_TIMEOUT=60000000
CLUSTER_LINK_SEND_TIMEOUT=5000000
CLUSTER_LINK_SESSION_TIMEOUT=3600000000
CLUSTER_LINK_ERROR_ADD_ORIGIN_HOST=0
CLUSTER_LINK_BUFFER_SIZE=33554432
..
..클러스터 상태 변경
예제:
mach@localhost:~$ machcoordinatoradmin --activate
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Name : CLUSTER
Value : 3
Format : text/plain
mach@localhost:~$ machcoordinatoradmin --deactivate
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Name : CLUSTER
Value : 0
Format : text/plain패키지 정보 목록 출력
구문:
machcoordinatoradmin --list-package[=package]예제:
mach@localhost:~$ machcoordinatoradmin --list-package
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Package Name : machbase
File Name : machbase-cluster-6bab497c9.develop-LINUX-X86-64-release-lightweight.tgz
File Size : 64630670 bytes
Package Name : machbase2
File Name : machbase-cluster-e3c0717.develop-LINUX-X86-64-release-lightweight.tgz
File Size : 64677030 bytes
mach@localhost:~$ machcoordinatoradmin --list-package=machbase
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Package Name : machbase
File Name : machbase-cluster-6bab497c9.develop-LINUX-X86-64-release-lightweight.tgz
File Size : 64630670 bytes노드 추가, Alias, DBS_PATH
Broker 또는 Warehouse 노드를 추가할 때는 --node-type, --deployer, --package-name, --home-path, --port-no를 함께 지정한다. HTTP 관리 포트가 필요한 경우 --http-port-no를 지정한다.
예제:
machcoordinatoradmin \
--add-node=192.168.0.32:5401 \
--node-type=warehouse \
--deployer=192.168.0.32:5201 \
--package-name=machbase \
--home-path=/home/machbase/warehouse_a1 \
--port-no=5400 \
--http-port-no=5402 \
--group=Group1 \
--alias=warehouse-a1 \
--dbs-path=/data/machbase/warehouse_a1_dbsLookup 노드를 추가하거나 연결할 때는 --node-type=lookup과 --lookup-type을 함께 지정한다.
예제:
machcoordinatoradmin \
--add-node=192.168.0.32:5601 \
--node-type=lookup \
--lookup-type=master \
--deployer=192.168.0.32:5201 \
--package-name=machbase \
--home-path=/home/machbase/lookup1 \
--alias=lookup-master-1기존 노드를 클러스터 메타에 연결할 때는 --attach-node를 사용한다. --attach-node도 --alias를 사용할 수 있지만 --dbs-path는 사용할 수 없다.
machcoordinatoradmin \
--attach-node=192.168.0.32:5401 \
--node-type=warehouse \
--home-path=/home/machbase/warehouse_a1 \
--port-no=5400 \
--http-port-no=5402 \
--group=Group1 \
--alias=warehouse-a1--alias는 --add-node와 --attach-node에서 지정할 수 있다. 지정하지 않으면 노드 유형에 따라 coordinator-N, deployer-N, broker-N, warehouse-N, lookup-N 형식으로 자동 생성된다.
Alias 이름은 1자 이상이어야 하며 영문자, 숫자, -, _, .만 사용할 수 있다. Alias는 클러스터 전체에서 유일해야 하고 실제 노드 이름과도 충돌하면 안 된다.
등록 후 alias만 변경하는 별도 명령은 없다.
명령 대상 노드는 실제 노드 이름을 먼저 찾고, 없으면 alias를 찾는다. 따라서 --startup-node, --shutdown-node, --kill-node, --remove-node, --detach-node, --upgrade-node, --set-lookup-master, --set-warehouse-state, --force-restore-warehouse, --snapshot-recover, --exec-sync에서 alias를 사용할 수 있다. 상태 출력에서는 alias가 있으면 alias(real-node-name) 형식으로 표시될 수 있다.
--dbs-path는 --add-node로 Broker 또는 Warehouse를 추가할 때만 사용할 수 있다. Lookup, Coordinator, Deployer 노드에는 사용할 수 없고 --attach-node, --upgrade-node 같은 다른 명령과 함께 사용할 수도 없다.
--dbs-path 값은 / 또는 ?로 시작해야 한다. 줄바꿈, 탭, 끝 공백은 허용되지 않는다. /, /etc, /usr, /home, /bin처럼 시스템 경로 자체를 직접 지정하는 값은 거부된다. /home/machbase/warehouse_a1_dbs처럼 시스템 경로 아래의 실제 데이터 디렉터리는 별도 디렉터리로 지정할 수 있다.
절대 경로를 custom DBS_PATH로 지정하면 노드 추가 시점에 해당 디렉터리가 존재하지 않아야 한다. Deployer가 machadmin -c 실행 전에 디렉터리를 생성한다. 이미 존재하면 DBS_PATH already exists 오류로 노드 추가가 실패한다. --dbs-path를 생략하면 Broker/Warehouse 설정에는 기본값 DBS_PATH = ?/dbs가 기록된다. Broker/Warehouse를 --remove-node로 삭제할 때 명시적인 절대 경로 DBS_PATH는 노드 home 경로와 별도로 정리된다.
노드 정보 목록 출력
구문:
machcoordinatoradmin --list-node[=node]예제:
mach@localhost:~$ machcoordinatoradmin --list-node
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Node Name : 192.168.0.32:5101
Node Type : coordinator
HTTP Admin Port : 5102
Group Name : Coordinator
Desired State : primary
Actual State : primary
Coordinator Host : 192.168.0.32:5101
Last Response Time : 497590
Last Modify Time : 421020408
Last Response Elapsed : 1006148
Node Name : 192.168.0.32:5201
Node Type : deployer
Group Name : Deployer
Desired State : normal
Actual State : normal
Coordinator Host : 192.168.0.32:5101
Last Response Time : 497594
Last Modify Time : 404915419
Last Response Elapsed : 1006128
Node Name : 192.168.0.32:5301
Node Type : broker
Port Number : 5757
Http Port : 5302
Deployer : 192.168.0.32:5201
Package Name : machbase
Home Path : /home/machbase/broker1
Group Name : Broker
Desired State : leader
Actual State : leader
Coordinator Host : 192.168.0.32:5101
Last Response Time : 497544
Last Modify Time : 353606480
Last Response Elapsed : 1006157
Node Name : 192.168.0.32:5401
Node Type : warehouse
Port Number : 5400
Http Port : 5402
Deployer : 192.168.0.32:5201
Package Name : machbase
Home Path : /home/machbase/warehouse_a1
Group Name : Group1
Desired State : normal
Actual State : normal
Coordinator Host : 192.168.0.32:5101
Last Response Time : 497556
Last Modify Time : 332480933
Last Response Elapsed : 1006160
mach@localhost:~$ machcoordinatoradmin --list-node=192.168.0.32:5401
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Node Name : 192.168.0.32:5401
Node Type : warehouse
Port Number : 5400
Http Port : 5402
Deployer : 192.168.0.32:5201
Package Name : machbase
Home Path : /home/cumulus/warehouse_a1
Group Name : Group1
Desired State : normal
Actual State : normal
Coordinator Host : 192.168.0.32:5101
Last Response Time : 648879
Last Modify Time : 419153148
Last Response Elapsed : 1005962클러스터 노드 상태 출력
예제:
mach@localhost:~$ machcoordinatoradmin --cluster-status
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
+-------------+-------------------+-------------------+-------------------+--------------+
| Node Type | Node Name | Group Name | Group State | State |
+-------------+-------------------+-------------------+-------------------+--------------+
| coordinator | 192.168.0.32:5101 | Coordinator | normal | primary |
| deployer | 192.168.0.32:5201 | Deployer | normal | normal |
| broker | 192.168.0.32:5301 | Broker | normal | leader |
| warehouse | 192.168.0.32:5401 | Group1 | normal | normal |
+-------------+-------------------+-------------------+-------------------+--------------+
mach@localhost:~$ machcoordinatoradmin --cluster-status-full
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
+-------------+-------------------+-------------------+-------------------+-------------------------------+-------------+
| Node Type | Node Name | Group Name | Group State | Desired & Actual State | RP State |
+-------------+-------------------+-------------------+-------------------+-------------------------------+-------------+
| coordinator | 192.168.0.32:5101 | Coordinator | normal | primary | primary | ----------- |
| deployer | 192.168.0.32:5201 | Deployer | normal | normal | normal | ----------- |
| broker | 192.168.0.32:5301 | Broker | normal | leader | leader | ----------- |
| warehouse | 192.168.0.32:5401 | Group1 | normal | normal | normal | ----------- |
+-------------+-------------------+-------------------+-------------------+-------------------------------클러스터 정보 출력
예제:
mach@localhost:~$ machcoordinatoradmin --cluster-node
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Token Pid : 29245
Token Time : 1553153902646178
Modify Time : 1553154010296715
Modify Count : 8
Cluster Status : Service
Broker : 192.168.0.32:5301
Warehouse : 192.168.0.32:5401그룹 상태 변경
구문:
machcoordinatoradmin --set-group-state=[ normal | readonly ] --group=group예제:
mach@localhost:~$ machcoordinatoradmin --set-group-state=readonly --group=Group1
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Group Name: Group1
Flag : 1
mach@localhost:~$ machcoordinatoradmin --cluster-status
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
+-------------+-------------------+-------------------+-------------------+--------------+
| Node Type | Node Name | Group Name | Group State | State |
+-------------+-------------------+-------------------+-------------------+--------------+
| coordinator | 192.168.0.32:5101 | Coordinator | normal | primary |
| deployer | 192.168.0.32:5201 | Deployer | normal | normal |
| broker | 192.168.0.32:5301 | Broker | normal | leader |
| warehouse | 192.168.0.32:5401 | Group1 | readonly | normal |
+-------------+-------------------+-------------------+-------------------+--------------+호스트 리소스 출력
구문:
machcoordinatoradmin --host-resource-enable [--metric=metric] [host=host]예제:
mach@localhost:~$ machcoordinatoradmin --host-resource-enable
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Name : HOST-RESOURCE
Value : ON
Format : text/plain
mach@localhost:~$ machcoordinatoradmin --get-host-resource
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Host Name : 192.168.0.32
CPU Info :
Model Name : Intel(R) Xeon(R) CPU E3-1231 v3 @ 3.40GHz
Number of CPUs : 8
Number of CPU Cores : 4
CPU Utilization : 14.0%
CPU IOWait Ratio : 0.0%
Memory Info :
Physical Memory Utilization : 99.1%
Virtual Memory Utilization : 98.6%
Network Info :
Receive Bytes(per second) : 42809
Receive Packets(per second) : 337
Transmit Bytes(per second) : 42885
Transmit Packets(per second) : 332
Disk Info :
/dev/sda1 : 87.4%
|-> 192.168.0.32:5101 /home/cumulus/coordinator1
|-> 192.168.0.32:5301 /home/cumulus/broker1
|-> 192.168.0.32:5401 /home/cumulus/warehouse_a1
Host Name : 192.168.0.33
CPU Info :
Model Name : Intel(R) Xeon(R) CPU E3-1231 v3 @ 3.40GHz
Number of CPUs : 8
Number of CPU Cores : 4
CPU Utilization : 2.0%
CPU IOWait Ratio : 0.0%
Memory Info :
Physical Memory Utilization : 46.9%
Virtual Memory Utilization : 22.8%
Network Info :
Receive Bytes(per second) : 12336
Receive Packets(per second) : 103
Transmit Bytes(per second) : 13500
Transmit Packets(per second) : 103
Disk Info :
/dev/sda1 : 64.2%
|-> 192.168.0.33:5101 /home/cumulus/coordinator2
|-> 192.168.0.33:5401 /home/cumulus/warehouse_a2
mach@localhost:~$ machcoordinatoradmin --get-host-resource --metric=cpu
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Host Name : 192.168.0.32
CPU Info :
Model Name : Intel(R) Xeon(R) CPU E3-1231 v3 @ 3.40GHz
Number of CPUs : 8
Number of CPU Cores : 4
CPU Utilization : 13.9%
CPU IOWait Ratio : 0.0%
Host Name : 192.168.0.33
CPU Info :
Model Name : Intel(R) Xeon(R) CPU E3-1231 v3 @ 3.40GHz
Number of CPUs : 8
Number of CPU Cores : 4
CPU Utilization : 1.9%
CPU IOWait Ratio : 0.0%
mach@localhost:~$ machcoordinatoradmin --get-host-resource --host=192.168.0.33
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Host Name : 192.168.0.33
CPU Info :
Model Name : Intel(R) Xeon(R) CPU E3-1231 v3 @ 3.40GHz
Number of CPUs : 8
Number of CPU Cores : 4
CPU Utilization : 2.0%
CPU IOWait Ratio : 0.0%
Memory Info :
Physical Memory Utilization : 46.9%
Virtual Memory Utilization : 22.8%
Network Info :
Receive Bytes(per second) : 12588
Receive Packets(per second) : 106
Transmit Bytes(per second) : 13330
Transmit Packets(per second) : 100
Disk Info :
/dev/sda1 : 64.2%
|-> 192.168.0.33:5101 /home/cumulus/coordinator2
|-> 192.168.0.33:5401 /home/cumulus/warehouse_a2
mach@localhost:~$ machcoordinatoradmin --host-resource-disable
-------------------------------------------------------------------------
Machbase Coordinator Administration Tool
Release Version - e3c0717.develop
Copyright 2014, MACHBASE Corp. or its subsidiaries
All Rights Reserved
-------------------------------------------------------------------------
Name : HOST-RESOURCE
Value : OFF
Format : text/plain최근 업데이트