Configuring Lightbits AVS

This section will walk through the process of setting up the LBAVS tool on the Lightbits nodes VM.

For a video tutorial, please see the section Chapter 5: Configuring the LBAVS Tool in the AVS video series.

Setting Up the LBAVS Configuration File

1. SSH into one of the Lightbits instances in the VMSS.
2. Navigate to /etc/lbavs/lbavs.yaml and open it with your favorite test editor such as vim or nano.
3. Copy the contents of the file below, replacing the following parameters:

${SUBSCRIPTION_ID}: The ID of the subscription where the AVS SDDC is installed.

${SDDC_NAME}: The name of the AVS private cloud that Lightbits will connect to.

${SDDC_RESOURCE_GROUP}: The name of the resource group that the AVS private cloud is deployed into.

${LIGHTBITS_MGMT_IP}: The IP address to access the Lightbits REST API. To get this IP address, see Find Private Management and Discovery Address in the Azure Managed Application Installation Guide.

${LIGHTBITS_JWT}: The JWT of the Lightbits cluster for authentication. To get the JWT, see Get the System JWT from Azure Portal.

azure-subscription-id: ${SUBSCRIPTION_ID}

avss:

  - name: azavs 

    avs: ${SDDC_NAME}

    group: ${SDDC_RESOURCE_GROUP}

    useManagedIdentity: Yes

    managedIdentity:

      url: http://169.254.169.254/metadata/identity/oauth2/token

      apiVersion: "2018-02-01"

default-avs: azavs

​

lbcs:

  - name: lbc1

    endpoint: https://${LIGHTBITS_MGMT_IP}:443

    jwt: ${LIGHTBITS_JWT}

default-lbc: lbc1

4. Save the file.

Testing the Tool Setup

1. Create the log file to edit permissions: touch /var/log/lbavs.log
2. Change the permissions on that file to avoid having to run lbavs with sudo: chmod 755 /var/log/lbavs.log
3. When running the tool the first time, it is recommended to monitor the LBAVS logs. In another SSH session, run:

tail -f /var/log/lbavs.log

2. List datastores: the ${SDDC_CLUSTER_NAME} parameter is the name of the cluster in the AVS SDDC. By default, there is a cluster called Cluster-1:

lbavs datastore list -v ${SDDC_CLUSTER_NAME}

3. The response to list datastores should be No datastores.