Skip to content

🌐 Install EdgeHit Controller

πŸͺœ Installation Step

Note

All the following procedure is based on Production Environement. You need to read the previous section on how to tweak the settings to match Testing Environment

  1. Set Environment Variables & Secrets

    Make sure these variables are set correctly in your environment before proceeding with the installation. You can refer to the command below:

    export DASH_SERVER_DOMAIN='<domain name of target installation server>'
export REGISTRY_PASSWORD='<SECRET>'

  2. CURL & Run the Installation Script 

    bash -c "$(curl -fsSL https://files.ops2.net/edgehit/prod/edgehit-controller/deploy/install.sh)"

  3. Once the installation is done. You can access the Web Dashboard at Domain Name of Target Machine.

    • Installation info and administrative tools will be stored in /usr/local/edgehit/EdgeHit-Controller/ the directory content will be similiar as below:
        EdgeHit-Controller/
    β”œβ”€β”€.env
    β”œβ”€β”€install-info.txt
    β”œβ”€β”€compose.yml
    β”œβ”€β”€bin/
    β”‚ β”œβ”€β”€ bash Scripts
    β”‚ └── more bash Scripts 
    β”œβ”€β”€install-EdgeHit.sh
    β”œβ”€β”€install-prometheus.sh        
    β”‚.....

    • .env contain secret value that is mounted to docker container runtime

    • install-info.txt contain info such as web dashboard URL and default password

    • bin/ directory contain bash script for administative action such as update and backup actions.

    • install-EdgeHit.sh is the script generated during EdgeHit Controller installation. It is meant to be run on a remote server to install Load Proxy with predefined secret and server role

    • install-prometheus.sh is the script generated during EdgeHit Controller installation. It is meant to be run on a remote server to install Prometheus Server with predefined prometheus job and target with defined HTTP AUTH key.

  4. Copy the generated Script for installing other component

    After the installation, EdgeHit Controller will Generate Script to install Load Proxy and Prometheus in the default directory. Copy the script out for future use case.

    On Local Terminal
    scp root@<EdgeHit-Controller>:/usr/local/edgehit/EdgeHit-Controller/install-prometheus.sh /path/to/local/destination
scp root@<EdgeHit-Controller>:/usr/local/edgehit/EdgeHit-Controller/install-EdgeHit.sh /path/to/local/destination

    Note

    it is strongly suggested to use the generated script in EdgeHit Controller to install managed Load Proxy as it predefine some secret value such as Redis Server TLS Certificate and password.