Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add instructions for Amazon Linux 2023 #759

Merged
merged 9 commits into from
Aug 6, 2024
41 changes: 39 additions & 2 deletions site/content/installation-upgrade/installation-oss.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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:

Expand Down
53 changes: 51 additions & 2 deletions site/content/installation-upgrade/installation-plus.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand Down Expand Up @@ -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
nginx-seanmoloney marked this conversation as resolved.
Show resolved Hide resolved
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:

Expand All @@ -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
nginx-seanmoloney marked this conversation as resolved.
Show resolved Hide resolved
Expand Down
17 changes: 16 additions & 1 deletion site/content/installation-upgrade/uninstall.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:

Expand All @@ -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:
Expand Down
Loading