Skip to main content
본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

Ubuntu 또는 Debian 배포용 노드 구성 파일을 만듭니다

기여자

노드 구성 파일은 StorageGRID 호스트 서비스에서 노드를 시작하고 적절한 네트워크 및 블록 스토리지 리소스에 연결하는 데 필요한 정보를 제공하는 작은 텍스트 파일입니다. 노드 구성 파일은 가상 노드에 사용되며 어플라이언스 노드에 사용되지 않습니다.

노드 구성 파일의 위치입니다

에 각 StorageGRID 노드의 구성 파일을 배치합니다 /etc/storagegrid/nodes 노드가 실행될 호스트의 디렉토리입니다. 예를 들어 HostA에서 관리 노드 1개, 게이트웨이 노드 1개 및 스토리지 노드 1개를 실행하려는 경우 에 노드 구성 파일 3개를 배치해야 합니다 /etc/storagegrid/nodes 호스트 A에서.

vim 또는 nano와 같은 텍스트 편집기를 사용하여 각 호스트에서 직접 구성 파일을 만들거나 다른 곳에서 구성 파일을 만들어 각 호스트로 이동할 수 있습니다.

노드 구성 파일 이름 지정

구성 파일의 이름이 중요합니다. 형식은 입니다 node-name.conf, 위치 node-name 노드에 할당하는 이름입니다. 이 이름은 StorageGRID Installer에 나타나며 노드 마이그레이션과 같은 노드 유지 관리 작업에 사용됩니다.

노드 이름은 다음 규칙을 따라야 합니다.

  • 고유해야 합니다

  • 문자로 시작해야 합니다

  • A ~ Z 및 a ~ z 문자를 포함할 수 있습니다

  • 0에서 9 사이의 숫자를 포함할 수 있습니다

  • 하나 이상의 하이픈(-)을 포함할 수 있습니다.

  • 은 포함되지 않고 32자 이하여야 합니다 .conf 연장

의 모든 파일 /etc/storagegrid/nodes 이러한 명명 규칙을 따르지 않는 경우 호스트 서비스에서 구문 분석되지 않습니다.

그리드에 대해 멀티 사이트 토폴로지를 계획한 경우 일반적인 노드 명명 규칙은 다음과 같습니다.

site-nodetype-nodenumber.conf

예를 들어 를 사용할 수 있습니다 dc1-adm1.conf 데이터 센터 1의 첫 번째 관리 노드에 대해 및 을 클릭합니다 dc2-sn3.conf 데이터 센터 2의 세 번째 스토리지 노드에 대해 그러나 모든 노드 이름이 명명 규칙을 따른다 하더라도 원하는 스키마를 사용할 수 있습니다.

노드 구성 파일의 내용입니다

구성 파일에는 키/값 쌍이 포함되어 있으며 한 줄에 하나의 키와 하나의 값이 있습니다. 각 키/값 쌍에 대해 다음 규칙을 따르십시오.

  • 키와 값은 등호 기호로 구분되어야 합니다 (=) 및 선택적 공백입니다.

  • 키에는 공백이 포함될 수 없습니다.

  • 값에는 포함된 공백이 포함될 수 있습니다.

  • 선행 또는 후행 공백은 무시됩니다.

다음 표에서는 지원되는 모든 키의 값을 정의합니다. 각 키에는 다음 중 하나가 지정됩니다.

  • * 필수 *: 모든 노드 또는 지정된 노드 유형에 필요합니다

  • * 모범 사례 *: 선택 사항이지만 권장됨

  • * 선택 사항 *: 모든 노드에 대해 선택 사항입니다

관리 네트워크 키

관리_IP

지정

이 노드가 속한 그리드에 대한 운영 관리 노드의 Grid Network IPv4 주소입니다. node_type=VM_Admin_Node 및 admin_role=Primary를 사용하는 그리드 노드에 대해 GRID_NETWORK_IP에 지정한 것과 동일한 값을 사용합니다. 이 매개 변수를 생략하면 노드가 mDNS를 사용하여 기본 관리 노드를 검색합니다.

  • 참고 *: 이 값은 기본 관리 노드에서 무시되고 금지될 수 있습니다.

모범 사례

관리 네트워크 구성

