diff --git a/site/content/installation-upgrade/installation-oss.md b/site/content/installation-upgrade/installation-oss.md index e730d6fbc..a160fcdab 100644 --- a/site/content/installation-upgrade/installation-oss.md +++ b/site/content/installation-upgrade/installation-oss.md @@ -28,7 +28,8 @@ Before you install NGINX Agent for the first time on your system, you need to se - [Installing NGINX Agent on Debian](#installing-nginx-agent-on-debian) - [Installing NGINX Agent on SLES](#installing-nginx-agent-on-sles) - [Installing NGINX Agent on Alpine Linux](#installing-nginx-agent-on-alpine-linux) -- [Installing NGINX Agent on Amazon Linux](#installing-nginx-agent-on-amazon-linux) +- [Installing NGINX Agent on Amazon Linux 2](#installing-nginx-agent-on-amazon-linux-2) +- [Installing NGINX Agent on Amazon Linux 2023](#installing-nginx-agent-on-amazon-linux-2023) - [Installing NGINX Agent on FreeBSD](#installing-nginx-agent-on-freebsd) ### Installing NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux @@ -292,7 +293,43 @@ Before you install NGINX Agent for the first time on your system, you need to se sudo nginx-agent -v ``` -### Installing NGINX Agent on Amazon Linux +### Installing NGINX Agent on Amazon Linux 2023 + +1. Install the prerequisites: + + ```shell + sudo dnf install yum-utils procps-ng + ``` + +1. To set up the dnf repository for Amazon Linux 2023, create the file named `/etc/yum.repos.d/nginx-agent.repo` with the following contents: + ``` + [nginx-agent] + name=nginx agent repo + baseurl=https://packages.nginx.org/nginx-agent/amzn/2023/$basearch/ + gpgcheck=1 + enabled=1 + gpgkey=https://nginx.org/keys/nginx_signing.key + module_hotfixes=true + ``` + +1. To install `nginx-agent`, run the following command: + + ```shell + sudo dnf install nginx-agent + ``` + +1. When prompted to accept the GPG key, verify that the fingerprint matches + `8540 A6F1 8833 A80E 9C16 53A4 2FD2 1310 B49F 6B46`, + `573B FD6B 3D8F BC64 1079 A6AB ABF5 BD82 7BD9 BF62`, + `9E9B E90E ACBC DE69 FE9B 204C BCDC D8A3 8D88 A2B3` + and if so, accept it. + +1. Verify the installation: + + ```shell + sudo nginx-agent -v + ``` +### Installing NGINX Agent on Amazon Linux 2 1. Install the prerequisites: diff --git a/site/content/installation-upgrade/installation-plus.md b/site/content/installation-upgrade/installation-plus.md index 56343e879..952013241 100644 --- a/site/content/installation-upgrade/installation-plus.md +++ b/site/content/installation-upgrade/installation-plus.md @@ -31,6 +31,7 @@ Before you install NGINX Agent for the first time on your system, you need to se - [Installing NGINX Agent on Debian](#installing-nginx-agent-on-debian) - [Installing NGINX Agent on SLES](#installing-nginx-agent-on-sles) - [Installing NGINX Agent on Alpine Linux](#installing-nginx-agent-on-alpine-linux) +- [Installing NGINX Agent on Amazon Linux 2023](#installing-nginx-agent-on-amazon-linux-2023) - [Installing NGINX Agent on Amazon Linux](#installing-nginx-agent-on-amazon-linux) - [Installing NGINX Agent on FreeBSD](#installing-nginx-agent-on-freebsd) @@ -353,7 +354,55 @@ Before you install NGINX Agent for the first time on your system, you need to se sudo nginx-agent -v ``` -### Installing NGINX Agent on Amazon Linux +### Installing NGINX Agent on Amazon Linux 2023 + +1. Create the `/etc/ssl/nginx` directory: + + ```shell + sudo mkdir -p /etc/ssl/nginx + ``` + +1. Log in to [MyF5 Customer Portal](https://account.f5.com/myf5/) and download your `nginx-repo.crt` and `nginx-repo.key` files. + +1. Copy the `nginx-repo.crt` and `nginx-repo.key` files to the `/etc/ssl/nginx/` directory: + + ```shell + sudo cp nginx-repo.crt nginx-repo.key /etc/ssl/nginx/ + ``` + +1. Install the prerequisites: + + ```shell + sudo dnf install yum-utils procps-ng ca-certificates + ``` + +1. To set up the dnf repository for Amazon Linux 2023, create the file named `/etc/yum.repos.d/nginx-agent.repo` with the following contents: + + ``` + [nginx-agent] + name=nginx-agent repo + baseurl=https://packages.nginx.org/nginx-agent/amzn/2023/$basearch/ + sslclientcert=/etc/ssl/nginx/nginx-repo.crt + sslclientkey=/etc/ssl/nginx/nginx-repo.key + gpgcheck=0 + enabled=1 + ``` + +1. To install `nginx-agent`, run the following command: + + ```shell + sudo dnf install nginx-agent + ``` + +1. When prompted to accept the GPG key, verify that the fingerprint matches `573B FD6B 3D8F BC64 1079 A6AB ABF5 BD82 7BD9 BF62`, and if so, accept it. + +1. Verify the installation: + + ```shell + sudo nginx-agent -v + ``` + +### Installing NGINX Agent on Amazon Linux 2 1. Create the `/etc/ssl/nginx` directory: @@ -380,7 +429,7 @@ Before you install NGINX Agent for the first time on your system, you need to se ``` [nginx-agent] name=nginx-agent repo - baseurl=https://pkgs.nginx.com/nginx-agent/amzn2/$releasever/$basearch + baseurl=https://pkgs.nginx.com/nginx-agent/amzn/2023/$releasever/$basearch sslclientcert=/etc/ssl/nginx/nginx-repo.crt sslclientkey=/etc/ssl/nginx/nginx-repo.key gpgcheck=0 diff --git a/site/content/installation-upgrade/uninstall.md b/site/content/installation-upgrade/uninstall.md index 58e75c4e1..49184df82 100644 --- a/site/content/installation-upgrade/uninstall.md +++ b/site/content/installation-upgrade/uninstall.md @@ -114,7 +114,7 @@ Complete the following steps on each host where you've installed NGINX agent: sudo apk del nginx-agent ``` -### Uninstalling NGINX Agent on Amazon Linux +### Uninstalling NGINX Agent on Amazon Linux 2 Complete the following steps on each host where you've installed NGINX agent: @@ -130,6 +130,21 @@ Complete the following steps on each host where you've installed NGINX agent: sudo yum remove nginx-agent ``` +### Uninstalling NGINX Agent on Amazon Linux 2023 + +Complete the following steps on each host where you've installed NGINX agent: + +1. Stop NGINX agent: + + ```bash + sudo systemctl stop nginx-agent + ``` + +2. To uninstall NGINX agent, run the following command: + + ```bash + sudo dnf remove nginx-agent + ``` ### Uninstalling NGINX Agent on FreeBSD Complete the following steps on each host where you've installed NGINX agent: