glocator 소개

정의

glocator는 GOLDILOCKS cluster system에서 client에게 location을 제공하고 관리하는 유틸리티이다.
glocator 프로그램은 gloctl을 통해 cluster member 노드들의 location 정보를 제공받는다.
glocator는 client, gloctl와 UDP 통신을 하고 gagent와는 TCP 통신을 한다.

사용법

glocator [options]

Option

help

설명

Help 메시지를 출력한다.

사용 예

$ glocator --help

Usage:
 glocator [options]

Options:

-c  --create       Create glocator environment
-s  --start        Start glocator
-t  --stop         Stop glocator
-f  --conf         Set configure file
-u  --status       Get glocator status
-y  --sync         Synchronize with alternate glocator(BOTH, SOURCE)
-l  --silent       Suppress display message
-r  --no-copyright Suppress display copy right and version
-h  --help         Print help message

create

설명

glocator의 데이터 파일을 생성한다.

사용 예

$ glocator --create

glocator is created.

$ ls
README  glocator.dat  system_data.dbf  system_dict.dbf  system_undo.dbf

start

설명

glocator를 구동한다. 같은 port를 갖는 glocator가 이미 구동 중이라면 에러가 발생한다.

사용 예

$ glocator --start

glocator is started.

stop

설명

구동 중인 glocator를 정지시킨다. 구동 중인 glocator를 멈추려면 같은 port가 설정되어야 한다.

사용 예

$ glocator --stop

glocator is stopped.

conf

설명

glocator를 구동할 때 configure file을 설정한다.

사용 예

$ glocator --start --conf goldilocks.glocator.conf

glocator is started.

status

설명

구동 중인 glocator의 상태 메시지를 출력한다. 구동 중인 glocator 상태를 확인하려면 같은 port가 설정 되어야 한다.

사용 예

$ glocator --status

Process ID: 26058
Configuration file: goldilocks.glocator.conf
Unix domain path: /tmp/unix-glocator.42581
Udp listen host: 0.0.0.0, Port: 42581
glocator is running.

sync

설명

glocator를 구동하기 전에 ALTERNATE_LOCATORS에 설정된 glocator와 데이터를 동기화한다.

데이터 동기화에는 ALTERNATE_LOCATORS에서 데이터를 가지고 오는 SOURCE 방식과 두 glocator를 병합하는 BOTH 방식이 있다.

사용 예

다음은 sync 옵션을 SOURCE 타입으로 사용하여 성공하는 예이다.

$ glocator --start --sync SOURCE

glocator is started.

다음은 sync 옵션에 실패하는 예이다. configure 파일에 ALTERNATE_LOCATORS 속성 값이 설정되지 않았다.

$ glocator --start --sync SOURCE

ERR-HY000(60016): Need more alternate locator host information.

다음은 sync 옵션에 실패하는 예이다. ALTERNATE_LOCATORS에 설정된 glocator로부터 응답을 받지 못한 상황이다.

$ glocator --start --sync SOURCE

ERR-HY000(60016): Need more alternate locator host information.

다음은 sync 옵션에 인자가 주어지지 않았을 때 실패하는 예이다.

$ glocator --start --sync

ERR-HY000(11000): Invalid argument

silent

설명

실행에 대한 glocator의 메시지를 출력하지 않는다.

사용 예

$ glocator --start --silent

no-copyright

설명

실행에 대한 glocator의 copy right와 버전 메시지를 출력하지 않는다.

사용 예

$ glocator --start --no-copyright

glocator is started.

glocator 사용

데이터 파일

glocator를 구동하려면 시작하기 전에 glocator 데이터 파일을 먼저 생성해야 한다.

$ glocator --create

glocator is created.

glocator 데이터 파일이 저장되는 디렉토리는 configuration LOCATION_FILE_DIR을 수정하여 변경할 수 있다. 기본값은 <GOLDILOCKS_DATA>/db에 생성된다. 데이터 파일은 LOCATION_FILE_NAME 을 수정하여 변경할 수 있다. 기본값은 glocator.dat이다.

glocator 데이터 파일의 최대 크기와 초기 크기는 configuration LOCATION_FILE_MAX_SIZE와 LOCATION_FILE_SIZE를 수정하여 변경할 수 있다.

CSTARTUP과 CSHUTDOWN

glocator는 GOLDILOCKS 서버의 CSTARTUP과 CSHUTDOWN에 사용될 수 있다.
이를 위해서는 glocator가 구동 중이고 gsqlnet을 통해 CSTARTUP 또는 CSHUTDOWN 명령을 실행해야 한다.
다만, gsqlnet을 실행하는 장비의 odbc.ini에 LOCATOR_DSN과 속성값이 설정되어 있어야 한다.  
자세한 내용은 GOLDILOCKS UNIX ODBC driver 라이브러리를 참조한다.

