Node Bootstrapping Reference

Bootstrap a Node 
1
Connect to the Node
To bootstrap an 
﻿ node, connect to the node with your server username and password and the IP address of your node. 
For example, connect as administrator admin to the IP Address 10.10.10.10.
Shell
ssh [email protected]
ssh admin@10.10.10.10
﻿
2
Configure the Bootstrap Configuration File
Use your preferred text editor with sudo to create the /var/opt/ocient/bootstrap.conf file as root. 
For a list of bootstrapping options, see Supported Options﻿.
Option 1: Bootstrap the initial node in a system
Use these bootstrap.conf settings to create the initial node in a system.
/var/opt/ocient/bootstrap.conf example 
YAML
initialSystem: true
initialSystem: true
﻿
Option 2: Bootstrap a new node on a system with an initial node
Use these bootstrap.conf settings to create another node in a system, replacing the IP Address 10.10.10.10 with the IP address or hostname of the initial node.
/var/opt/ocient/bootstrap.conf example
YAML
adminHost: 10.10.10.10
adminHost: 10.10.10.10
﻿
3
Start the Node
Start the database. 
Shell
sudo systemctl start rolehostd
sudo systemctl start rolehostd
﻿
Verify that the node and the service are active by running this status command.
Shell
systemctl status rolehostd

