How to install Hyperglance on your own Instance or VM

The Hyperglance installer uses the Hyperglance CLI to install on your remote instance.

General Pre-Requisites (Local)

1. Docker Installed and Running on your LOCAL system. We ship updates to the Hyperglance cli via docker containers and docker hub.
2. SSH access to the deployment target to upload the installer and associated tooling. If using the hg install remote command, you will also need the SSH private key and user that has root permissions.

General Pre-Requisites (Remote / Deployment Target)

1. The Hyperglance CLI will require access to the internet. The installer reaches out to a number of locations to acquire all the components for both the Kubernetes runtime (RKE2) as well as any pre-requisites.

Deployment instructions

Install Remotely To Host

1. Pull and run the latest Hyperglance CLI container. Replace PATH_TO_SSH_KEY with the correct path to the ssh you will use to connect to the remote instance.
   
   

   docker run --rm -it --pull always -v PATH_TO_SSH_KEY:/app/key.pem hyperglance/updatetool:latest

   This will place you in the containers bash shell.
   
   
2. [Optional] Test connectivity and provided user credentials against the remote host.
   
   Replace SERVER_IP, YOUR_USERNAME and SSH_PORT with the correct values. The --key can remain as-is as we mapped it to this in the previous command.
   

   hg install remote --address SERVER_IP --username YOUR_USERNAME --port SSH_PORT --key key.pem --test

   Example usage and successful connection is shown below:

   root@47aeb54424fb:/app# hg install remote --address 44.201.49.121 --username ubuntu --port 22 --key key.pem --test
   The authenticity of host '44.201.49.121 (44.201.49.121)' can't be established.
   ED25519 key fingerprint is SHA256:unsW4k+ROzCHbpg/YRimFr1DjgZ4UufRAkGJhaVhbkg.
   This key is not known by any other names
   Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
   [INFO] Connectivity and permissions test passed!

    

3. Run the installation.
   
   Replace SERVER_IP, YOUR_USERNAME and SSH_PORT with the correct values. The --key can remain as-is as we mapped it to this in the previous command.

   hg install remote --address SERVER_IP --username YOUR_USERNAME --port SSH_PORT --key key.pem --confirm

    

4. A successful run will show

   [INFO] 
      _____ _    _  _____ _____ ______  _____ _____ _ 
     / ____| |  | |/ ____/ ____|  ____|/ ____/ ____| |
    | (___ | |  | | |   | |    | |__  | (___| (___ | |
     \___ \| |  | | |   | |    |  __|  \___ \\___ \| |
     ____) | |__| | |___| |____| |____ ____) |___) |_|
    |_____/ \____/ \_____\_____|______|_____/_____/(_)
   
   Please wait while the remote instance is rebooted.

    

Install Directly On Remote Host

1. Pull the latest Hyperglance CLI container, and extract the CLI and related tooling.

    

   docker create --name hg_cli hyperglance/updatetool:latest && \
   docker cp hg_cli:/app/. ./ && \
   docker rm hg_cli && \
   rm ./upgrade.sh

   This will extract: 
   1. hg
   2. hg-cli-updater
   3. hg-cli-log-viewer
   4. ansible-playbook.pyz
2. Upload these files to your own vm and place them under the /usr/local/bin directory.
3. Ensure these are all executable:
   

   sudo chmod +x /usr/local/bin/hg /usr/local/bin/hg-cli-updater /usr/local/bin/hg-cli-log-viewer /usr/local/bin/ansible-playbook.pyz

    

4. Start the installation:
   

   sudo /usr/local/bin/hg install local --accept

5. A Successful run will show:
   

   [INFO] 
      _____ _    _  _____ _____ ______  _____ _____ _ 
     / ____| |  | |/ ____/ ____|  ____|/ ____/ ____| |
    | (___ | |  | | |   | |    | |__  | (___| (___ | |
     \___ \| |  | | |   | |    |  __|  \___ \\___ \| |
     ____) | |__| | |___| |____| |____ ____) |___) |_|
    |_____/ \____/ \_____\_____|______|_____/_____/(_)
   
   Please reboot to finalise the installation.

    

6. Reboot

   sudo reboot now

    

DONE! Hyperglance should now be available using the IP / DNS Name of the host. 

Apply the Hyperglance licence: https://support.hyperglance.com/knowledge/how-to-apply-a-new-license.