Merge pull request #759 from nginx/smoloney/docs-update

Add instructions for Amazon Linux 2023

Author: nginx-seanmoloney

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:
 

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

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: