25.5.31 ndb_waiter — Wait for NDB Cluster to Reach a Given Status

25.5.31 ndb_waiter — NDB Cluster가 지정된 상태에 도달할 때까지 대기

ndb_waiter는 (각 100밀리초마다) 클러스터 데이터 노드의 상태를 반복해서 출력하다가, 클러스터가 지정된 상태에 도달하거나 --timeout 한도를 초과하면 종료합니다.

기본적으로는 클러스터의 모든 노드가 시작되어 클러스터에 연결된 STARTED 상태에 도달할 때까지 대기합니다. 이 동작은 --no-contact 및 --not-started 옵션을 사용하여 변경할 수 있습니다.

이 유틸리티가 보고하는 노드 상태는 다음과 같습니다:

• NO_CONTACT: 노드에 접속할 수 없습니다.

• UNKNOWN: 노드에 접속할 수 있지만 그 상태는 아직 알 수 없습니다. 일반적으로 이는 노드가 관리 서버로부터 START 또는 RESTART 명령을 받았지만, 아직 해당 명령을 수행하지 않은 경우를 의미합니다.

• NOT_STARTED: 노드는 정지되어 있지만 여전히 클러스터와의 접속은 유지하고 있습니다. 이는 관리 클라이언트의 RESTART 명령을 사용하여 노드를 재시작할 때 볼 수 있습니다.

• STARTING: 노드의 ndbd 프로세스는 시작되었지만, 노드가 아직 클러스터에 참여하지 않은 상태입니다.

• STARTED: 노드는 동작 중이며, 클러스터에 참여한 상태입니다.

• SHUTTING_DOWN: 노드가 종료 중입니다.

• SINGLE USER MODE: 클러스터가 단일 사용자 모드일 때 모든 클러스터 데이터 노드에 대해 이 상태가 표시됩니다.

ndb_waiter와 함께 사용할 수 있는 옵션은 다음 표에 나와 있습니다. 표 뒤에 추가 설명이 이어집니다.

Usage

1ndb_waiter [-c connection_string]

Additional Options

• --character-sets-dir

Property	Value
Command-Line Format	--character-sets-dir=path

문자 집합이 포함된 디렉터리입니다.

• --connect-retries

Property	Value
Command-Line Format	--connect-retries=#
Type	Integer
Default Value	12
Minimum Value	0
Maximum Value	12

포기하기 전에 연결을 재시도하는 횟수입니다.

• --connect-retry-delay

Property	Value
Command-Line Format	--connect-retry-delay=#
Type	Integer
Default Value	5
Minimum Value	0
Maximum Value	5

관리 서버에 접속을 시도하는 사이에 대기할 초 수입니다.

• --connect-string

Property	Value
Command-Line Format	--connect-string=connection_string
Type	String
Default Value	[none]

--ndb-connectstring와 동일합니다.

• --core-file

Property	Value
Command-Line Format	--core-file

에러 발생 시 코어 파일을 기록합니다. 디버깅에 사용됩니다.

• --defaults-extra-file

Property	Value
Command-Line Format	--defaults-extra-file=path
Type	String
Default Value	[none]

글로벌 파일들이 읽힌 후에 지정된 파일을 읽습니다.

• --defaults-file

Property	Value
Command-Line Format	--defaults-file=path
Type	String
Default Value	[none]

지정된 파일에서만 기본 옵션을 읽습니다.

• --defaults-group-suffix

Property	Value
Command-Line Format	--defaults-group-suffix=string
Type	String
Default Value	[none]

concat(group, suffix)에 해당하는 그룹도 함께 읽습니다.

• --login-path

Property	Value
Command-Line Format	--login-path=path
Type	String
Default Value	[none]

로그인 파일에서 지정된 경로를 읽습니다.

• --no-login-paths

Property	Value
Command-Line Format	--no-login-paths

로그인 경로 파일에서 옵션을 읽는 것을 건너뜁니다.

• --help

Property	Value
Command-Line Format	--help

도움말 텍스트를 표시하고 종료합니다.

