Coordinator 운영 방법


추가

Web Admin

화면 왼쪽의 'Install' 메뉴를 통해 Coordinator 를 생성할 수 있다.

Command-line

  1. Coordinator 가 설치될 서버로 직접 접속해서 압축을 푼다.
  2. conf/machbase.conf.sampleconf/machbase.conf 로 복사한다.
  3. 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
    
  4. 설치 경로를 $MACHBASE_COORDINATOR_HOME 로 설정한다.
  5. $MACHBASE_COORDINATOR_HOME/bin$PATH 에 인식하도록 설정한다.
  6. machcoordinatoradmin -c 를 통해 메타 정보를 생성한다.
  7. 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

  1. Coordinator 가 설치된 서버로 접속한다.
  2. machcoordinatoradmin -s 를 통해 Coordinator 프로세스를 정상 종료시킨다.
  3. 해당 Coordinator 디렉토리를 삭제한다.

업그레이드

Coordinator는 Node 관리를 담당하므로, Node 관리를 하지 않아도 되는 상황이라면 데이터 서비스를 중단시키지 않아도 Coordinator에 대한 업그레이드가 가능하다.

Web Admin

현재는 Node 업그레이드 기능이 존재하지 않는다.

Command-line

  1. Coordinator 가 설치된 서버로 접속한다.
  2. machcoordinatoradmin -s 를 통해 Coordinator 프로세스를 정상 종료시킨다.
  3. 준비한 패키지를 Coordinator가 설치된 경로로 압축을 푼다.
  4. machcoordinatoradmin -u 를 통해 Coordinator 프로세스를 구시킨다.

Meta 생성/삭제

Meta 정보가 정상적이지 않을 때 등의 문제로 인해, Meta를 직접 제어해야 할 경우에 한해서 사용할 수 있다.

Web Admin

Web Admin 에서는 Meta 생성/삭제를 할 수 없다. 대신, Coordinator를 추가하면서 자동으로 Meta를 생성한다.

Command-line

  1. Coordinator 가 설치된 서버로 접속한다.
  2. 다음 중 하나를 수행한다.
    1. Meta를 생성하려면 machcoordinatoradmin -c
    2. Meta를 삭제하려면 machcoordinatoradmin -d

구동/종료/중단

추가 또는 업그레이드의 이유로 Coordinator를 별도로 구동/종료/중단시키는 경우에 한해서 사용할 수 있다.

Web Admin

Web Admin 에서는, Coordinator의 구동/종료/중단을 할 수 없다.

Command-line

  1. Coordinator 가 설치된 서버로 접속한다.
  2. 다음 중 하나를 수행한다.
    1. 프로세스를 구동하려면 machcoordinatoradmin -u
    2. 프로세스를 종료하려면 machcoordinatoradmin -s
    3. 프로세스를 중단시키려면 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     |
+-------------+-----------------+-----------------+-----------------+---------------------------+-------------+

results matching ""

    No results matching ""