Coordinator 운영 방법
추가
Web Admin
화면 왼쪽의 'Install' 메뉴를 통해 Coordinator 를 생성할 수 있다.
Command-line
- Coordinator 가 설치될 서버로 직접 접속해서 압축을 푼다.
conf/machbase.conf.sample
을conf/machbase.conf
로 복사한다.conf/machbase.conf
에 다음을 추가한다.CLUSTER_LINK_HOST = 192.168.0.10 # Cluster HOST CLUSTER_LINK_PORT_NO = 5101 # Cluster PORT HTTP_ADMIN_PORT = 5102 # Admin PORT COORDINATOR_PRIMARY = 192.168.0.10:5101 # Primary Coordinator HOST:PORT COORDINATOR_SECONDARY = 192.168.0.11:5101 # Secondary Coordinator HOST:PORT
- 설치 경로를
$MACHBASE_COORDINATOR_HOME
로 설정한다. $MACHBASE_COORDINATOR_HOME/bin
을$PATH
에 인식하도록 설정한다.machcoordinatoradmin -c
를 통해 메타 정보를 생성한다.machcoordinatoradmin -u
를 통해 Coordinator 를 실행한다.
machbase.conf
에 적는 추가 정보에 대한 설명은 다음과 같다.
항목 | 설명 |
---|---|
CLUSTER_LINK_HOST | 현재 서버의 IP |
CLUSTER_LINK_PORT_NO | 다른 Node와 통신할 PORT 번호. CLUSTER_LINK_HOST 와 같이 쓰면 'Node 이름' 이 된다. |
HTTP_ADMIN_PORT | Coordinator와 Deployer가 통신할 PORT 번호. |
COORDINATOR_PRIMARY | Primary Coordinator의 'Node 이름' 현재 Coordinator 가 Primary 라면, 현재 이름을 적는다. |
COORDINATOR_SECONDARY | Secondary Coordinator의 'Node 이름' 현재 Coordinator 가 Secondary 라면, 현재 이름을 적는다. |
삭제
Web Admin
삭제 기능이 없다. 직접 삭제해야 한다.
Command-line
- Coordinator 가 설치된 서버로 접속한다.
machcoordinatoradmin -s
를 통해 Coordinator 프로세스를 정상 종료시킨다.- 해당 Coordinator 디렉토리를 삭제한다.
업그레이드
Coordinator는 Node 관리를 담당하므로, Node 관리를 하지 않아도 되는 상황이라면 데이터 서비스를 중단시키지 않아도 Coordinator에 대한 업그레이드가 가능하다.
Web Admin
현재는 Node 업그레이드 기능이 존재하지 않는다.
Command-line
- Coordinator 가 설치된 서버로 접속한다.
machcoordinatoradmin -s
를 통해 Coordinator 프로세스를 정상 종료시킨다.- 준비한 패키지를 Coordinator가 설치된 경로로 압축을 푼다.
machcoordinatoradmin -u
를 통해 Coordinator 프로세스를 구시킨다.
Meta 생성/삭제
Meta 정보가 정상적이지 않을 때 등의 문제로 인해, Meta를 직접 제어해야 할 경우에 한해서 사용할 수 있다.
Web Admin
Web Admin 에서는 Meta 생성/삭제를 할 수 없다. 대신, Coordinator를 추가하면서 자동으로 Meta를 생성한다.
Command-line
- Coordinator 가 설치된 서버로 접속한다.
- 다음 중 하나를 수행한다.
- Meta를 생성하려면
machcoordinatoradmin -c
- Meta를 삭제하려면
machcoordinatoradmin -d
- Meta를 생성하려면
구동/종료/중단
추가 또는 업그레이드의 이유로 Coordinator를 별도로 구동/종료/중단시키는 경우에 한해서 사용할 수 있다.
Web Admin
Web Admin 에서는, Coordinator의 구동/종료/중단을 할 수 없다.
Command-line
- Coordinator 가 설치된 서버로 접속한다.
- 다음 중 하나를 수행한다.
- 프로세스를 구동하려면
machcoordinatoradmin -u
- 프로세스를 종료하려면
machcoordinatoradmin -s
- 프로세스를 중단시키려면
machcoordinatoradmin -k
- 프로세스를 구동하려면
패키지 추가/삭제
Web Admin
패키지
Command-line
패키지 목록
Web Admin
Command-line
Mode 전환
Web Admin
Command-line
클러스터 상태 확인
Web Admin
Cluster Admin 화면에서, 모든 Coordinator/Deployer/Broker/Warehouse 의 상태와 정보를 확인할 수 있다.
Node의 색이 빨간색이면 Online, 파란색이면 Offline 이다.
Node의 이름을 클릭하면, 오른쪽 패널에 관련 정보가 나타난다.
Node 정보 패널
분류 | 설명 | 예시 |
---|---|---|
Node Name | Node의 이름. 'Cluster Host:Cluster Port' 의 형태로 보인다. |
192.168.0.33:23410 |
Node Type | (Coordinator/Deployer/Broker/Warehouse) | Warehouse |
Port No | machsql, machloader 등의 클라이언트가 접속할 수 있는 Node의 Port |
5656 |
Deployer Host | 담당 Deployer 이름 (Coordinator, Deployer는 없다) |
192.168.0.30:5656 |
Package Name | 설치된 Package의 이름 | package_v.4.0.1 |
Home Path | 설치된 경로 | /home/interp/mach_active1 |
Desired State | Coordinator가 지시한 Node의 State | active |
Actual State | Node의 실제 State | active |
Coordinator Host | 담당 Coordinator 이름 | 192.168.0.33:23110 |
Last Response Time | 현재 시각 - 마지막 응답 시각 | 0.751330 secs |
Last Modify Time | 현재 시각 - 마지막으로 Cluster 정보가 변경된 시각 | 3 mins, 58.827882 secs |
Last Response Elapsed | 최근에 Node로부터 응답을 받기까지 기다린 시간 | 1.006743 secs |
Package 정보 패널
Coordinator의 경우, 오른쪽 패널에 Package 목록이 나타난다.
- Package Name : 패키지 이름
- Property
- File Name : 패키지 파일 이름
- File Size : 입력 당시 패키지 크기
- Stat FileSize : 현재 패키지 크기
Command-line
Coordinator 가 설치된 서버로 접속해서, machcoordinatoradmin --cluster-status
명령을 입력한다.
+-------------+-----------------+-----------------+-----------------+---------------------------+-------------+
| Node Type | Node Name | Active | Standby | Desired & Actual State | RP State |
+-------------+-----------------+-----------------+-----------------+---------------------------+-------------+
| coordinator | localhost:23110 | | | coordinator | coordinator | ----------- |
| coordinator | localhost:23120 | | | coordinator | coordinator | ----------- |
| deployer | localhost:23210 | | | deployer | deployer | ----------- |
| deployer | localhost:23220 | | | deployer | deployer | ----------- |
| broker | localhost:23310 | | | leader | leader | ----------- |
| warehouse | localhost:23410 | | | active | active | running |
| warehouse | localhost:23420 | | | active | active | running |
+-------------+-----------------+-----------------+-----------------+---------------------------+-------------+