• --ndb-connectstring

Property	Value
Command-Line Format	--ndb-connectstring=connection_string
Type	String
Default Value	[none]

ndb_mgmd에 연결하기 위한 연결 문자열을 설정합니다. 구문: [nodeid=id;][host=]hostname[:port].
NDB_CONNECTSTRING 및 my.cnf에 설정된 항목을 재정의합니다.

• --ndb-mgm-tls

Property	Value
Command-Line Format	--ndb-mgm-tls=level
Type	Enumeration
Default Value	relaxed
Valid Values	relaxed<br>strict

관리 서버에 연결하기 위해 요구되는 TLS 지원 수준을 설정합니다. relaxed 또는 strict 중 하나입니다.
기본값인 relaxed는 TLS 연결을 시도하지만 성공을 필수로 요구하지 않는다는 의미입니다. strict는 연결에 TLS가 필요함을 의미합니다.

• --ndb-mgmd-host

Property	Value
Command-Line Format	--ndb-mgmd-host=connection_string
Type	String
Default Value	[none]

ndb-connectstring와 동일합니다.

• --ndb-nodeid

Property	Value
Command-Line Format	--ndb-nodeid=#
Type	Integer
Default Value	[none]

이 노드의 노드 ID를 설정하며, --ndb-connectstring에 의해 설정된 ID를 재정의합니다.

• --ndb-optimized-node-selection

Property	Value
Command-Line Format	--ndb-optimized-node-selection

트랜잭션을 위한 노드 선택 최적화를 활성화합니다.
기본적으로 활성화되어 있으며, 비활성화하려면 --skip-ndb-optimized-node-selection을 사용합니다.

• --ndb-tls-search-path

Property	Value
Command-Line Format	--ndb-tls-search-path=list
Type	Path name
Default Value (Unix)	$HOME/ndb-tls
Default Value (Windows)	$HOMEDIR/ndb-tls

CA 파일을 검색할 디렉터리 목록을 지정합니다.
Unix 플랫폼에서는 디렉터리 이름을 콜론(:)으로 구분하고, Windows 시스템에서는 세미콜론 문자(;)를 구분자로 사용합니다. 디렉터리 참조는 상대 또는 절대일 수 있으며, 각각은 앞에 달러 기호($)를 붙여 표시되는 하나 이상의 환경 변수를 포함할 수 있고, 사용 전에 확장됩니다.

검색은 가장 왼쪽에 있는 디렉터리부터 시작하여 파일이 발견될 때까지 왼쪽에서 오른쪽으로 진행됩니다. 빈 문자열은 빈 검색 경로를 나타내며, 이 경우 모든 검색이 실패합니다. 점 하나만으로 이루어진 문자열(.)은 검색 경로가 현재 작업 디렉터리로 제한됨을 나타냅니다.

검색 경로가 제공되지 않으면 컴파일 시에 지정된 기본값이 사용됩니다. 이 값은 사용하는 플랫폼에 따라 달라집니다. Windows에서는 \ndb-tls이고, 다른 플랫폼(Linux 포함)에서는 $HOME/ndb-tls입니다. 이는 -DWITH_NDB_TLS_SEARCH_PATH를 사용하여 NDB Cluster를 컴파일함으로써 재정의할 수 있습니다.

• --no-contact, -n

STARTED 상태를 기다리는 대신, ndb_waiter는 클러스터가 NO_CONTACT 상태에 도달할 때까지 계속 실행하다가 종료합니다.

• --no-defaults

Property	Value
Command-Line Format	--no-defaults

로그인 파일 이외의 어떤 옵션 파일에서도 기본 옵션을 읽지 않습니다.

• --not-started

STARTED 상태를 기다리는 대신, ndb_waiter는 클러스터가 NOT_STARTED 상태에 도달할 때까지 계속 실행하다가 종료합니다.

• --nowait-nodes=list

이 옵션을 사용하면, ndb_waiter는 ID가 나열된 노드에 대해서는 대기하지 않습니다. 목록은 콤마로 구분되며, 다음 예와 같이 대시는 범위를 나타내는 데 사용할 수 있습니다:

