Child pages
  • Modifying Startup Configuration Options

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Import Korean translation for sag76
Sv translation
languageen

As part of the ClustrixDB Installation process you made some configuration selections. Once you have completed installation please use the following directions to modify any of these options. 

The clxnode.conf is stored on each node in /etc/clustrix/ and options specified during installation are written to this file. The following table summarizes these options and provides information on how they can be modified post-installation.

Note

The steps outlined in this document apply to most installations of ClustrixDB, but do not apply to deployments based on the Clustrix AWS AMI.

Table of Contents

Note

ClustrixDB requires that all nodes have identical configurations. Modifications to any of the options described below must be made on every node in the cluster. Values commented out with a # will have no effect on the database.

Default Options for clxnode.conf

Use standard bash conventions for clxnode.conf. File should contain variable definitions, comments, and blank lines only. Option and value settings should not contain any extraneous spaces. For example CPU_CORES=4

OptionDescriptionDefault ValueTo Modify

NODE_MEMORY

Memory to use for ClustrixDB, in MiB

auto detected
  1. Edit the clxnode.conf file for every node in your cluster to the desired value.
  2. Run the following to propagate this change to all nodes:
    shell> /opt/clustrix/bin/clx -P cmd 'echo X > /proc/sys/vm/nr_hugepages'
    Where X = NODE_MEMORY/2
  3. Stop/Start all Clustrix services.

MAX_REDO

Maximum ClustrixDB Redo Space, in MiB

1024

Only modify this variable with guidance from Clustrix Support. 

CPU_CORES

Number of CPU cores ClustrixDB will use

All
  1. Edit the clxnode.conf file for every node in your cluster to the desired value.
  2. Stop/Start all Clustrix services.

For additional info, please see section below on setting CPU_CORES.

DATA_PATH

ClustrixDB Database Storage Path

/data/clustrix
  1. Stop all Clustrix services.
  2. On each node:
    1. Move the directory to the desired location.
    2. Modify the value of DATA_PATH in clxnode.conf to reflect the new location.
  3. Start all Clustrix services.
LOG_PATH

ClustrixDB Logs Path

/data/clustrix/log
  1. Stop all Clustrix services.
  2. On each node:
    1. Move the directory to the desired location.
    2. Create a simlink in `/data/clustrix/` pointing to the new log folder, 
      1. example: ln -s /log /data/clustrix/log/
  3. Start all Clustrix services.

UI_LOGDIR

ClustrixDB WebUI Logs Path/data/clustrix/log/clustrix_ui
  1. Stop all Clustrix services.
  2. On each node:
    1. Move the directory to the desired location.
    2. Create a simlink in `/data/clustrix/log` pointing to the new log folder, 
      1. example: ln -s /log/clustrix_ui /data/clustrix/log/clustrix_ui
  3. Start all Clustrix services.

UI_CACHEDIR

ClustrixDB WebUI Cache Path

/var/cache/clustrix/django

Only modify this variable with guidance from Clustrix Support. 

UNIX_SOCKET_PATH

ClustrixDB MySQL Protocol Unix Socket

/var/lib/mysql/mysql.sock

Only modify this variable with guidance from Clustrix Support. 

LISTEN_ADDR

ClustrixDB Database Listen Address (Front-End IP) Interface

0.0.0.0 

MYSQL_PORT

ClustrixDB Database MySQL Port

3306 

BACKEND_ADDR

ClustrixDB Private (Back-End) IP Interface

auto detected

See section below on changing BACKEND_ADDR.

BACKEND_PORT

ClustrixDB Back End Network Port

24378

It is not recommended to modify the default value for the ClustrixDB Back End Network port.

HTTP_PORT

ClustrixDB WebUI HTTP Port

80
  1. Edit value in clxnode.conf
  2. Stop/Start all Clustrix services.

NANNY_PORT

ClustrixDB Nanny Port

2424

It is not recommended to modify the default value for the ClustrixDB nanny port.

CONTROL_PORT

ClustrixDB Control Port

2048

It is not recommended to modify the default value for the ClustrixDB control port.

WRITE_HOSTS

Allow ClustrixDB to modify sshd_config and /etc/hosts.

This is required for internode communication for administrative tasks, including upgrades