지정

DHCP, 정적 또는 비활성

선택 사항

관리_네트워크_ESL

지정

쉼표로 구분된 서브넷 목록으로, 이 노드가 Admin Network 게이트웨이를 사용하여 통신해야 하는 CIDR 표기법을 사용합니다.

예: 172.16.0.0/21,172.17.0.0/21

선택 사항

Admin_network_Gateway를 선택합니다

지정

이 노드에 대한 로컬 관리 네트워크 게이트웨이의 IPv4 주소입니다. admin_network_ip 및 admin_network_mask에 의해 정의된 서브넷에 있어야 합니다. DHCP 구성 네트워크에서는 이 값이 무시됩니다.

예:

1.1.1.1

10.224.4.81

필요한 경우 ADMIN_NETWORK_ESL 이(가) 지정되었습니다. 그렇지 않으면 선택 사항입니다.

admin_network_ip을 선택합니다

지정

관리 네트워크에서 이 노드의 IPv4 주소입니다. 이 키는 admin_network_Config=static인 경우에만 필요합니다. 다른 값에 대해서는 지정하지 마십시오.

예:

1.1.1.1

10.224.4.81

admin_network_config = static 인 경우 필요합니다.

그렇지 않으면 선택 사항입니다.

admin_network_MAC입니다

지정

컨테이너의 관리 네트워크 인터페이스에 대한 MAC 주소입니다.

이 필드는 선택 사항입니다. 생략할 경우 MAC 주소가 자동으로 생성됩니다.

콜론으로 구분된 6쌍의 16진수 숫자이어야 합니다.

예: b2:9c:02:c2:27:10

선택 사항

admin_network_mask를 선택합니다

지정

이 노드의 IPv4 넷마스크는 관리자 네트워크에서 설정합니다. admin_network_config = static 인 경우 이 키를 지정하고 다른 값에 대해서는 이 키를 지정하지 마십시오.

예:

255.255.255.0

255.255.248.0

admin_network_ip을 지정하고 admin_network_Config=static인 경우 필수입니다.

그렇지 않으면 선택 사항입니다.

admin_network_mtu

지정

Admin Network의 이 노드에 대한 MTU(Maximum Transmission Unit)입니다. admin_network_Config=DHCP인지 지정하지 마십시오. 지정된 경우 값은 1280에서 9216 사이여야 합니다. 생략하면 1500이 사용됩니다.

점보 프레임을 사용하려면 MTU를 9000과 같은 점보 프레임에 적합한 값으로 설정합니다. 그렇지 않으면 기본값을 유지합니다.

  • 중요 *: 네트워크의 MTU 값은 노드가 연결된 스위치 포트에 구성된 값과 일치해야 합니다. 그렇지 않으면 네트워크 성능 문제 또는 패킷 손실이 발생할 수 있습니다.

예:

1500

8192

선택 사항

admin_network_target 을 선택합니다

지정

StorageGRID 노드에서 관리자 네트워크 액세스에 사용할 호스트 디바이스의 이름입니다. 네트워크 인터페이스 이름만 지원됩니다. 일반적으로 GRID_NETWORK_TARGET 또는 CLIENT_NETWORK_TARGET에 지정된 것과 다른 인터페이스 이름을 사용합니다.

  • 참고 *: 네트워크 대상으로 연결 또는 브리지 장치를 사용하지 마십시오. 연결 디바이스 위에 VLAN(또는 기타 가상 인터페이스)을 구성하거나 브리지 및 가상 이더넷(veth) 쌍을 사용합니다.

  • 모범 사례 *: 이 노드에 처음에 관리 네트워크 IP 주소가 없을 경우에도 값을 지정하십시오. 그런 다음 나중에 호스트에서 노드를 다시 구성하지 않고도 관리 네트워크 IP 주소를 추가할 수 있습니다.

예:

bond0.1002

ens256

모범 사례

admin_network_target_type입니다

지정

인터페이스(이 값만 지원됩니다.)

선택 사항

admin_network_target_type_interface_clone_MAC

지정

참 또는 거짓

StorageGRID 컨테이너가 관리자 네트워크에서 호스트 호스트 대상 인터페이스의 MAC 주소를 사용하도록 하려면 키를 "true"로 설정합니다.

  • 모범 사례: * promiscuous 모드가 필요한 네트워크에서는 admin_network_target_type_interface_clone_MAC 키를 대신 사용합니다.

MAC 클로닝에 대한 자세한 내용:

모범 사례

admin_role을 선택합니다

지정

Primary 또는 Non-Primary

이 키는 node_type=vm_Admin_Node인 경우에만 필요하며 다른 노드 유형에 대해서는 지정하지 않습니다.

node_type=vm_admin_Node인 경우 필요합니다

그렇지 않으면 선택 사항입니다.

장치 키를 차단합니다

Block_device_audit_logs

지정

이 노드가 감사 로그의 영구 저장에 사용할 블록 디바이스 특수 파일의 경로 및 이름입니다.

예:

/dev/disk/by-path/pci-0000:03:00.0-scsi-0:0:0:0

/dev/disk/by-id/wwn-0x600a09800059d6df000060d757b475fd

/dev/mapper/sgws-adm1-audit-logs

node_type이 vm_admin_Node인 노드에 필요합니다. 다른 노드 유형에는 지정하지 마십시오.

Block_device_RANGEDB_nnn을 선택합니다

지정

이 노드가 영구 오브젝트 스토리지에 사용할 블록 디바이스 특수 파일의 경로 및 이름입니다. 이 키는 node_type=vm_Storage_Node인 노드에만 필요하며 다른 노드 유형에 대해서는 지정하지 않습니다.

block_device_RANGEDB_000 만 필요하며 나머지는 선택 사항입니다. block_device_RANGEDB_000 에 지정된 블록 디바이스는 4TB 이상이어야 하며 다른 블록 디바이스는 더 작을 수 있습니다.

간격을 두지 마십시오. BLOCK_DEVICE_RANGEDB_005를 지정하는 경우 BLOCK_DEVICE_RANGEDB_004도 지정해야 합니다.

  • 참고 *: 기존 배포와의 호환성을 위해 업그레이드된 노드에 대해 2자리 키가 지원됩니다.

예:

/dev/disk/by-path/pci-0000:03:00.0-scsi-0:0:0:0

/dev/disk/by-id/wwn-0x600a09800059d6df000060d757b475fd

/dev/mapper/sgws-sn1-rangedb-000

필수:

Block_device_RANGEDB_000

선택 사항:

BLOCK_DEVICE_RANGEDB_001

Block_device_RANGEDB_002

Block_device_RANGEDB_003

Block_device_RANGEDB_004

Block_device_RANGEDB_005 를 참조하십시오

Block_device_RANGEDB_006

Block_device_RANGEDB_007 을 참조하십시오

Block_device_RANGEDB_008

Block_device_RANGEDB_009

Block_device_RANGEDB_010

Block_device_RANGEDB_011 을 참조하십시오

Block_device_RANGEDB_012 를 참조하십시오

Block_device_RANGEDB_013

Block_device_RANGEDB_014

Block_device_RANGEDB_015

BLOCK_DEVICE_Tables

지정

이 노드가 데이터베이스 테이블의 영구 저장에 사용할 블록 디바이스 특수 파일의 경로 및 이름입니다. 이 키는 node_type=vm_Admin_Node인 노드에만 필요합니다. 다른 노드 유형에 대해서는 지정하지 마십시오.

예:

/dev/disk/by-path/pci-0000:03:00.0-scsi-0:0:0:0

/dev/disk/by-id/wwn-0x600a09800059d6df000060d757b475fd

/dev/mapper/sgws-adm1-tables

필수 요소입니다

BLOCK_DEVICE_VAR_LOCAL

지정

이 노드에서 사용할 블록 디바이스 특수 파일의 경로 및 이름입니다 /var/local 영구 스토리지:

예:

/dev/disk/by-path/pci-0000:03:00.0-scsi-0:0:0:0

/dev/disk/by-id/wwn-0x600a09800059d6df000060d757b475fd

/dev/mapper/sgws-sn1-var-local

필수 요소입니다

클라이언트 네트워크 키

client_network_Config

지정

DHCP, 정적 또는 비활성

선택 사항

CLIENT_NETWORK_GATEWAY

