Install the Global Profiling Engine on HAProxy Enterprise

The following section gives detailed information on how to install the Global Profiling Engine.

Install steps Jump to heading #

To install the Global Profiling Engine:

1. Provision a server on which you will install the Global Profiling Engine.

2. On the new server, add package repositories for your operating system.

   debian ubuntu RHEL

   In a terminal window, set a variable named key to your HAProxy Enterprise license key.

   nix
   key=<HAProxy Enterprise Key>

   nix
   key=<HAProxy Enterprise Key>

   Use the echo and tee commands to add the HAProxy Technologies extras repository location into the file /etc/apt/sources.list.d/haproxy-tech.list, as shown below.

   nix
   echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/HAPEE-key-3.0r1.asc] https://www.haproxy.com/download/hapee/key/${key}-plus/extras/debian-$(. /etc/os-release && echo "$VERSION_CODENAME")/amd64/ $(. /etc/os-release && echo "$VERSION_CODENAME") main" | sudo tee -a /etc/apt/sources.list.d/haproxy-tech.list

   nix
   echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/HAPEE-key-3.0r1.asc] https://www.haproxy.com/download/hapee/key/${key}-plus/extras/debian-$(. /etc/os-release && echo "$VERSION_CODENAME")/amd64/ $(. /etc/os-release && echo "$VERSION_CODENAME") main" | sudo tee -a /etc/apt/sources.list.d/haproxy-tech.list

   The packages that HAProxy Technologies provides are signed. To install them, import the public keys:

   nix
   sudo mkdir -p /etc/apt/keyrings
   sudo curl -s -L "https://pks.haproxy.com/linux/enterprise/HAPEE-key-3.0r1.asc" -o /etc/apt/keyrings/HAPEE-key-3.0r1.asc
   sudo curl -s -L "https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc" -o /etc/apt/keyrings/HAPEE-key-extras.asc

   nix
   sudo mkdir -p /etc/apt/keyrings
   sudo curl -s -L "https://pks.haproxy.com/linux/enterprise/HAPEE-key-3.0r1.asc" -o /etc/apt/keyrings/HAPEE-key-3.0r1.asc
   sudo curl -s -L "https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc" -o /etc/apt/keyrings/HAPEE-key-extras.asc

   In a terminal window, set a variable named key to your HAProxy Enterprise license key.

   nix
   key=<HAProxy Enterprise Key>

   nix
   key=<HAProxy Enterprise Key>

   Use the echo and tee commands to add the HAProxy Technologies extras repository location into the file /etc/apt/sources.list.d/haproxy-tech.list, as shown below.

   nix
   echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/HAPEE-key-3.0r1.asc] https://www.haproxy.com/download/hapee/key/${key}-plus/extras/ubuntu-$(. /etc/os-release && echo "$VERSION_CODENAME")/amd64/ $(. /etc/os-release && echo "$VERSION_CODENAME") main" | sudo tee -a /etc/apt/sources.list.d/haproxy-tech.list

   nix
   echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/HAPEE-key-3.0r1.asc] https://www.haproxy.com/download/hapee/key/${key}-plus/extras/ubuntu-$(. /etc/os-release && echo "$VERSION_CODENAME")/amd64/ $(. /etc/os-release && echo "$VERSION_CODENAME") main" | sudo tee -a /etc/apt/sources.list.d/haproxy-tech.list

   The packages that HAProxy Technologies provides are signed. To install them, import the public keys:

   nix
   sudo mkdir -p /etc/apt/keyrings
   sudo curl -s -L "https://pks.haproxy.com/linux/enterprise/HAPEE-key-3.0r1.asc" -o /etc/apt/keyrings/HAPEE-key-3.0r1.asc
   sudo curl -s -L "https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc" -o /etc/apt/keyrings/HAPEE-key-extras.asc

   nix
   sudo mkdir -p /etc/apt/keyrings
   sudo curl -s -L "https://pks.haproxy.com/linux/enterprise/HAPEE-key-3.0r1.asc" -o /etc/apt/keyrings/HAPEE-key-3.0r1.asc
   sudo curl -s -L "https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc" -o /etc/apt/keyrings/HAPEE-key-extras.asc

   Create a new file /etc/yum.repos.d/haproxy-tech.repo if it does not exist and add the contents below. Replace <HAProxy Enterprise Key> with the key you were given when you registered. Also replace rhel-8 with your RHEL version number.

   haproxy-tech.repo
   ini
   [hapee-plus-extras]
   name=hapee-plus-extras
   enabled=1
   baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/extras/rhel-8/$basearch/bin/
   gpgcheck=1

   haproxy-tech.repo
   ini
   [hapee-plus-extras]
   name=hapee-plus-extras
   enabled=1
   baseurl=https://www.haproxy.com/download/hapee/key/<HAProxy Enterprise Key>-plus/extras/rhel-8/$basearch/bin/
   gpgcheck=1

3. Install packages:

   debian ubuntu RHEL

   Update the repository cache and install required dependencies:

   nix
   sudo apt-get update
   sudo apt-get install --yes apt-transport-https curl dirmngr gnupg-agent grep
   sudo apt-get install --yes hapee-extras-gpe10

   nix
   sudo apt-get update
   sudo apt-get install --yes apt-transport-https curl dirmngr gnupg-agent grep
   sudo apt-get install --yes hapee-extras-gpe10

   Update the repository cache and install required dependencies:

   nix
   sudo apt-get update
   sudo apt-get install --yes apt-transport-https curl dirmngr gnupg-agent grep
   sudo apt-get install --yes hapee-extras-gpe10

   nix
   sudo apt-get update
   sudo apt-get install --yes apt-transport-https curl dirmngr gnupg-agent grep
   sudo apt-get install --yes hapee-extras-gpe10

   nix
   rpm --import https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc
   yum makecache
   yum install -y hapee-extras-gpe10

   nix
   rpm --import https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc
   yum makecache
   yum install -y hapee-extras-gpe10

4. To start the Global Profiling Engine, run:

   nix
   sudo systemctl enable hapee-extras-gpe
   sudo systemctl start hapee-extras-gpe

   nix
   sudo systemctl enable hapee-extras-gpe
   sudo systemctl start hapee-extras-gpe

Check your current version Jump to heading #

To check which version of GPE you are running, call the hapee-gpe command with the -v flag:

nix
/opt/hapee-extras/sbin/hapee-gpe -v

nix
/opt/hapee-extras/sbin/hapee-gpe -v

Manage the service Jump to heading #

Start, stop and check the status of the Global Profiling Engine service by using the corresponding systemctl commands.

Start the service:

nix
sudo systemctl start hapee-extras-gpe

nix
sudo systemctl start hapee-extras-gpe

Restart the service:

nix
sudo systemctl restart hapee-extras-gpe

nix
sudo systemctl restart hapee-extras-gpe

Show current status:

nix
sudo systemctl status hapee-extras-gpe

nix
sudo systemctl status hapee-extras-gpe

Stop the service:

nix
sudo systemctl stop hapee-extras-gpe

nix
sudo systemctl stop hapee-extras-gpe