Node Bootstrapping Reference

bootstrap a node connect to the node to bootstrap an {{ocient}} 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 ssh admin\@10 10 10 10 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 node bootstrapping reference docid\ xi qqejsaauzkunlnq9yy 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 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 adminhost 10 10 10 10 start the node s tart the database sudo systemctl start rolehostd verify that the node and the service are active by running this status command 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 node bootstrapping reference docid\ xi qqejsaauzkunlnq9yy 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"] ℹ️this option applies to rest endpoints only for rest endpoints, see system information rest endpoints docid\ xrrtctfj5ywohyjnp482a 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 i f 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 docid\ mw cl16ivsflmrdqgwtk6 to set these options using sql syntax, see cluster and node management docid\ bnlgs0qq1wre7ndja8q0x useopal when you set this value to false , this option prevents the rolehostd service from taking ownership of and enabling opal locking on all nvme drives that support it bootstrap with this setting using an external key management system (kms) example bootstrap conf file this example shows a bootstrap conf file that you can use as a template \# 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 docid\ g9yuo4orb1yaoyb0d1bbq operating system configuration docid\ rzs2qc1xvmkmwmiaq60mq cluster and node management docid\ bnlgs0qq1wre7ndja8q0x