1$> ndb_waiter --nowait-nodes=1,3,7-9

주의

--wait-nodes 옵션과 함께 이 옵션을 사용하지 마십시오.

• --print-defaults

Property	Value
Command-Line Format	--print-defaults

프로그램 인자 목록을 출력하고 종료합니다.

• --timeout=seconds, -t seconds

대기 시간입니다. 원하는 상태가 이 초 수 내에 달성되지 않으면 프로그램은 종료합니다. 기본값은 120초(1200 보고 주기)입니다.

• --single-user

프로그램이 클러스터가 단일 사용자 모드에 진입할 때까지 대기하도록 합니다.

• --usage

Property	Value
Command-Line Format	--usage

도움말 텍스트를 표시하고 종료합니다; --help와 동일합니다.

• --verbose

Property	Value
Command-Line Format	--verbose=#
Type	Integer
Default Value	2
Minimum Value	0
Maximum Value	2

출력의 상세 수준을 제어합니다. 가능한 수준과 그 효과는 다음과 같습니다:

• 0: 출력하지 않습니다(종료 코드만 반환합니다; 종료 코드에 대해서는 다음을 참조하십시오).

• 1: 최종 연결 상태만 출력합니다.

• 2: 상태가 확인될 때마다 출력합니다.
  이는 NDB Cluster 8.4 이전 버전의 동작과 동일합니다.

ndb_waiter가 반환하는 종료 코드와 그 의미는 다음과 같습니다:

• 0: 성공.

• 1: 대기 시간 초과.

• 2: 잘못된 노드 ID와 같은 매개변수 에러.

• 3: 관리 서버에 연결 실패.

• --version

Property	Value
Command-Line Format	--version

버전 정보를 표시하고 종료합니다.

• --wait-nodes=list, -w list

이 옵션을 사용하면, ndb_waiter는 ID가 나열된 노드에 대해서만 대기합니다. 목록은 콤마로 구분되며, 다음 예와 같이 대시는 범위를 나타내는 데 사용할 수 있습니다:

1$> ndb_waiter --wait-nodes=2,4-6,10

주의

--nowait-nodes 옵션과 함께 이 옵션을 사용하지 마십시오.

Sample Output.

다음은 4노드 클러스터에서 두 개의 노드를 종료한 후 수동으로 다시 시작했을 때 ndb_waiter를 실행한 결과입니다. 중복된 보고( ... 로 표시됨)는 생략되었습니다.

1$> ./ndb_waiter -c localhost
2
3Connecting to mgmsrv at (localhost)
4State node 1 STARTED
5State node 2 NO_CONTACT
6State node 3 STARTED
7State node 4 NO_CONTACT
8Waiting for cluster enter state STARTED
9
10...
11
12State node 1 STARTED
13State node 2 UNKNOWN
14State node 3 STARTED
15State node 4 NO_CONTACT
16Waiting for cluster enter state STARTED
17
18...
19
20State node 1 STARTED
21State node 2 STARTING
22State node 3 STARTED
23State node 4 NO_CONTACT
24Waiting for cluster enter state STARTED
25
26...
27
28State node 1 STARTED
29State node 2 STARTING
30State node 3 STARTED
31State node 4 UNKNOWN
32Waiting for cluster enter state STARTED
33
34...
35
36State node 1 STARTED
37State node 2 STARTING
38State node 3 STARTED
39State node 4 STARTING
40Waiting for cluster enter state STARTED
41
42...
43
44State node 1 STARTED
45State node 2 STARTED
46State node 3 STARTED
47State node 4 STARTING
48Waiting for cluster enter state STARTED
49
50...
51
52State node 1 STARTED
53State node 2 STARTED
54State node 3 STARTED
55State node 4 STARTED
56Waiting for cluster enter state STARTED

참고

연결 문자열을 지정하지 않으면 ndb_waiter는 localhost에 있는 관리 서버에 연결을 시도하며, Connecting to mgmsrv at (null)을 보고합니다.