데브러너 (DevRunner)

25.4.3 NDB Cluster Configuration Files

25.4.3.1 NDB Cluster Configuration: Basic Example 25.4.3.2 Recommended Starting Configuration for NDB Cluster 25.4.3.3 NDB Cluster Connection Strings 25.4.3.4 Defining Computers in an NDB Cluster 25.4.3.5 Defining an NDB Cluster Management Server 25.4.3.6 Defining NDB Cluster Data Nodes 25.4.3.7 Defining SQL and Other API Nodes in an NDB Cluster 25.4.3.8 Defining the System 25.4.3.9 MySQL Server Options and Variables for NDB Cluster 25.4.3.10 NDB Cluster TCP/IP Connections 25.4.3.11 NDB Cluster TCP/IP Connections Using Direct Connections 25.4.3.12 NDB Cluster Shared-Memory Connections 25.4.3.13 Data Node Memory Management 25.4.3.14 Configuring NDB Cluster Send Buffer Parameters

NDB Cluster를 구성하려면 두 개의 파일을 다루어야 합니다:

my.cnf: 모든 NDB Cluster 실행 파일에 대한 옵션을 지정합니다. 이 파일은, MySQL로 작업한 이전 경험에서 이미 익숙해야 하는 파일이며, 클러스터에서 실행 중인 각 실행 파일이 접근할 수 있어야 합니다.
config.ini: 이 파일은 때때로 전역 설정 파일이라고도 하며, 오직 NDB Cluster 관리 서버만이 읽고, 그 후 클러스터에 참여하는 모든 프로세스에 그 안에 포함된 정보를 배포합니다. config.ini에는 클러스터에 관여하는 각 노드에 대한 설명이 들어 있습니다. 여기에는 데이터 노드에 대한 설정 파라미터와, 클러스터의 모든 노드 간 연결에 대한 설정 파라미터가 포함됩니다. 이 파일에 나타날 수 있는 섹션과, 각 섹션에 어떤 종류의 설정 파라미터를 배치할 수 있는지에 대한 간단한 참조는 Sections of the config.ini File를 참조하십시오.

configuration data의 캐싱. NDB는 상태 유지 설정을 사용합니다. 관리 서버를 재시작할 때마다 전역 설정 파일을 읽는 대신, 관리 서버는 처음 시작될 때 설정을 캐시에 저장하고, 그 이후에는 다음 조건 중 하나가 참일 때만 전역 설정 파일을 읽습니다:

관리 서버가 --initial 옵션을 사용하여 시작되는 경우. --initial이 사용되면, 전역 설정 파일이 다시 읽히고, 기존 캐시 파일이 모두 삭제되며, 관리 서버가 새로운 설정 캐시를 생성합니다.
관리 서버가 --reload 옵션을 사용하여 시작되는 경우. --reload 옵션은 관리 서버가 자신의 캐시와 전역 설정 파일을 비교하도록 합니다. 둘이 다르면, 관리 서버는 새로운 설정 캐시를 생성하고, 기존 설정 캐시는 보존되지만 사용되지는 않습니다. 관리 서버의 캐시와 전역 설정 파일이 동일한 설정 데이터를 포함하는 경우, 기존 캐시가 사용되고 새로운 캐시는 생성되지 않습니다.
관리 서버가 --config-cache=FALSE를 사용하여 시작되는 경우. 이는 기본적으로 활성화되어 있는 --config-cache를 비활성화하며, 관리 서버가 설정 캐싱을 완전히 우회하도록 강제하는 데 사용할 수 있습니다. 이 경우 관리 서버는 존재할 수 있는 어떤 설정 파일도 무시하고, 항상 config.ini 파일에서 설정 데이터를 읽습니다.
설정 캐시가 발견되지 않는 경우. 이 경우 관리 서버는 전역 설정 파일을 읽고, 해당 파일에 있는 것과 동일한 설정 데이터를 포함하는 캐시를 생성합니다.

설정 캐시 파일. 관리 서버는 기본적으로 MySQL 설치 디렉터리에 있는 mysql-cluster라는 디렉터리에 설정 캐시 파일을 생성합니다. (유닉스 시스템에서 소스로부터 NDB Cluster를 빌드하는 경우, 기본 위치는 /usr/local/mysql-cluster입니다.) 이는 관리 서버를 --configdir 옵션과 함께 시작하여 런타임에 재정의할 수 있습니다. 설정 캐시 파일은 ndb_node_id_config.bin.seq_id 패턴에 따라 이름이 지정된 바이너리 파일입니다. 여기서 _node_id_는 클러스터에서 관리 서버의 노드 ID이고, _seq_id_는 캐시 식별자입니다. 캐시 파일은 생성된 순서대로 _seq_id_를 사용하여 순차적으로 번호가 매겨집니다. 관리 서버는 _seq_id_로 판단했을 때 가장 최신 캐시 파일을 사용합니다.

참고

나중에 생성된 설정 캐시 파일을 삭제하거나, 이전 캐시 파일의 이름을 더 높은 _seq_id_를 갖도록 변경함으로써 이전 설정으로 롤백하는 것이 가능합니다. 그러나 설정 캐시 파일은 바이너리 포맷으로 작성되므로, 그 내용을 수동으로 편집하려고 시도해서는 안 됩니다.

NDB Cluster 관리 서버에 대한 --configdir, --config-cache, --initial, 그리고 --reload 옵션에 대한 자세한 내용은 Section 25.5.4, “ndb_mgmd — The NDB Cluster Management Server Daemon”를 참조하십시오.

우리는 NDB Cluster 설정을 지속적으로 개선하고 이 과정을 단순화하려고 노력하고 있습니다. 하위 호환성을 유지하기 위해 노력하지만, 호환되지 않는 변경을 도입해야 할 때가 있을 수 있습니다.

이런 경우 해당 변경이 하위 호환되지 않다는 사실을 사전에 NDB Cluster 사용자에게 알리려고 합니다. 만약 그러한 변경을 발견했는데 우리가 이를 문서화하지 않았다면, Section 1.6, “How to Report Bugs or Problems”에 제시된 지침을 사용하여 MySQL 버그 데이터베이스에 보고해 주십시오.