다음은 glocator를 사용하기 위해 odbc.ini에 설정한 내용이다.

[GOLDILOCKS]
HOST=127.0.0.1
PORT=20101
UID=sys
PWD=gliese
LOCATOR_DSN=GLOCATOR

[GLOCATOR]
HOST=127.0.0.1
PORT=42581

CSTARTUP과 CSHUTDOWN 명령을 실행하려면 glocator가 member 노드들에 대한 location 정보를 알고 있어야 한다.

다중화

개요

glocator 다중화는 데이터를 일관성있게 유지하여 장애가 발생할 경우 원격 glocator를 사용한 지속적인 서비스를 가능하게 한다.

설정

다중화를 사용하기 위해 각각의 glocator는 configure file에 ALTERNATE_LOCATORS 속성을 설정해야 한다. ALTERNATE_LOCATORS 속성에는 Locator_name이 설정되어야 하고 설정된 Locator_name은 HOST, PORT 속성과 함께 configure 파일에 기록되어야 한다.

ALTERNATE_LOCATORS 속성은 다음과 같이 설정할 수 있다.

[LOCATOR]
ALTERNATE_LOCATORS = (locator_name1,locator_name2)
[locator_name1]
HOST= ip_address
PORT = port_num
[locator_name2]
HOST= ip_address
PORT = port_num

다음은 ALTERNATE_LOCATORS 속성을 설정하는 configure 파일의 예이다.

[LOCATOR]
PORT=42581
SYNC_RESPONSE_TIMEOUT = 2
SYNC_RETRY_COUNT = 2
LOCATION_FILE_NAME='glocator_1.dat'
ALTERNATE_LOCATORS=(LOCATOR_2,LOCATOR_3)

[LOCATOR_2]
HOST=127.0.0.1
PORT=42582

[LOCATOR_3]
HOST=127.0.0.1
PORT=42583

데이터 동기화

다중화된 glocator를 서비스할 때 데이터는 일관되게 유지되어야 한다. 기존에 작동 중인 glocator가 없을 경우, 모든 glocator는 일반 시작을 하면 된다. 기존에 동작 중인 glocator가 있을 경우, sync 옵션을 사용하여 데이터를 동기화하는 방법으로 alternate glocator를 시작할 수 있다.

sync 옵션에는 glocator 자신의 데이터와 alternate glocator의 데이터를 병합하는 BOTH와 상대 glocator로부터 데이터를 가지고 오는 SOURCE가 있다. glocator의 sync 작업은 glocator와 alternate glocator 사이의 1 : 1 대응 작업이다. 따라서 A, B, C 세 개의 glocator를 다중화하려고 할 때 A와 B가 이미 구동 중이고 C를 BOTH 방식으로 sync하여 구동하면 A 또는 B glocator의 데이터가 서로 다를 수 있다.

서비스 중인 glocator는 변경된 내용만 동기화한다. 패킷 손실 등의 이유로 데이터 동기화에 실패하는 경우 데이터가 서로 다를 수 있다. 이 경우, gloctl 프로그램을 사용하여 해당 glocator에서 직접 데이터를 수정하거나 glocator를 sync 옵션으로 다시 시작할 수 있다.

기능

Connection Service

Cluster 환경에서 특정 노드에 대한 location 정보를 알지 못해도 사용자가 정한 몇 개의 노드 중에 임의로 접속할 수 있도록 service 기능을 제공한다.

Service 기능은 glocator에서 관리하는 노드를 사용자가 임의의 그룹으로 지정하는 것이다. 이 service는 gloctl 프로그램을 사용하여 등록할 수 있다. glocator에서 관리하는 서비스 목록 역시 gloctl 프로그램을 사용하여 확인할 수 있다.

응용 프로그램은 ODBC 드라이버를 사용하여 접속해야 하며 odbc.ini 파일에 LOCATOR_DSN과 LOCATOR_SERVICE 속성을 지정해야 한다.

위 그림은 응용 프로그램 (application)이 service s3에 속한 g1n1에 접속한 내용이다. ODBC 드라이버가 service를 이용하여 연결하는 순서는 service에 등록된 노드 순서와 동일하다. 위의 예에서 ODBC 드라이버가 g1n1에 연결하는데 실패하면 다음 순서인 노드 g2n1에 연결을 시도할 것이다.

Cluster Failover

glocator는 server가 failover를 진행할 때 도움이 된다.