#Commented out
  1. On each node: 
    1. Remove comment and set variable to any string.
    2. Stop/Start all Clustrix services.

HUGE_TLB_ENABLE

ClustrixDB Enable HugeTLB memory allocation for faster startup. NOTE: This causes instability on some systems (particularly certain virtual

machines).

Contact Clustrix Support before changing from default.

True
  1. On each node, comment out to disable this option. (i.e. #HUGE_TLB_ENABLE)
  2. Stop/Start all Clustrix services.

Anchor
Disable_Multiport
Disable_Multiport
Additional options for clxnode.conf

The following options are NOT included by default in clxnode.conf, but can be added to the end of that file to modify behavior from the default:

OptionDescriptionDefault ValueTo Modify

DISABLE_MULTIPORT

 

When this option is included, the multiport feature is disabled.

This option is not included in clxnode.conf, resulting in multiport being enabled by default.

To disable multiport, add this entry and define this variable as any value on all nodes. (Its mere presence disables multiport.)
To enable multiport, remove or comment out this entry from clxnode.conf on all nodes.

Tip

When adding capacity to your cluster, the Flex Clone script will ensure that any options specified in clxnode.conf are used to install Clustrix on the new nodes.

Details of Modifying Startup Configuration Options

Warning

ClustrixDB requires that all nodes must have the same values in clxnode.conf

Stop/Start all Clustrix Services

To restart all Clustrix services on all nodes (via nanny), use the following commands. This will restart nanny, and all jobs controlled by nanny, and cause the database to come online. See Overview of Nanny.

Code Block
/opt/clustrix/bin/clx cmd 'initctl stop clustrix'
/opt/clustrix/bin/clx cmd 'initctl start clustrix'

CPU_CORES

The default setting of CPU_CORES=All will make use of all available cores in the system. If you would like to limit the number of cores utilized by ClustrixDB you must modify the value for CPU_CORES to specify the number of cores that should be used. ClustrixDB licensing will base its enforcement on the number of cores being utilized in the system as specified by CPU_CORES. 

Note

If you are upgrading from v6.X, there may not be an entry for CPU_CORES in clxnode.conf which will implicitly specify CPU_CORES=All. If you would like to specify an alternate value simply add an entry for CPU_CORES.

BACKEND_ADDR

  1. Modify the BACKEND_ADDR entry in the `/etc/clustrix/clxnode.conf` file with the new IP
  2. Modify `/data/clustrix/broadcast_nodes` file with the new IP addresses on all nodes.
    1. Note: Specifying port 24378 is not necessary unless you're using a non-default configuration.
  3. Run the `clx` command to ensure it has cached the IP address of each node.

    Code Block
    languagebash
    $ /opt/clustrix/bin/clx cmd 'date'
  4. Stop all Clustrix services (per above).
  5. Change the backend interface IP address on each node.
  6. Modify iptables as needed.
  7. Start all Clustrix services (per above).

 

Sv translation
languageko

ClustrixDB 설치 프로세스의 일부로 사용자는 일부 구성을 선택합니다. 일단 설치가 완료되면 다음 안내에 따라 이러한 옵션을 수정할 수 있습니다.

clxnode.conf는 각 노드의 /etc/clustrix/에 저장되며 설치 중에 지정된 옵션이 이 파일에 기록됩니다. 다음 표는 이러한 옵션을 요약 설명하고 설치 후 수정 방법에 대한 정보를 제공합니다.

Note

이 문서에 설명된 단계는 대부분의 ClustrixDB 설치에 적용되지만 Clustrix AWS AMI를 기반으로 하는 배포에는 적용되지 않습니다.

Table of Contents

Note

ClustrixDB에서는 모든 노드가 동일한 구성으로 설정되어야 합니다. 클러스터의 모든 노드에서 아래에 설명된 옵션 중 하나를 수정해야 합니다. #으로 주석 처리된 값은 데이터베이스에 아무런 영향을 미치지 않습니다.

clxnode.conf의 기본 옵션

clxnode.conf에는 표준 bash 규칙을 사용하십시오. 파일은 변수 정의, 주석과 빈 줄만 포함해야 합니다. 예를 들어, CPU_CORES=4 같이 옵션 및 값 설정에 불필요한 공백이 없어야 합니다.

옵션설명기본값수정 방법

NODE_MEMORY

ClustrixDB에 사용할 메모리 (MiB 단위)

auto detected
  1. 클러스터의 모든 노드에 대해 clxnode.conf 파일을 원하는 값으로 편집합니다.
  2. 전체 Clustrix 서비스를 중지 / 시작하십시오.

MAX_REDO

최대 ClustrixDB 리두(Redo) 공간 (MiB 단위)

1024

Clustrix 지원팀의 지침에 따라 이 변수를 수정하십시오.

CPU_CORES

ClustrixDB에서 사용할 CPU 코어 수

All
  1. 클러스터의 모든 노드에 대해 clxnode.conf 파일을 원하는 값으로 편집하십시오.
  2. 전체 Clustrix 서비스를 중지 / 시작하십시오.

추가 정보는 아래의 CPU_CORES 설정 섹션을 참조하십시오.

DATA_PATH

ClustrixDB 데이터베이스 저장소 경로

/data/clustrix
  1. 전체 Clustrix 서비스를 중지합니다.
  2. 각 노드에서 다음을 수행하십시오.
    1. 디렉토리를 원하는 위치로 이동하십시오.
    2. clxnode.conf의 DATA_PATH 값을 수정하여 새 위치를 반영하십시오.
  3. 전체 Clustrix 서비스를 시작하십시오.
LOG_PATH

ClustrixDB 로그 경로

/data/clustrix/log
  1. 전체 Clustrix 서비스를 중지하십시오.
  2. 각 노드에서 다음을 수행하십시오.
    1. 디렉토리를 원하는 위치로 이동하십시오.
    2. `/data/clustrix/`에서 새로운 로그 폴더를 가리키는 심볼릭 링크를 생성하십시오.
      1. 예: ln -s /log /data/clustrix/log/
  3. 전체 Clustrix 서비스를 시작하십시오.

UI_LOGDIR

ClustrixDB WebUI 로그 경로/data/clustrix/log/clustrix_ui
  1. 전체 Clustrix 서비스를 중지하십시오.
  2. 각 노드에서 다음을 수행하십시오.
    1. 디렉토리를 원하는 위치로 이동하십시오.
    2. `/data/clustrix/log`에서 새로운 로그 폴더를 가리키는 심볼릭 링크를 생성하십시오.
      1. 예: ln -s /log/clustrix_ui /data/clustrix/log/clustrix_ui
  3. 전체 Clustrix 서비스를 시작하십시오.

UI_CACHEDIR

ClustrixDB WebUI 캐시 경로

/var/cache/clustrix/django

Clustrix 지원팀의 지침에 따라서만 이 변수를 수정하십시오.

UNIX_SOCKET_PATH

ClustrixDB MySQL Protocol Unix Socket

/var/lib/mysql/mysql.sock

Clustrix 지원팀의 지침에 따라서만 이 변수를 수정하십시오.

LISTEN_ADDR

ClustrixDB 데이터베이스 Listen Address (프론트엔드(Front-End) IP) 인터페이스

0.0.0.0

MYSQL_PORT

ClustrixDB 데이터베이스 MySQL 포트

3306

BACKEND_ADDR

ClustrixDB 프라이빗 (백엔드(Back-End)) IP 인터페이스

auto detected

BACKEND_ADDR 변경에 대해 아래 섹션을 참조하십시오.

BACKEND_PORT

ClustrixDB 백엔드(Back-End) 네트워크 포트

24378

ClustrixDB 백엔드 네트워크 포트의 기본값을 수정하지 않는 것이 좋습니다.

HTTP_PORT

ClustrixDB WebUI HTTP 포트

80
  1. clxnode.conf의 값을 편집하십시오.
  2. 전체 Clustrix 서비스를 중지 / 시작하십시오.

NANNY_PORT

ClustrixDB Nanny 포트

2424

ClustrixDB nanny 포트의 기본값을 수정하지 않는 것이 좋습니다.

CONTROL_PORT

ClustrixDB 제어 포트

2048

ClustrixDB 제어 포트의 기본값을 수정하지 않는 것이 좋습니다.

WRITE_HOSTS

ClustrixDB가 sshd_config 및 /etc/hosts를 수정하도록 허용합니다.

이는 업그레이드를 포함하여 관리 작업을 위한 노드 간 통신에 필요합니다.

#Commented out
  1. 각 노드에서 다음을 수행하십시오.
    1. 주석을 제거하고 변수를 임의의 문자열로 설정하십시오.
    2. 전체 Clustrix 서비스를 중지 / 시작하십시오.

HUGE_TLB_ENABLE

ClustrixDB의 빠른 시작을 위한 Enable HugeTLB 메모리 할당. 참고: 이로 인해 일부 시스템은 불안정할 수 있습니다 (특히 특정 가상 머신).

기본값을 변경하기 위해 Clustrix 지원팀에 문의하십시오.

True
  1. 각 노드에서 주석 처리하여 이 옵션을 비활성화하십시오. (즉, #HUGE_TLB_ENABLE)
  2. 전체 Clustrix 서비스를 중지 / 시작하십시오.

clxnode.conf 추가 옵션

다음 옵션은 clxnode.conf에 기본적으로 포함되어 있지 않지만, 파일의 끝에 추가되어 기본 작동을 변경할 수 있습니다.

옵션설명기본값수정 방법

DISABLE_MULTIPORT


이 옵션이 포함되어 있으면 멀티포트 기능이 비활성화됩니다.

이 옵션은 clxnode.conf에 포함되어 있지 않아서 멀티포트가 기본적으로 활성화됩니다.

멀티포트를 비활성화하려면 이 항목을 추가하고 이 변수를 모든 노드의 임의의 값으로 정의하십시오. (이 옵션이 있는 것만으로도 멀티포트가 비활성화됩니다)
멀티포트를 활성화하려면 모든 노드의 clxnode.conf에서 이 항목을 제거하거나 주석 처리하십시오.


Tip

클러스터에 용량을 추가할 때 Flex Clone 스크립트는 clxnode.conf에 지정된 옵션을 사용하여 새 노드에 Clustrix를 설치합니다.

시작 구성 옵션 수정에 대한 세부 정보

Warning

ClustrixDB는 모든 노드의 clxnode.conf가 동일한 값을 가져야 합니다.

전체 Clustrix 서비스 중지 / 시작

모든 노드에서 전체 Clustrix 서비스를 다시 시작하려면 다음 명령을 사용하십시오. 그러면 nanny 프로세스와 nanny가 제어하는 모든 작업이 다시 시작되어 데이터베이스가 온라인 상태가 됩니다. Nanny 개요를 참조하십시오.

Code Block
/opt/clustrix/bin/clx cmd 'initctl stop clustrix'
/opt/clustrix/bin/clx cmd 'initctl start clustrix'

CPU_CORES

기본 설정인 CPU_CORES=All은 시스템에서 사용 가능한 모든 코어를 사용합니다. ClustrixDB가 사용하는 코어 수를 제한하려면 CPU_CORES의 값을 수정하여 사용할 코어 수를 지정해야 합니다. ClustrixDB 라이선스는 CPU_CORES에 지정된 시스템에서 사용 중인 코어의 수를 기반으로 합니다.

Note

v6.X에서 업그레이드하는 경우 clxnode.conf에 CPU_CORES에 대한 항목이 없을 수 있고 그런 경우 암시적으로 CPU_CORES=All이 지정됩니다. 다른 값을 지정하려면 단순히 CPU_CORES 항목을 추가하십시오.

BACKEND_ADDR

  1. 새로운 IP로 `/etc/clustrix/clxnode.conf` 파일의 BACKEND_ADDR 항목을 수정하십시오.
  2. `/data/clustrix/broadcast_nodes` 파일을 모든 노드의 새 IP 주소로 수정하십시오.
    1. 참고: 기본값이 아닌 구성을 사용하지 않는 경우 포트 24378 지정은 필수가 아닙니다.
  3. `clx` 명령을 실행하여 각 노드의 IP 주소를 캐시 했는지 확인하십시오.

    Code Block
    languagebash
    $ /opt/clustrix/bin/clx cmd 'date'


  4. 전체 Clustrix 서비스를 중지하십시오.
  5. 각 노드에서 백엔드 인터페이스 IP 주소를 변경하십시오.
  6. 필요에 따라 iptables를 수정하십시오.
  7. 전체 Clustrix 서비스를 시작하십시오.