지정

client_network_ip 및 client_network_mask에 의해 정의된 서브넷에 있어야 하는 이 노드에 대한 로컬 클라이언트 네트워크 게이트웨이의 IPv4 주소입니다. DHCP 구성 네트워크에서는 이 값이 무시됩니다.

예:

1.1.1.1

10.224.4.81

선택 사항

client_network_ip

지정

클라이언트 네트워크에서 이 노드의 IPv4 주소입니다.

이 키는 client_network_Config = static 일 때만 필요합니다. 다른 값에 대해서는 지정하지 마십시오.

예:

1.1.1.1

10.224.4.81

client_network_Config=static 인 경우 필요합니다

그렇지 않으면 선택 사항입니다.

client_network_MAC

지정

컨테이너에 있는 클라이언트 네트워크 인터페이스의 MAC 주소입니다.

이 필드는 선택 사항입니다. 생략할 경우 MAC 주소가 자동으로 생성됩니다.

콜론으로 구분된 6쌍의 16진수 숫자이어야 합니다.

예: b2:9c:02:c2:27:20

선택 사항

client_network_mask.(클라이언트 네트워크 마스크

지정

클라이언트 네트워크의 이 노드에 대한 IPv4 넷마스크입니다.

client_network_config = static 인 경우 이 키를 지정하고 다른 값에는 이 키를 지정하지 마십시오.

예:

255.255.255.0

255.255.248.0

client_network_ip을 지정하고 client_network_Config=static인 경우 필수입니다

그렇지 않으면 선택 사항입니다.

client_network_mtu

지정

Client Network의 이 노드에 대한 MTU(Maximum Transmission Unit)입니다. client_network_Config = DHCP인지 지정하지 마십시오. 지정된 경우 값은 1280에서 9216 사이여야 합니다. 생략하면 1500이 사용됩니다.

점보 프레임을 사용하려면 MTU를 9000과 같은 점보 프레임에 적합한 값으로 설정합니다. 그렇지 않으면 기본값을 유지합니다.

  • 중요 *: 네트워크의 MTU 값은 노드가 연결된 스위치 포트에 구성된 값과 일치해야 합니다. 그렇지 않으면 네트워크 성능 문제 또는 패킷 손실이 발생할 수 있습니다.

예:

1500

8192

선택 사항

client_network_target 을 선택합니다

지정

StorageGRID 노드에서 클라이언트 네트워크 액세스에 사용할 호스트 디바이스의 이름입니다. 네트워크 인터페이스 이름만 지원됩니다. 일반적으로 GRID_NETWORK_TARGET 또는 ADMIN_NETWORK_TARGET에 지정된 것과 다른 인터페이스 이름을 사용합니다.

  • 참고 *: 네트워크 대상으로 연결 또는 브리지 장치를 사용하지 마십시오. 연결 디바이스 위에 VLAN(또는 기타 가상 인터페이스)을 구성하거나 브리지 및 가상 이더넷(veth) 쌍을 사용합니다.

  • 모범 사례: * 이 노드에 클라이언트 네트워크 IP 주소가 없을 경우에도 값을 지정하십시오. 그런 다음 나중에 호스트에서 노드를 다시 구성하지 않고도 클라이언트 네트워크 IP 주소를 추가할 수 있습니다.

예:

bond0.1003

ens423

모범 사례

CLIENT_NETWORK_TARGET_TYPE

지정

인터페이스(지원되는 값만 해당)

선택 사항

client_network_target_type_interface_clone_MAC

지정

참 또는 거짓

StorageGRID 컨테이너가 클라이언트 네트워크의 호스트 대상 인터페이스의 MAC 주소를 사용하도록 하려면 키를 "true"로 설정합니다.

  • 모범 사례: * promiscuous 모드가 필요한 네트워크에서는 대신 client_network_target_type_interface_clone_mac 키를 사용합니다.

MAC 클로닝에 대한 자세한 내용:

모범 사례

그리드 네트워크 키

GRID_NETWORK_CONFIG(그리드 네트워크 구성

지정

고정 또는 DHCP

지정하지 않으면 기본적으로 정적입니다.

모범 사례

GRID_NETWORK_Gateway를 참조하십시오

지정

GRID_NETWORK_IP 및 GRID_NETWORK_MASK로 정의된 서브넷에 있어야 하는 이 노드에 대한 로컬 Grid Network 게이트웨이의 IPv4 주소입니다. DHCP 구성 네트워크에서는 이 값이 무시됩니다.

그리드 네트워크가 게이트웨이가 없는 단일 서브넷인 경우, 서브넷(X. Y.Z.1)의 표준 게이트웨이 주소 또는 이 노드의 GRID_NETWORK_IP 값을 사용합니다. 두 값 중 하나를 사용하면 미래의 그리드 네트워크 확장이 단순화됩니다.

필수 요소입니다

GRID_NETWORK_IP입니다

지정

Grid Network에서 이 노드의 IPv4 주소입니다. 이 키는 GRID_NETWORK_CONFIG = static 일 때만 필요합니다. 다른 값에 대해서는 지정하지 마십시오.

예:

1.1.1.1

10.224.4.81

GRID_NETWORK_CONFIG = STATIC인 경우 필요합니다

그렇지 않으면 선택 사항입니다.

GRID_NETWORK_MAC을 선택합니다

지정

컨테이너의 그리드 네트워크 인터페이스에 대한 MAC 주소입니다.

콜론으로 구분된 6쌍의 16진수 숫자이어야 합니다.

예: b2:9c:02:c2:27:30

선택 사항

생략할 경우 MAC 주소가 자동으로 생성됩니다.

GRID_NETWORK_MASK 를 참조하십시오

지정

그리드 네트워크에서 이 노드에 대한 IPv4 넷마스크입니다. GRID_NETWORK_CONFIG = STATIC인 경우 이 키를 지정하고 다른 값에는 이 키를 지정하지 마십시오.

예:

255.255.255.0

255.255.248.0

GRID_NETWORK_IP를 지정하고 GRID_NETWORK_CONFIG=STATIC인 경우에 필요합니다.

그렇지 않으면 선택 사항입니다.

GRID_NETWORK_MTU 를 참조하십시오

지정

Grid Network의 이 노드에 대한 MTU(Maximum Transmission Unit)입니다. GRID_NETWORK_CONFIG=DHCP인지 지정하지 마십시오. 지정된 경우 값은 1280에서 9216 사이여야 합니다. 생략하면 1500이 사용됩니다.

점보 프레임을 사용하려면 MTU를 9000과 같은 점보 프레임에 적합한 값으로 설정합니다. 그렇지 않으면 기본값을 유지합니다.

  • 중요 *: 네트워크의 MTU 값은 노드가 연결된 스위치 포트에 구성된 값과 일치해야 합니다. 그렇지 않으면 네트워크 성능 문제 또는 패킷 손실이 발생할 수 있습니다.

  • 중요 *: 최상의 네트워크 성능을 얻으려면 모든 노드를 그리드 네트워크 인터페이스에서 유사한 MTU 값으로 구성해야 합니다. 개별 노드의 그리드 네트워크에 대한 MTU 설정에 상당한 차이가 있을 경우 * Grid Network MTU mismatch * 경고가 트리거됩니다. MTU 값은 모든 네트워크 유형에 대해 같을 필요는 없습니다.

예:

1500

8192

선택 사항

GRID_NETWORK_TARGET

지정

StorageGRID 노드에서 그리드 네트워크 액세스에 사용할 호스트 디바이스의 이름입니다. 네트워크 인터페이스 이름만 지원됩니다. 일반적으로 admin_network_target 또는 client_network_target 에 지정된 것과 다른 인터페이스 이름을 사용합니다.

  • 참고 *: 네트워크 대상으로 연결 또는 브리지 장치를 사용하지 마십시오. 연결 디바이스 위에 VLAN(또는 기타 가상 인터페이스)을 구성하거나 브리지 및 가상 이더넷(veth) 쌍을 사용합니다.

예:

bond0.1001

ens192

필수 요소입니다

GRID_NETWORK_TARGET_TYPE

지정

인터페이스(이 값만 지원됩니다.)

선택 사항

GRID_NETWORK_TARGET_TYPE_INTERFACE_CLONE_MAC

지정

참 또는 거짓

StorageGRID 컨테이너가 그리드 네트워크에서 호스트 대상 인터페이스의 MAC 주소를 사용하도록 키 값을 "true"로 설정합니다.

  • 모범 사례: * promiscuous 모드가 필요한 네트워크에서는 grid_network_target_type_interface_clone_mac 키를 대신 사용합니다.

MAC 클로닝에 대한 자세한 내용:

모범 사례

인터페이스 키입니다

interface_target_nnnn입니다

지정

이 노드에 추가할 추가 인터페이스의 이름 및 선택적 설명입니다. 각 노드에 여러 개의 인터페이스를 추가할 수 있습니다.

_nnnn_의 경우 추가할 각 interface_target 항목의 고유 번호를 지정합니다.

값에 대해 베어 메탈 호스트의 물리적 인터페이스 이름을 지정합니다. 그런 다음 필요에 따라 쉼표를 추가하고 인터페이스에 대한 설명을 입력합니다. 이 설명은 VLAN 인터페이스 페이지와 HA 그룹 페이지에 표시됩니다.

예: INTERFACE_TARGET_0001=ens256, Trunk

트렁크 인터페이스를 추가하는 경우 StorageGRID에서 VLAN 인터페이스를 구성해야 합니다. 액세스 인터페이스를 추가할 경우 인터페이스를 HA 그룹에 직접 추가할 수 있으며, VLAN 인터페이스를 구성할 필요가 없습니다.

선택 사항

최대 RAM 키

최대 RAM

지정

이 노드가 사용할 수 있는 최대 RAM 양입니다. 이 키를 생략하면 노드의 메모리 제한 사항이 없게 됩니다. 운영 레벨 노드에 대해 이 필드를 설정할 때 총 시스템 RAM보다 최소 24GB 및 16 ~ 32GB 적은 값을 지정합니다.

이 필드의 형식은 입니다 numberunit, 위치 unit 있을 수 있습니다 b, k, m, 또는 g.

예:

24g

38654705664b

  • 참고 *: 이 옵션을 사용하려면 메모리 cgroup에 대한 커널 지원을 활성화해야 합니다.

선택 사항

노드 유형 키입니다

node_type입니다

지정

노드 유형:

VM_Admin_Node VM_스토리지_노드 VM_Archive_Node VM_API_게이트웨이

필수 요소입니다

포트 재매핑 키

port_remap 을 참조하십시오

지정

노드에서 내부 그리드 노드 통신 또는 외부 통신을 위해 사용하는 모든 포트를 다시 매핑합니다. 엔터프라이즈 네트워킹 정책에서 에 설명된 대로 StorageGRID에서 사용하는 하나 이상의 포트를 제한하는 경우 포트를 다시 매핑해야 합니다 "내부 그리드 노드 통신" 또는 "외부 통신".

  • 중요 *: 로드 밸런서 엔드포인트를 구성하기 위해 사용하려는 포트를 다시 매핑하지 마십시오.

  • 참고 *: port_remap 만 설정된 경우 지정하는 매핑이 인바운드 및 아웃바운드 통신 모두에 사용됩니다. port_remap_inbound 도 지정된 경우 port_remap 은 아웃바운드 통신에만 적용됩니다.

사용되는 형식은 다음과 같습니다. network type/protocol/default port used by grid node/new port, 위치 network type 그리드, 관리자 또는 클라이언트, 및 입니다 protocol TCP 또는 UDP입니다.

예: PORT_REMAP = client/tcp/18082/443

선택 사항

port_remap_inbound 를 참조하십시오

지정

인바운드 통신을 지정된 포트에 다시 매핑합니다. port_remap_inbound 를 지정하지만 port_remap 의 값을 지정하지 않으면 포트의 아웃바운드 통신이 변경되지 않습니다.

  • 중요 *: 로드 밸런서 엔드포인트를 구성하기 위해 사용하려는 포트를 다시 매핑하지 마십시오.

사용되는 형식은 다음과 같습니다. network type/protocol/remapped port/default port used by grid node, 위치 network type 그리드, 관리자 또는 클라이언트, 및 입니다 protocol TCP 또는 UDP입니다.

예: PORT_REMAP_INBOUND = grid/tcp/3022/22

선택 사항