Skip to content
This repository has been archived by the owner on Feb 8, 2024. It is now read-only.

Cluster Config

Yashodhan Pise edited this page Dec 18, 2020 · 9 revisions

Cluster Config Schema

config.ini

config.ini is a basic user input to capture configuration of the cluster data.
These are the bare minimal values that cannot be captured automatically by direct system call.
Or when a direct system call would return values, requiring human validation.

Guidelines & Rules

  1. storage-enclosure-* are the sections that capture the information related to the storage enclosures

  2. srvnode-* are the sections that capture the information related to the server nodes

  3. The sections suffixed with default are the sections that are intended to capture the default values. These are the values that are common across all the nodes (server/storage enclosure).

    • storage-enclosure-default: Captures information that is common across all storage enclosures in cluster.
    • srvnode-default: Captures the information that is common across all server nodes in cluster.

    NOTE: The default section avoids repetition and thus chances of human error due to copy paste activities. Also, this reduces the size of the config.ini file.

  4. The sections with a numeral suffix act as node identities for storage sets in the target cluster
    E.g. storage-enclosure-1 for storage enclosure 1 in cluster & srvnode-1 for server node 1 in the same target cluster

  5. It is necessary to maintain all the sections with numeral suffix, as it helps affixing the count of the participating nodes

  6. The values of information unique to the node, which could not be captured in default section, are captured in sections with a numeral suffix
    E.g. Management IP

  7. Entries in default section could be over-ridden in the numeral suffixed sections. Such over-rides shall be uniquely applied to the targeted node as a special case

  8. Blank entries do not harm. To reset an entry in Salt pillar, a particular key entry has to be furnished with value: PRVSNR_UNDEFINED

Reference config.ini file

[srvnode-default]
search_domains=
dns_servers=
bmc.user=ADMIN
bmc.secret=
network.mgmt_nw.iface=eno1
network.mgmt_nw.netmask=
network.mgmt_nw.gateway=
network.data_nw.iface=enp175s0f0, enp175s1f0
network.data_nw.netmask=
network.data_nw.gateway=
storage.metadata_device="/dev/sdb"
storage.data_devices="/dev/sdc","/dev/sdd"

[srvnode-1]
hostname=srvnodes-1.localhost
is_primary=true
bmc.ip=10.20.30.11
network.mgmt_nw.public_ip_addr=10.20.30.101
network.data_nw.public_ip_addr=172.20.30.101

[srvnode-2]
hostname=srvnodes-2.localhost
is_primary=false
bmc.ip=10.20.30.12
network.mgmt_nw.public_ip_addr=10.20.30.102
network.data_nw.public_ip_addr=172.20.30.102

[srvnode-3]
hostname=srvnodes-3.localhost
is_primary=false
bmc.ip=10.20.30.13
network.mgmt_nw.public_ip_addr=10.20.30.103
network.data_nw.public_ip_addr=172.20.30.103

[storage-enclosure-default]
type=RBOD
controller.primary_mc.ip=10.0.0.2
controller.secondary_mc.ip=10.0.0.3
controller.user=manage
controller.secret=
controller.type=RBOD

[storage-enclosure-1]

[storage-enclosure-2]

[storage-enclosure-3]

Repo path: https://github.com/Seagate/cortx-prvsnr/blob/main/pillar/components/samples/config.ini

A diagramatic representation of the config.ini data structure
Cluster Config

Clone this wiki locally