为 Ubuntu 或 Debian 部署创建节点配置文件
建议更改
PDF
节点配置文件是一个小型文本文件，用于提供 StorageGRID 主机服务启动节点并将其连接到适当的网络和块存储资源所需的信息。节点配置文件用于虚拟节点，不用于设备节点。
应将节点配置文件放在何处？
您必须将每个 StorageGRID 节点的配置文件放置在要运行该节点的主机上的 ` /etc/storaggrid/nodes` 目录中。例如，如果您计划在主机 A 上运行一个管理节点，一个网关节点和一个存储节点，则必须将三个节点配置文件放置在主机 A 上的 ` /etc/storaggrid/nodes` 中。您可以使用文本编辑器（例如 vim 或 nanan ）在每个主机上直接创建配置文件，也可以在其他位置创建配置文件并将其移动到每个主机。
节点配置文件的名称是什么？
配置文件的名称非常重要。格式为 node-name.conf ，其中 node-name 是您分配给节点的名称。此名称显示在 StorageGRID 安装程序中，用于节点维护操作，例如节点迁移。
节点名称必须遵循以下规则：
-
必须是唯一的
-
必须以字母开头
-
可以包含字符 A 到 Z 和 a 到 z
-
可以包含数字 0 到 9
-
可以包含一个或多个连字符（ - ）
-
不得超过 32 个字符，不包括 ` 。 conf` 扩展名
主机服务不会解析 ` /etc/storaggrid/nodes` 中不符合这些命名约定的任何文件。
如果您为网格规划了多站点拓扑，则典型的节点命名方案可能是：
site-nodetype-nodenumber.conf
例如，您可以对 Data Center 1 中的第一个管理节点使用 dc1-adm1.conf ，而对 Data Center 2 中的第三个存储节点使用 dc2-SN3.conf 。但是，只要所有节点名称都遵循命名规则，您就可以使用所需的任何方案。
节点配置文件中的内容是什么？
配置文件包含密钥 / 值对，每行一个密钥和一个值。对于每个密钥 / 值对，您必须遵循以下规则：
-
密钥和值必须以等号（` =` ）和可选空格分隔。
-
密钥不能包含空格。
-
这些值可以包含嵌入的空格。
-
忽略任何前导或尾随空格。
每个节点都需要一些密钥，而其他密钥则是可选的，或者仅适用于某些节点类型。
下表定义了所有支持的密钥的可接受值。在中间列中：
-
R* ：必填项 + bp ：最佳实践 + O ：可选
| 密钥 | R ， Bp 或 O ？ | 价值 |
|---|---|---|
admin_ip |
bp |
此节点所属网格的主管理节点的网格网络 IPv4 地址。使用为 node_type = VM_Admin_Node 且 admin_role = Primary 的网格节点的 grid_network_IP 指定的相同值。如果省略此参数，则节点将尝试使用 mDNS 发现主管理节点。
|
admin_network_config |
O |
DHCP ，静态或已禁用 |
admin_network_esl |
O |
此节点应通过管理网络网关与 CIDR 表示法中的子网列表，以逗号分隔。 示例： |
admin_network_gateway |
O （ * R* ） |
此节点的本地管理网络网关的 IPv4 地址。必须位于 admin_network_ip 和 admin_network_mask 定义的子网上。对于配置了 DHCP 的网络，此值将被忽略。
示例
|
admin_network_ip |
O |
此节点在管理网络上的 IPv4 地址。只有当 admin_network_config = static 时才需要此密钥；不要为其他值指定此密钥。 示例
|
admin_network_MAC |
O |
容器中管理网络接口的 MAC 地址。 此字段为可选字段。如果省略此参数，则会自动生成 MAC 地址。 必须为 6 对十六进制数字，以冒号分隔。 示例： |
admin_network_mask |
O |
此节点的 IPv4 网络掩码，位于管理网络上。只有当 admin_network_config = static 时才需要此密钥；不要为其他值指定此密钥。 示例
|
admin_network_mtu |
O |
管理网络上此节点的最大传输单元（ MTU ）。请勿指定 admin_network_config 是否为 DHCP 。如果指定，则此值必须介于 1280 和 9216 之间。如果省略，则使用 1500 。 如果要使用巨型帧，请将 MTU 设置为适合巨型帧的值，例如 9000 。否则，请保留默认值。
示例
|
admin_network_target |
bp |
StorageGRID 节点用于管理网络访问的主机设备的名称。仅支持网络接口名称。通常，您使用的接口名称与为 grid_network_target 或 client_network_target 指定的接口名称不同。
示例
|
admin_network_target_type |
O |
接口 （这是唯一受支持的值。） |
admin_network_target_type_interface_clone_MAC |
bp |
判断对错 将密钥设置为 "true" 以发生原因 StorageGRID 容器使用管理网络上主机主机目标接口的 MAC 地址。
有关 MAC 克隆的详细信息，请参见： |
管理角色 |
|
主卷或非主卷 只有当 node_type = VM_Admin_Node 时才需要此密钥；不要为其他节点类型指定此密钥。 |
block_device_audit_logs |
|
此节点将用于永久存储审核日志的块设备专用文件的路径和名称。只有 node_type = VM_Admin_Node 的节点才需要此密钥；不要为其他节点类型指定此密钥。 示例 ` /dev/disk/by-path/PCI-0000 ： 03 ： 00.0-SCSI-0 ： 0 ： 0 ： 0 ： 0` ` /dev/disk/by-id/WWS-0x600a09800059d6df000060d757b475fd` ` /dev/mapper/sgws-ad1-audit-logs` |
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 |
|
此节点将用于永久性对象存储的块设备专用文件的路径和名称。只有 node_type = VM_Storage_Node 的节点才需要此密钥；不要为其他节点类型指定此密钥。 仅需要 block_device_RANGEDB_000 ；其余为可选。为 block_device_RANGEDB_000 指定的块设备必须至少为 4 TB ；其他块设备可以更小。 请勿留下空隙。如果指定 block_device_RANGEDB_005 ，则还必须指定 block_device_RANGEDB_004 。
示例 ` /dev/disk/by-path/PCI-0000 ： 03 ： 00.0-SCSI-0 ： 0 ： 0 ： 0 ： 0` ` /dev/disk/by-id/WWS-0x600a09800059d6df000060d757b475fd` ` /dev/mapper/sgws-SN1-rangedb-000` |
block_device_tables |
|
此节点将用于永久存储数据库表的块设备专用文件的路径和名称。只有 node_type = VM_Admin_Node 的节点才需要此密钥；不要为其他节点类型指定此密钥。 示例 ` /dev/disk/by-path/PCI-0000 ： 03 ： 00.0-SCSI-0 ： 0 ： 0 ： 0 ： 0` ` /dev/disk/by-id/WWS-0x600a09800059d6df000060d757b475fd` ` /dev/mapper/sgws-ad1-tables` |
block_device_var_local |
|
此节点将用于其 /var/local 永久性存储的块设备专用文件的路径和名称。 示例 ` /dev/disk/by-path/PCI-0000 ： 03 ： 00.0-SCSI-0 ： 0 ： 0 ： 0 ： 0` ` /dev/disk/by-id/WWS-0x600a09800059d6df000060d757b475fd` ` /dev/mapper/sgws-SN1-var-local` |
client_network_config |
O |
DHCP ，静态或已禁用 |
client_network_gateway |
O |
此节点的本地客户端网络网关的 IPv4 地址，该地址必须位于 client_network_ip 和 client_network_mask 定义的子网上。对于配置了 DHCP 的网络，此值将被忽略。 示例
|
client_network_IP |
O |
此节点在客户端网络上的 IPv4 地址。只有当 client_network_config = static 时才需要此密钥；不要为其他值指定此密钥。 示例
|
客户端网络 MAC |
O |
容器中客户端网络接口的 MAC 地址。 此字段为可选字段。如果省略此参数，则会自动生成 MAC 地址。 必须为 6 对十六进制数字，以冒号分隔。 示例： |
client_network_mask |
O |
此节点在客户端网络上的 IPv4 网络掩码。只有当 client_network_config = static 时才需要此密钥；不要为其他值指定此密钥。 示例
|
client_network_mtu |
O |
客户端网络上此节点的最大传输单元（ MTU ）。请勿指定 client_network_config 是否为 DHCP 。如果指定，则此值必须介于 1280 和 9216 之间。如果省略，则使用 1500 。 如果要使用巨型帧，请将 MTU 设置为适合巨型帧的值，例如 9000 。否则，请保留默认值。
示例
|
client_network_target |
bp |
StorageGRID 节点用于客户端网络访问的主机设备的名称。仅支持网络接口名称。通常，您使用的接口名称与为 grid_network_target 或 admin_network_target 指定的接口名称不同。
示例
|
client_network_target_type |
O |
接口 （此值仅受支持。） |
client_network_target_type_interface_clone_MAC |
bp |
判断对错 将密钥设置为 "true" ，以便对 StorageGRID 容器进行发生原因 处理，以使用客户端网络上主机目标接口的 MAC 地址。
有关 MAC 克隆的详细信息，请参见： |
grid_network_config |
bp |
静态或 DHCP （如果未指定，则默认为 static 。） |
grid_network_gateway |
|
此节点的本地网格网络网关的 IPv4 地址，该网关必须位于 grid_network_ip 和 grid_network_mask 定义的子网上。对于配置了 DHCP 的网络，此值将被忽略。 如果网格网络是没有网关的单个子网，请使用该子网的标准网关地址（ X.y.Z.1 ）或此节点的 GRID_NETWORK_IP 值；任一值都将简化未来可能进行的网格网络扩展。 |
GRID_NETWORK_IP |
|
此节点在网格网络上的 IPv4 地址。只有当 grid_network_config = static 时才需要此密钥；不要为其他值指定此密钥。 示例
|
GRID_NETWORK_MAC |
O |
容器中网格网络接口的 MAC 地址。 此字段为可选字段。如果省略此参数，则会自动生成 MAC 地址。 必须为 6 对十六进制数字，以冒号分隔。 示例： |
grid_network_mask |
O |
此节点在网格网络上的 IPv4 网络掩码。只有当 grid_network_config = static 时才需要此密钥；不要为其他值指定此密钥。 示例
|
grid_network_mtu |
O |
网格网络上此节点的最大传输单元（ MTU ）。请勿指定 grid_network_config 是否为 DHCP 。如果指定，则此值必须介于 1280 和 9216 之间。如果省略，则使用 1500 。 如果要使用巨型帧，请将 MTU 设置为适合巨型帧的值，例如 9000 。否则，请保留默认值。
示例 1500 8192 |
grid_network_target |
|
StorageGRID 节点要用于网格网络访问的主机设备的名称。仅支持网络接口名称。通常，您使用的接口名称与为 admin_network_target 或 client_network_target 指定的接口名称不同。
示例
|
grid_network_target_type |
O |
接口 （这是唯一受支持的值。） |
grid_network_target_type_interface_clone_MAC |
|
判断对错 将密钥值设置为 "true" ，以便对 StorageGRID 容器进行发生原因 处理，以使用网格网络上主机目标接口的 MAC 地址。
有关 MAC 克隆的详细信息，请参见： |
interfaces_target_nnnn |
O |
要添加到此节点的额外接口的名称和可选问题描述 。您可以向每个节点添加多个额外接口。 对于 nnnn ，请为要添加的每个 interfaces_target 条目指定一个唯一编号。 对于此值，请指定裸机主机上物理接口的名称。然后，也可以添加一个逗号并提供接口的问题描述 ，该接口将显示在 "VLAN interfaces" 页面和 "HA Groups" 页面上。 例如： 如果添加中继接口，则必须在 StorageGRID 中配置 VLAN 接口。如果添加访问接口，则可以将该接口直接添加到 HA 组；而无需配置 VLAN 接口。 |
最大 RAM |
O |
此节点允许使用的最大 RAM 量。如果省略此密钥，则节点不存在内存限制。在为生产级节点设置此字段时，请指定一个值，该值应至少比系统 RAM 总量少 24 GB ，并且要少 16 到 32 GB 。
此字段的格式为 ` < 数字 >< 单位 >` ，其中 ` < 单位 >` 可以是 示例
|
node_type |
|
节点类型： VM_Admin_Node VM_Storage_Node VM_Archive_Node VM_API_Gateway |
port_remap |
O |
重新映射节点用于内部网格节点通信或外部通信的任何端口。如果企业网络策略限制 StorageGRID 使用的一个或多个端口，则必须重新映射端口，如 "`内部网格节点通信` " 或 "`外部通信 " 中所述。`
使用的格式为： ` < 网络类型 >/< 协议 >/< 网格节点使用的默认端口 >/< 新端口 >` ，其中 ` < 网络类型 >` 是网格，管理员或客户端，协议是 TCP 或 UDP 。 例如：
|
port_remap_inbound |
O |
将入站通信重新映射到指定端口。如果指定 port_remap_inbound ，但未指定 port_remap 的值，则端口的出站通信将保持不变。
使用的格式为： ` < 网络类型 >/< 协议： >/< 网格节点使用的默认端口 >/< 网格节点使用的默认端口 >` ，其中 ` < 网络类型 >` 是网格，管理员或客户端，协议是 TCP 或 UDP 。 例如：
|