How to install Hyperglance on your own Instance or VM

If you need to install Hyperglance on your own hardened/golden VM, follow these instructions

The Hyperglance installer uses Ansible and Docker to install Hyperglance to your own Instance/VM. 

General Pre-Requisites

1. Docker Installed and Running on the system you're running the installer from.

2. python - Found on most *nix based systems
3. Access to the SSH key to access the target host.

The Hyperglance Installer takes care of all other pre-requisites on the target host, including docker installation.

Deployment instructions

This deployment should be run from any system that has ssh access to the target. Do NOT run it on the same machine that you are installing to. Execute the deployment from a remote system, or control node where your private key(s) already resides.

Deploy Hyperglance remotely to your target instance

This method will use a docker container to deploy Hyperglance to another system that you have SSH access to.

From your "local" machine perform the following commands to start the deployment:

1. docker pull hyperglance/hyperglance_installer

2. Create an inventory file:

   touch inventory 

3. Populate this file with the following content, replace the IP Address with the target IP, and change the ansible_user. Do not change the private_key_file path in this file (see next step).
   

   [hg]
   HOST_IP OR DNS NAME
   
   [all:vars]
   ansible_user=<SSH username>
   ansible_ssh_private_key_file=~/.ssh/id_rsa

4.  Execute the following command. Make sure to adjust key path binding if necessary (if your key is not ~/.ssh./id_rsa) and map it to /root/.ssh/id_rsa in the container:

For example:
-v ~/.ssh/MY_KEY:/root/.ssh/id_rsa

docker run --rm -it \
 -v ~/.ssh/id_rsa:/root/.ssh/id_rsa \
 -v $(pwd)/inventory:/ansible/playbooks/inventory \
 hyperglance/hyperglance_installer:latest deploy.yml -i inventory

5. You will see some output from the container as it deploys, failed=0 is a good sign of success

PLAY RECAP *******************************************************************************************************************************************************************************
ip-172-31-30-191 : ok=14 changed=8 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0 

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.