Cluster Management

Managing the cluster is principally accomplished via Glasshouse, the management GUI, together with the Cloud Management GUI. In some cases, the user will need to SSH in to the dashboard console or host consoles.

The dashboard IP & cluster admin password are specified in the dashboard configuration step of the Installation guide.

Glasshouse Management GUI

Glasshouse can be accessed from the browser: https://<dashboard IP>/

Log into Glasshouse to create, manage, and share Virtual Machines.

Cloud Management GUI

This form is used to manage the VM Squared properties including: - Dashboard network configuration - VM Squared license file - SSH authorized keys

Open a new browser tab and navigate to https://<dashboard_ip>/cloudmanagement/
Edit the appropriate field
Click the Update Cluster Configuration button to apply.

Dashboard Console

The dashboard console is an alternate way to manage the VM Squared cluster.

To login to the dashboard console, an appropriate SSH key must first be added as one of the Cluster SSH Authorized Keys.

The dashboard IP is specified in the dashboard configuration step of the Installation guide.

Log in as root: ssh root@<dashboard IP>

~ % ssh root@10.127.4.18
Warning: Permanently added '10.127.4.18' (RSA) to the list of known hosts.
Welcome to your new VM Squared cluster!
Last login: Wed Mar 20 14:10:44 2024 from 192.168.11.225
Welcome to VMSquared!
Run "help" for supported commands

VMsquared:VM Squared Test\dashboard>

Cluster Authorized Keys

The Dashboard Console is authenticated using SSH keys. Add your public SSH key to the Cluster SSH Authorized Keys, or create a new key, using the following steps.

Open a new browser tab and navigate to https://<dashboard_ip>/cloudmanagement/.
Add the appropriate SSH keys to the Cluster SSH Authorized Keys text box.
Click the Update Cluster Configuration button to apply.

The new SSH keys will take a short time to propagate through the cluster.

Create a Public SSH Key

Before you can use key-based authentication, you will need to have a key on your own system.

UNIX

From your local machine's terminal, use the following command to create a private (id_rsa) and public (id_rsa.pub) key pair:

ssh-keygen -t rsa -b 4096

Where -t rsa enforces the RSA encryption algorithm and -b 4096 sets the key's length in bits.

You will be prompted to choose where to save the files and if you would like to protect the key with a passphrase. Press enter to skip these steps.

Once the command has finished, navigate to .ssh/id_rsa.pub and open the file in your text editor of choice.

Windows

You can generate an SSH key on Windows 10 or later using the ssh-keygen command.

Open a Powershell terminal window
Run ssh-keygen -b 4096
Enter the passphrase if desired, or hit Enter to continue without a passphrase
To get the contents of your public key, run get-content against the full path of the newly created public key

PS C:\Users\Administrator> ssh-keygen -b 4096
Generating public/private rsa key pair.
Enter file in which to save the key (C:\Users\Administrator/.ssh/id_rsa):
Created directory 'C:\Users\Administrator/.ssh'.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in C:\Users\Administrator/.ssh/id_rsa.
Your public key has been saved in C:\Users\Administrator/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:Kmos01FGD1/vYliJRwOczRQtoVwOlnNUk1MLgxU0p1M administrator@company
The key's randomart image is:
+---[RSA 4096]----+
|     .+O*OX+E    |
|    oo==X +O .   |
|* = o.o=ooo=   . |
|+O.o o o..o.     |
|   o   +S.       |
|  .   ..o .      |
| o .. .. .       |
|o +. .           |
| +.              |
+----[SHA256]-----+

Host Console

The host console is a limited way to manage some of the host-specific functions of the VM Squared cluster.

Host console access is typically through a hardware connection to the node. However, if the Dashboard is running then the ssh command is available as an alternative.

Example

Moving on you may wish to: