Starting a Local Cluster

In this section, we describe how to set up a local environment for testing your application with the Genvid MILE SDK integration.

Before You Begin

  1. Make sure you have the following tools necessary for SDK integration: * Python v3.10.6 * AWS CLI for Amazon * Azure CLI for Azure * Tight VNC * GIT

    Note

    The above mentioned tools can also be installed with the help of the Global Packages included with the Genvid Toolbox installer, with the exception of Azure CLI which is currently not offered in the installer.

  2. Install the Genvid Toolbox.

  3. Make sure it’s included in your PATH.

  4. Install the Genvid MILE SDK.

Initializing a Local Cluster

At the command line in your shell window:

  1. Install a bastion server.

    genvid-bastion install -lmu -b {mybastion}

    This command sets up the supervisor servers and runs the Genvid bastion-api services on them. See the genvid-bastion reference for more information on what this script does.

    Changed in version 1.20.0: Creating a local cluster is now an option when running genvid-bastion install. It no longer automatically creates it by default. Run the genvid-sdk setup to create a local cluster.

    mybastion is a unique identifier for your bastion server. It must:

    • Be between 3 and 32 characters.

    • Only contain lowercase letters, numbers, or hyphens.

    • Start with a letter.

    The supervisor servers use a working directory under ~/.genvid. You can change this location by setting GENVID_SERVICES_DATADIR environment variable to another valid directory.

    Note

    Although most of the data is written under the GENVID_SERVICES_DATADIR, the current implementation isn’t able to transfer everything to this specific working directory. Some data, like the Terraform’s workdir, must be located next to the Terraform configuration files under bastion-services/terraform under the installation directory.

Your local Bastion is now ready to be used.

For steps on building and loading a cluster, see the Initialize Your Local Cluster section of the Genvid MILE SDK documentation.

All other genvid-bastion commands are available in the genvid-bastion reference page.