Set Up/Configure lbcli from a Non-Lightbits Server

lbcli is a Lightbits management command that operates over gRPC API. It is present on all Lightbits servers. Because it operates over an API and is statically compiled, it can be easily ported to any server as it operates.

Follow the instructions below to install and configure the lbcli tool on any non-Lightbits server, in order to manage your Lightbits cluster using its API.

Installation

1. Prepare the Lightbits repository on your Lightbits client server.

• For RPM-based systems (RHEL, Alma, Rocky, etc.), follow the instructions here: $link[page,427229,auto$].
• For Deb-based systems (Ubuntu, Debian, etc.), follow the instructions here: $link[page,427228,auto$].

2. Install LBCLI with the following commands:

• For RPM-based systems: yum install management-lbcli
• For Deb-based systems: apt-get install management-lbcli

Configuration

1. Edit the following file with your preferred text editor:vim /etc/lbcli/lbcli.yaml

Content:

2. Replace LIGHTBITS-SERVER with the IP or hostname of any Lightbits server.
3. Add the “jwt:” parameter at the bottom. Put the entire JWT - as a single line - into PLACE-JWT-HERE. Note that after pasting the lengthy JWT, if your editor wraps text, it might appear as multi-line; make sure it is a single line.

Test and Run

1. Run lbcli version to see the current version of the lbcli command.
2. Verify that it can query the cluster by doing a listing of the nodes: $link[page,427151,auto$].

Updating lbcli

When the Lightbits cluster gets upgraded to a newer version, be sure to update the client's lbcli version by running steps 1 and 2 from the Installation section above. This will update the client's old lbcli with the Lightbits server's newer lbcli command.