rolehostd.service - Rolehostd daemon startup
     Loaded: loaded (/etc/systemd/system/rolehostd.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2022-01-26 23:31:36 UTC; 7s ago
     ...
systemctl status rolehostd

rolehostd.service - Rolehostd daemon startup
     Loaded: loaded (/etc/systemd/system/rolehostd.service; enabled; vendor preset: enabled)
     Active: active (running) since Wed 2022-01-26 23:31:36 UTC; 7s ago
     ...
﻿
You have bootstrapped the node.
Supported Options
You can edit the /var/opt/ocient/bootstrap.conf file to include a number of other options for advanced system configurations.
The Ocient bootstrap.conf file can also include these optional parameters. For examples of these options, see the Example bootstrap.conf file﻿.
Option
Description
name
The default name of the node in the database is the hostname. If that name is not appropriate, you can assign a different name.
nodeAddress
The default address of this node is the hostname of the node, or the IP address if the useDns setting is false. If the system has multiple interfaces or you want an alternative setup, then you can specify the node address. This address is the address that all the other nodes in the cluster use to contact this node.
externalAddress
It might be desirable to have the SQL Nodes listen on a different external address than the system uses internally. The externalAddress parameter can either be a single address or a list of addresses.
Example of single address: 
externalAddress: 10.10.10.1
Example of a list of addresses: 
externalAddress: ["10.10.10.1","20.20.20.2"]
adminUserName
The default user, specified as admin@system, when you create an Ocient system. If a different administrator user should be used to add this node to an existing system, use this option to indicate the user.
adminPassword
If the administrator password is not the default, then use this option to specify the password.
logLevel
The logging level for the system. Defaults to DEBUG.
connectivityPools
The configuration of SQL Nodes in a connectivity pool. You can use this configuration to configure the connectivity pool for the first SQL Node in a cluster. Other nodes cannot use this option.
If there are no entries in the bootstrap.conf file, then the Ocient System adds the SQL Node to a new connectivity pool with a default name.
Example of the connectivity pool named test_pool configuration:
connectivityPools:
    test_pool: 
      sourceAddress: 1.2.3.4/12
	  sourcePort: 1 # optional
	  priority: 1
	  listenAddress: 111.1.1.1
	  listenPort: 4050
	  advertisedAddress: localhost
	  advertisedPort: 4050 # optional
systemStorageSpace
The configuration for storage space has width and parity width for the Ocient System. If you do not configure the storage space, the system sets the width to 3 and parity to 2, the default values. For details about width and parity width, see Core Elements of an Ocient System﻿. To set these options using SQL syntax, see CREATE STORAGESPACE﻿.
﻿
Example bootstrap.conf File
This example shows a bootstrap.conf file that you can use as a template.
YAML
# initialSystem: true           # Uncomment for the first node in a
                                # multi-cluster system. 
                                # Defaults to false. Cannot be
                                # true if initialSingleClusterSystem 
                                # is also true.
                                
# initialSingleClusterSystem: true  # Uncomment for the first node in a 
                                # single-cluster system. 
                                # Defaults to false. Cannot be
                                # true if initialSystem is also true.

# systemName: productionSystem  # The name of the Ocient system. This 
                                # configuration applies only when the 
                                # initialSystem or initialSingleClusterSystem 
                                # configuration is set to true.

# adminHost: sql.example.com    # Hostname or IP address of an administrator 
                                # node, generally the first node. Not 
                                # required for the initial node, but required 
                                # for all other nodes.

# name: elmo                    # The name of this node. 
                                # Defaults to hostname.

# nodeAddress: sql1.example.com # The Hostname or IP address of this node.  
                                # Defaults to hostname, and if that does not 
                                # work, the bootstrapping process uses the IP 
                                # address of the system.

# externalAddress: ["10.10.10.1", "20.20.20.2"]

# useDns: false                 # Use DNS to determine the hostname of this 
                                # node. Defaults to true. When you set this 
                                # configuration to false, the bootstrapping 
                                # process uses the IP address of the system.

# adminUserName: bert@system    # A system administrator username. 
                                # Defaults to "admin@system".
# adminPassword: ernie          # The password for the administrator user.
                                # Defaults to "admin".

# logLevel: info                # Log level for the system. 
                                # Defaults to debug.
                                
# connectivityPools:            # Define connectivity pool named test_pool.
#    test_pool: 
#      sourceAddress: 1.2.3.4/12 # The source IP address, which is 
                                 # the IP address in CIDR notation of
                                 # the client that connects to the SQL node.

# 	   sourcePort: 1             # The optional source port number, which is the 
                                 # port number of the client. This parameter 
                                 # defaults to none, which means any port number.
#	   priority: 1               # The priority of the connection. A higher number 
                                 # indicates a higher priority.
#	   listenAddress: 111.1.1.1  # The IP address for listening.
#	   listenPort: 4050             # The port number for listening.
#	   advertisedAddress: localhost # The IP address to return to the client.
#	   advertisedPort: 4050      # The optional port number to return to the client.
                                 # If you specify NULL for this parameter, then the 
                                 # database uses the value of the listen_port parameter.
                                 
# systemStorageSpace             # Define the system storage space.
#    width: 3                    # The width is the total number of segments to use in 
                                 # each segment group.
#    parityWidth: 2              # The parity width is the number of parity coding bits 
                                 # to use for each segment group, or the fault tolerance.                   
# initialSystem: true           # Uncomment for the first node in a
                                # multi-cluster system. 
                                # Defaults to false. Cannot be
                                # true if initialSingleClusterSystem 
                                # is also true.
                                
# initialSingleClusterSystem: true  # Uncomment for the first node in a 
                                # single-cluster system. 
                                # Defaults to false. Cannot be
                                # true if initialSystem is also true.

# systemName: productionSystem  # The name of the Ocient system. This 
                                # configuration applies only when the 
                                # initialSystem or initialSingleClusterSystem 
                                # configuration is set to true.

# adminHost: sql.example.com    # Hostname or IP address of an administrator 
                                # node, generally the first node. Not 
                                # required for the initial node, but required 
                                # for all other nodes.

# name: elmo                    # The name of this node. 
                                # Defaults to hostname.

# nodeAddress: sql1.example.com # The Hostname or IP address of this node.  
                                # Defaults to hostname, and if that does not 
                                # work, the bootstrapping process uses the IP 
                                # address of the system.

# externalAddress: ["10.10.10.1", "20.20.20.2"]

# useDns: false                 # Use DNS to determine the hostname of this 
                                # node. Defaults to true. When you set this 
                                # configuration to false, the bootstrapping 
                                # process uses the IP address of the system.

# adminUserName: bert@system    # A system administrator username. 
                                # Defaults to "admin@system".
# adminPassword: ernie          # The password for the administrator user.
                                # Defaults to "admin".

# logLevel: info                # Log level for the system. 
                                # Defaults to debug.
                                
# connectivityPools:            # Define connectivity pool named test_pool.
#    test_pool: 
#      sourceAddress: 1.2.3.4/12 # The source IP address, which is 
                                 # the IP address in CIDR notation of
                                 # the client that connects to the SQL node.

# 	   sourcePort: 1             # The optional source port number, which is the 
                                 # port number of the client. This parameter 
                                 # defaults to none, which means any port number.
#	   priority: 1               # The priority of the connection. A higher number 
                                 # indicates a higher priority.
#	   listenAddress: 111.1.1.1  # The IP address for listening.
#	   listenPort: 4050             # The port number for listening.
#	   advertisedAddress: localhost # The IP address to return to the client.
#	   advertisedPort: 4050      # The optional port number to return to the client.
                                 # If you specify NULL for this parameter, then the 
                                 # database uses the value of the listen_port parameter.
                                 
# systemStorageSpace             # Define the system storage space.
#    width: 3                    # The width is the total number of segments to use in 
                                 # each segment group.
#    parityWidth: 2              # The parity width is the number of parity coding bits 
                                 # to use for each segment group, or the fault tolerance.                   
﻿
Related Links
﻿Checking System Configuration Before Bootstrapping﻿﻿
﻿Operating System Configuration﻿﻿
﻿Cluster and Node Management﻿﻿

Option	Description
name	The default name of the node in the database is the hostname. If that name is not appropriate, you can assign a different name.
nodeAddress	The default address of this node is the hostname of the node, or the IP address if the useDns setting is false. If the system has multiple interfaces or you want an alternative setup, then you can specify the node address. This address is the address that all the other nodes in the cluster use to contact this node.
externalAddress	It might be desirable to have the SQL Nodes listen on a different external address than the system uses internally. The externalAddress parameter can either be a single address or a list of addresses. Example of single address: externalAddress: 10.10.10.1 Example of a list of addresses: externalAddress: ["10.10.10.1","20.20.20.2"]
adminUserName	The default user, specified as admin@system, when you create an Ocient system. If a different administrator user should be used to add this node to an existing system, use this option to indicate the user.
adminPassword	If the administrator password is not the default, then use this option to specify the password.
logLevel	The logging level for the system. Defaults to DEBUG.
connectivityPools	The configuration of SQL Nodes in a connectivity pool. You can use this configuration to configure the connectivity pool for the first SQL Node in a cluster. Other nodes cannot use this option. If there are no entries in the bootstrap.conf file, then the Ocient System adds the SQL Node to a new connectivity pool with a default name. Example of the connectivity pool named test_pool configuration: connectivityPools: test_pool: sourceAddress: 1.2.3.4/12 sourcePort: 1 # optional priority: 1 listenAddress: 111.1.1.1 listenPort: 4050 advertisedAddress: localhost advertisedPort: 4050 # optional
systemStorageSpace	The configuration for storage space has width and parity width for the Ocient System. If you do not configure the storage space, the system sets the width to 3 and parity to 2, the default values. For details about width and parity width, see Core Elements of an Ocient System. To set these options using SQL syntax, see CREATE STORAGESPACE.

Updated 16 May 2024

Did this page help you?

Checking System After Configuration

Amazon Web Services Ocient Installation