Post-Installation Steps

AI Tools

After a successful Lightbits cluster installation, perform the following steps.

Back Up Important Content

Back up the following contents to a secure location. This will be useful if another node is added in the future or other troubleshooting is required.

Back up the ~/light-app directory and all of its contents. The contents of the Ansible directory will be helpful in the future if there is a need to add servers or check over how a previous installation was done.
Back up the generated JWTs. Back up the system-jwt and the default project jwt. By default they are placed in the home directory: ~/lightos-system-jwt and ~/lightos-default-admin-jwt.
Back up the generated certificates. By default these are placed in ~/lightos-certificates.

Check Cluster Health

Copy the contents of the system jwt file ~/lightos-system-jwt into the clipboard.

From the Ansible host, run cat ~/lightos-system-jwt; echo;. Note that we add the last echo to generate a new line at the end, so that it is easy to determine where the JWT ends.

The contents will be similar to this:

Bash
    
xxxxxxxxxx
 
export LIGHTOS_JWT=eyJhbGciOiJSUzI1Ni<...CONTENTS OF JWT...>5PcYPBRBaFEuMsT9gQNQA
Copy

The contents of a JWT are long and all are on a single line.

Log in to any Lightbits server and paste the contents into the shell. The JWT will now be available via the $LIGHTOS_JWT environment variable.
Check the state of the servers, nodes, and cluster.

The servers look healthy as they all state "NoRiskOfServiceLoss":

Bash
    
xxxxxxxxxx
 
server00:~$ lbcli -J $LIGHTOS_JWT list serversNAME       UUID                                 State     RiskOfServiceLoss State   LightOSVersionserver00   5c2b7375-64fa-583e-8ebe-e82b8e1e1a53   Enabled   NoRiskOfServiceLoss       3.1.2~b1125server01   bb5433d2-9740-5130-a5eb-47f623c19b4d   Enabled   NoRiskOfServiceLoss       3.1.2~b1125server02   a9097bf0-6005-5dca-8f07-eeaca114ec70   Enabled   NoRiskOfServiceLoss       3.1.2~b1125
Copy

The nodes also look healthy, as they all state to be "Active":

Bash
    
xxxxxxxxxx
 
server00:~$ lbcli -J $LIGHTOS_JWT list nodesName      UUID              State     NVMe endpoint     Failure domains     Local rebuild progressserver00-0   d2c336f2-c9e5-5a4c-951e-ede739d10774   Active    10.10.10.100:4420   [server00]        Noneserver01-0   810ed593-a97b-5495-b08a-be5e37a65f82   Active    10.10.10.101:4420   [server01]        Noneserver02-0   2cf6ce67-fe5e-5a98-86bf-98a5792a8916   Active    10.10.10.102:4420   [server02]        None
Copy

Also check that the cluster health state is ok:

Bash
    
xxxxxxxxxx
 
server00:~$ lbcli -J $LIGHTOS_JWT get cluster -o yamlETag: "0"MaxAllowedVersion: 3.2.XMinAllowedVersion: 3.1.XMinVersionInCluster: 3.1.2~b1125UUID: c2719be6-00b8-4e96-b80a-6a84ecc3e638apiEndpoints:- 10.10.10.100:443- 192.168.16.22:443- 10.10.10.101:443- 192.168.16.92:443- 10.10.10.102:443- 192.168.16.32:443clusterName: c2719be6-00b8-4e96-b80a-6a84ecc3e638currentMaxReplicas: 3discoveryEndpoints:- 10.10.10.100:8009- 10.10.10.101:8009- 10.10.10.102:8009health:  numDegradedVolumes: 0  numInactiveNodes: 0  numNotAvailableVolumes: 0  numReadOnlyVolumes: 0  state: OK  <------------------------------------------ health state is OKstatistics:  compressionRatio: 1  effectivePhysicalStorage: "52311333273"  estimatedFreeLogicalStorage: "41226327633"  estimatedLogicalStorage: "51963745873"  freePhysicalStorage: "41490028953"  installedPhysicalStorage: "94489280512"  logicalStorage: "16106127360"  logicalUsedStorage: "10737418240"  managedPhysicalStorage: "60129542144"  physicalUsedStorage: "10821304320"  physicalUsedStorageIncludingParity: "10821304320"subsystemNQN: nqn.2016-01.com.lightbitslabs:uuid:2304a078-e5d0-40e8-94d6-3656d24d1337:suffixsupportedMaxReplicas: 3
Copy

At this point the cluster's health has been confirmed at the node, server, and cluster level.

Last updated on

Was this page helpful?