Global Profiling Engine

Install the Global Profiling Engine on HAProxy Enterprise

This page applies to:

  • HAProxy Enterprise - all versions

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.

    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-extras.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-extras.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 key:

    nix
    sudo apt-get update
    sudo apt-get install --yes apt-transport-https curl dirmngr gnupg-agent grep
    sudo mkdir -p /etc/apt/keyrings
    sudo curl -s -L "https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc" -o /etc/apt/keyrings/HAPEE-key-extras.asc
    nix
    sudo apt-get update
    sudo apt-get install --yes apt-transport-https curl dirmngr gnupg-agent grep
    sudo mkdir -p /etc/apt/keyrings
    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-extras.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-extras.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 key:

    nix
    sudo apt-get update
    sudo apt-get install --yes apt-transport-https curl dirmngr gnupg-agent grep
    sudo mkdir -p /etc/apt/keyrings
    sudo curl -s -L "https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc" -o /etc/apt/keyrings/HAPEE-key-extras.asc
    nix
    sudo apt-get update
    sudo apt-get install --yes apt-transport-https curl dirmngr gnupg-agent grep
    sudo mkdir -p /etc/apt/keyrings
    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

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

    nix
    rpm --import https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc
    nix
    rpm --import https://pks.haproxy.com/linux/enterprise/HAPEE-key-extras.asc
  3. Install packages:

    Update the repository cache and install required dependencies:

    nix
    sudo apt-get install --yes hapee-extras-gpe10
    nix
    sudo apt-get install --yes hapee-extras-gpe10

    Update the repository cache and install required dependencies:

    nix
    sudo apt-get install --yes hapee-extras-gpe10
    nix
    sudo apt-get install --yes hapee-extras-gpe10
    nix
    yum makecache
    yum install -y hapee-extras-gpe10
    nix
    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

Do you have any suggestions on how we can improve the content of this page?