Server 프로퍼티 CLUSTER_SPLIT_BRAIN_RESOLUTION_POLICY 값이 1 또는 2로 설정되고, cluster 환경에서 노드 간에 연결이 끊어져 failover가 발생하면 각 노드는 cluster failover를 진행하여 gagent를 통해 glocator에게 자신의 viability를 질의한다.

질의를 받은 glocator는 연결이 끊어진 두 노드의 viability를 판단하고 질의를 한 gagent에 결과를 전달한다.

Viabilty 결과를 받은 노드는 종료되거나 failover를 진행한다.

glocator Configuration

Configuration File 및 환경 변수

glocator는 configuration을 설정하기 위해 file 또는 환경 변수를 사용할 수 있다.

환경 변수는 configuration property name에 prefix로 'LOCATOR_'를 추가한 name을 사용하여 지정할 수 있다. 예를 들어 configuration file에 HOST를 설정하면 $LOCATOR_HOST를 지정하는 것과 같은 효과가 있다.

Configuration file 내용은 환경 변수 설정값보다 우선한다.

glocator는 DSN을 [LOCATOR] 기본값으로 하여 configuration file을 읽는다.

glocator는 $GOLDILOCKS_DATA/conf/goldilocks.glocator.conf 파일을 자신의 환경 파일로 가지고 있다. glocator의 구동 환경을 변경하려면 해당 파일의 내용을 변경하거나 환경 변수를 설정하고 glocator를 구동하면 된다.

Configuration Property

HOST

glocator가 UDP 통신을 위해 bind하는 IP address이다. 
IP v4 형식의 IP address를 사용한다.

PORT

glocator가 UDP 통신으로 packet을 받는 port이다. 
Port는 1024부터 49151까지 사용할 수 있다.

WORKER_COUNT

glocator가 client 또는 내부 프로세스로부터 받은 packet을 처리하는 thread의 개수이다.

MAX_NODE_COUNT

연결 가능한 gagent의 최대 개수이다.

MESSAGE_QUEUE_SIZE

glocator가 client나 내부 프로세스로부터 받은 packet을 처리하기 전에 저장하는 queue의 size이다.
Queue에는 packet이 message 단위의 단일 item으로 저장된다.

MESSAGE_ALLOCATOR_SIZE

Message queue에 저장되는 item (message)을 할당할 때 사용되는 allocator의 size이다.

PACKET_ALLOCATOR_SIZE

glocator가 packet을 받기 위해 할당하는 buffer를 위한 allocator의 size이다.

SYSTEM_LOGGER_DIR

glocator의 system trace log file이 저장되는 directory path이다. 기본값의 <GOLDILOCKS_DATA>는 $GOLDILOCKS_DATA 환경 변수 값으로 대체된다.

SYSTEM_UDS_DIR

glocator에서 사용되는 unix domain socket 파일이 저장되는 directory path를 설정한다. Directory 최대 길이는 60 byte 이내로 설정해야 한다.

LOCATION_FILE_DIR

glocator에서 사용되는 location 파일이 저장되는 directory path를 설정한다.

LOCATION_FILE_NAME

glocator에서 사용되는 location 파일 이름을 설정한다. 
기본값은 glocator.dat 이다.

LOCATION_FILE_SIZE

glocator에서 사용되는 location 파일의 초기 size를 설정한다.

LOCATION_FILE_MAX_SIZE

glocator에서 사용되는 location 파일의 최대 size를 설정한다.

MESSAGE_TIMEOUT

glocator가 packet을 수신하기 위해 최대로 대기하는 시간 (초)을 설정한다. 처리되지 못하고 시간 초과된 packet은 버려진다.

ALTERNATE_LOCATORS

glocator의 다중화를 설정한다.

SYNC_RETRY_COUNT

glocator 동기화 작업의 재전달 횟수를 설정한다.

데이터가 변경되었을 때 glocator는 alternate locator에 변경된 데이터를 전달하는데, 데이터를 전달한 후에 응답을 받지 못하면 다시 전달한다.

SYNC_RESPONSE_TIMEOUT

glocator가 전달한 동기화 데이터에 대한 응답을 기다리는 시간을 설정한다.

KEEPALIVE_IDLE_TIME

Keep alive packet을 송신하기 전에 TCP 패킷이 송수신 되지 않는 상태로 지속되는 시간 (idle) 이다. 즉, KEEPALIVE_IDLE_TIME에 설정된 초 동안 TCP 패킷 교환이 이루어지지 않으면 dead connection을 감지하기 위해 keep alive mechanism을 수행한다.

KEEPALIVE_COUNT

Keep alive mechanism을 수행하는 횟수이다.

KEEPALIVE_INTERVAL

Keep alive 패킷을 전송하는 시간 간격이다.