Prepare AxoRouter hosts
If you use AxoRouter with an on-premises AxoConsole deployment, complete the following steps on the hosts where you want to deploy AxoRouter. You don’t need these steps if you use the SaaS AxoConsole.
Run the generated prepare-host script
After a successful AxoConsole installation, the installer writes a prepare-axorouter-host.sh script to the log directory on the AxoConsole host. This script automates all the steps below.
-
Copy the script to each AxoRouter or Axoflow agent host.
-
Run it as root:
Terminal window sudo bash prepare-axorouter-host.shThe script adds the AxoConsole base hostname and its
kcp.andtelemetry.subdomains to/etc/hosts, and installs the AxoConsole CA certificate into the system trust store. The script doesn’t add theidp.subdomain. If you use Dex as the authentication provider, add it to/etc/hostsyourself.
Manual preparation
If the prepare-host script is not available, complete the following steps manually.
-
If the AxoRouter host can’t resolve the domain name of AxoConsole, add the domain name to the
/etc/hostsfile of the AxoRouter host. Use the following format, with an IP address of AxoConsole that the AxoRouter host can access.Terminal window <AXOFLOW-CONSOLE-IP-ADDRESS> <AXOFLOW-CONSOLE-BASE-URL> kcp.<AXOFLOW-CONSOLE-BASE-URL> telemetry.<AXOFLOW-CONSOLE-BASE-URL> -
Import AxoConsole certificates to AxoRouter hosts.
-
On the AxoConsole host: Run the following command to extract the AxoConsole CA certificate. The AxoRouter host needs this certificate to download the installation binaries.
Terminal window kubectl get secret -n axoflow axoflow-local-root-ca -o jsonpath='{.data.ca\.crt}' | base64 -d > axoflow-ca.crtCopy this file to the AxoRouter hosts.
-
On the AxoRouter hosts: Copy the certificate file extracted from the AxoConsole host.
- On Red Hat: Copy the files into the
/etc/pki/ca-trust/source/anchors/folder, then runsudo update-ca-trust extract. If needed, install theca-certificatespackage first. - On Ubuntu: Copy the files into the
/usr/local/share/ca-certificates/folder, then runsudo update-ca-certificates.
- On Red Hat: Copy the files into the
-
-
Run
curl -I https://<your-host.your-domain>. The response must beHTTP/2 200. -
Now you can deploy AxoRouter on the host .
Note If you want to download the AxoRouter images directly from AxoConsole (useful in air-gapped environments), disable the External image pull option of the provisioning script.