System Administration
...
Install an Ocient System
Installation Reference

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

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


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

3

Start the Node

Start the database.

Shell


Verify that the node and the service is active by running this status command.

Shell


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"]

highspeedAddress

In some cases, you can use a different interface or network for traffic associated with processing queries. For example, the default network for a node is a 10G network, but a separate high speed 100G network is used between the SQL and Foundation Nodes to process queries. This address is the DNS name (if it is resolvable) or the IP address of the interface connected to the high speed network.

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.



Example bootstrap.conf File

This example shows a bootstrap.conf file that you can use as a template.

YAML


Related Links