25.5.5 ndb_mgm — The NDB Cluster Management Client

25.5.5 ndb_mgm — The NDB Cluster Management Client

ndb_mgm management client 프로세스는 실제로 클러스터를 실행하는 데 필수는 아닙니다. 이 client의 가치는 클러스터 상태를 확인하고, 백업을 시작하며, 기타 다른 관리 기능을 수행하기 위한 명령 집합을 제공하는 데 있습니다. management client는 C API를 사용하여 management server에 접근합니다. 고급 사용자는 이 API를 사용하여 ndb_mgm이 수행하는 작업과 유사한 작업을 수행하는 전용 management 프로세스를 프로그래밍할 수도 있습니다.

management client를 시작하려면 management server의 호스트 이름과 포트 번호를 제공해야 합니다:

1$> ndb_mgm [host_name [port_num]]

예시는 다음과 같습니다:

1$> ndb_mgm ndb_mgmd.mysql.com 1186

기본 호스트 이름과 포트 번호는 각각 localhost와 1186입니다.

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

• --backup-password-from-stdin[=TRUE|FALSE]

Property	Value
Command-Line Format	--backup-password-from-stdin

이 옵션은 --execute "START BACKUP" 또는 유사한 것을 사용하여 백업을 생성할 때 시스템 셸(stdin)에서 백업 비밀번호를 입력할 수 있게 합니다. 이 옵션을 사용하려면 --execute도 함께 사용해야 합니다.

• --character-sets-dir

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

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

• --connect-retries=#

Property	Value
Command-Line Format	--connect-retries=#
Type	Numeric
Default Value	3
Minimum Value	0
Maximum Value	4294967295

이 옵션은 첫 번째 시도 이후에 연결을 포기하기 전에 연결을 재시도하는 횟수를 지정합니다 (client는 항상 최소 한 번은 연결을 시도합니다). 시도당 대기 시간은 --connect-retry-delay를 사용하여 설정합니다.

이 옵션은 현재 사용 중단(deprecated)된 --try-reconnect 옵션과 동의어입니다.

• --connect-retry-delay

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

management server에 접속을 시도하는 각 시도 사이에 대기할 초 단위 시간입니다.

• --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]

global 파일이 읽힌 후 지정된 파일을 읽습니다.

• --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)로 된 그룹도 함께 읽습니다.

• --encrypt-backup

Property	Value
Command-Line Format	--encrypt-backup

이 옵션을 사용하면 모든 백업이 암호화됩니다. ndb_mgm을 실행할 때마다 이를 적용하려면 my.cnf 파일의 [ndb_mgm] 섹션에 이 옵션을 추가합니다.

• --execute=command, -e command

Property	Value
Command-Line Format	--execute=command

이 옵션은 시스템 셸에서 NDB Cluster management client로 명령을 전송하는 데 사용할 수 있습니다. 예를 들어, 다음 두 가지는 management client에서 SHOW를 실행하는 것과 동일합니다:

1$> ndb_mgm -e "SHOW"
2
3$> ndb_mgm --execute="SHOW"

이는 --execute 또는 -e 옵션이 mysql 커맨드라인 client에서 동작하는 방식과 유사합니다. Section 6.2.2.1, “Using Options on the Command Line”을 참조하십시오.

참고

이 옵션을 사용하여 전달할 management client 명령에 공백 문자가 포함되어 있는 경우, 해당 명령은 반드시 큰따옴표나 작은따옴표로 둘러싸야 합니다. 큰따옴표나 작은따옴표 중 어느 것이든 사용할 수 있습니다. management client 명령에 공백 문자가 포함되어 있지 않다면 따옴표는 선택 사항입니다.

• --help

Property	Value
Command-Line Format	--help

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

• --login-path

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

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

• --no-login-paths

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

login path 파일에서 옵션을 읽는 것을 건너뜁니다.

• --ndb-connectstring

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

ndb_mgmd에 연결하기 위한 connect string을 설정합니다. 구문: [nodeid=id;][host=]hostname[:port]. NDB_CONNECTSTRING 및 my.cnf의 항목을 오버라이드합니다.

• --ndb-nodeid

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

이 노드에 대한 노드 ID를 설정하며, --ndb-connectstring에 의해 설정된 ID를 오버라이드합니다.

• --ndb-mgm-tls

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

management server에 연결하는 데 필요한 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-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 시스템에서는 세미콜론 문자(;)를 구분자로 사용합니다. 디렉터리 참조는 상대 또는 절대 경로일 수 있습니다; 하나 이상의 환경 변수를 포함할 수 있으며, 각 변수는 접두사 dollar sign($)로 표시되고 사용 전에 확장됩니다.

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

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

• --no-defaults

Property	Value
Command-Line Format	--no-defaults

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

• --print-defaults

Property	Value
Command-Line Format	--print-defaults

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

• --test-tls

Property	Value
Command-Line Format	--test-tls

TLS를 사용하여 연결한 다음 종료합니다. 성공 시 출력은 다음과 유사합니다:

1>$ ndb_mgm --test-tls
2Connected to Management Server at: sakila:1186
3>$

자세한 내용은 Section 25.6.19.5, “TLS Link Encryption for NDB Cluster”를 참조하십시오.

• --try-reconnect=number

Property	Value
Command-Line Format	--try-reconnect=#
Deprecated	Yes
Type	Numeric
Type	Integer
Default Value	12
Default Value	3
Minimum Value	0
Maximum Value	4294967295

management server와의 연결이 끊어지면, 노드는 성공할 때까지 5초마다 다시 연결을 시도합니다. 이 옵션을 사용하면 포기하고 에러를 보고하기 전에 재시도 횟수를 _number_로 제한할 수 있습니다.

이 옵션은 사용 중단(deprecated)되었으며 향후 릴리스에서 제거될 수 있습니다. 대신 --connect-retries를 사용하십시오.

• --usage

Property	Value
Command-Line Format	--usage

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

• --version

Property	Value
Command-Line Format	--version

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

ndb_mgm 사용에 대한 추가 정보는 Section 25.6.1, “Commands in the NDB Cluster Management Client”에서 확인할 수 있습니다.