From cb6e110248d01d10ae1251e0f818f103ea517d19 Mon Sep 17 00:00:00 2001 From: nginx-seanmoloney Date: Mon, 21 Jul 2025 15:14:22 +0100 Subject: [PATCH 1/2] Add specific version instructions for NGINX Agent v2 installation --- .../installation-upgrade/installation-oss.md | 32 +++++++++---------- .../installation-upgrade/installation-plus.md | 28 ++++++++-------- content/agent/installation-upgrade/upgrade.md | 8 ++--- 3 files changed, 34 insertions(+), 34 deletions(-) diff --git a/content/agent/installation-upgrade/installation-oss.md b/content/agent/installation-upgrade/installation-oss.md index ab4016d08..7ef3081db 100644 --- a/content/agent/installation-upgrade/installation-oss.md +++ b/content/agent/installation-upgrade/installation-oss.md @@ -50,10 +50,10 @@ Before you install NGINX Agent for the first time on your system, you need to se module_hotfixes=true ``` -1. To install `nginx-agent`, run the following command: +1. To install `nginx-agent`, with a specific version (example: 2.42.0): ```shell - sudo yum install nginx-agent + sudo yum install -y nginx-agent-2.42.0 ``` 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. @@ -105,11 +105,11 @@ Before you install NGINX Agent for the first time on your system, you need to se | sudo tee /etc/apt/sources.list.d/nginx-agent.list ``` -1. To install `nginx-agent`, run the following commands: +1. To install `nginx-agent`, with a specific version (example: 2.42.0): ```shell sudo apt update - sudo apt install nginx-agent + sudo apt install -y nginx-agent=2.42.0~`lsb_release -cs` ``` 1. Verify the installation: @@ -166,11 +166,11 @@ Before you install NGINX Agent for the first time on your system, you need to se http://packages.nginx.org/nginx-agent/debian/ `lsb_release -cs` agent" \ | sudo tee /etc/apt/sources.list.d/nginx-agent.list ``` -1. To install `nginx-agent`, run the following commands: +1. To install `nginx-agent`, with a specific version (example: 2.42.0): ```shell sudo apt update - sudo apt install nginx-agent + sudo apt install -y nginx-agent=2.42.0~`lsb_release -cs` ``` 1. Verify the installation: @@ -229,10 +229,10 @@ Before you install NGINX Agent for the first time on your system, you need to se sudo rpmkeys --import /tmp/nginx_signing.key ``` -1. To install `nginx-agent`, run the following command: +1. To install `nginx-agent`, with a specific version (example: 2.42.0): ```shell - sudo zypper install nginx-agent + sudo zypper install -y nginx-agent=2.42.0 ``` 1. Verify the installation: @@ -303,10 +303,10 @@ Before you install NGINX Agent for the first time on your system, you need to se sudo mv /tmp/nginx_signing.rsa.pub /etc/apk/keys/ ``` -1. To install `nginx-agent`, run the following command: +1. To install `nginx-agent`, with a specific version (example: 2.42.0): ```shell - sudo apk add nginx-agent + sudo apk add nginx-agent=2.42.0 ``` 1. Verify the installation: @@ -334,10 +334,10 @@ Before you install NGINX Agent for the first time on your system, you need to se module_hotfixes=true ``` -1. To install `nginx-agent`, run the following command: +1. To install `nginx-agent`, with a specific version (example: 2.42.0): ```shell - sudo dnf install nginx-agent + sudo dnf install -y nginx-agent-2.42.0 ``` 1. When prompted to accept the GPG key, verify that the fingerprint matches @@ -370,10 +370,10 @@ Before you install NGINX Agent for the first time on your system, you need to se module_hotfixes=true ``` -1. To install `nginx-agent`, run the following command: +1. To install `nginx-agent`, with a specific version (example: 2.42.0): ```shell - sudo yum install nginx-agent + sudo yum install -y nginx-agent-2.42.0 ``` 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. @@ -396,10 +396,10 @@ Before you install NGINX Agent for the first time on your system, you need to se } ``` -1. To install `nginx-agent`, run the following command: +1. To install `nginx-agent`, with a specific version (example: 2.42.0): ```shell - sudo pkg install nginx-agent + sudo pkg install nginx-agent-2.42.0 ``` 1. Verify the installation: diff --git a/content/agent/installation-upgrade/installation-plus.md b/content/agent/installation-upgrade/installation-plus.md index add1272dc..fa6cc5209 100644 --- a/content/agent/installation-upgrade/installation-plus.md +++ b/content/agent/installation-upgrade/installation-plus.md @@ -73,10 +73,10 @@ Before you install NGINX Agent for the first time on your system, you need to se enabled=1 ``` -1. To install `nginx-agent`, run the following command: +1. To install `nginx-agent`, with a specific version (example: 2.42.0): ```shell - sudo yum install nginx-agent + sudo yum install -y nginx-agent-2.42.0 ``` 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. @@ -131,11 +131,11 @@ Before you install NGINX Agent for the first time on your system, you need to se | sudo tee /etc/apt/sources.list.d/nginx-agent.list ``` -1. To install `nginx-agent`, run the following commands: +1. To install `nginx-agent`, with a specific version (example: 2.42.0): ```shell sudo apt update - sudo apt install nginx-agent + sudo apt install -y nginx-agent=2.42.0~`lsb_release -cs` ``` 1. Verify the installation: @@ -183,11 +183,11 @@ Before you install NGINX Agent for the first time on your system, you need to se Acquire::https::pkgs.nginx.com::SslKey "/etc/ssl/nginx/nginx-repo.key"; ``` -1. To install `nginx-agent`, run the following commands: +1. To install `nginx-agent`, with a specific version (example: 2.42.0): ```shell sudo apt update - sudo apt install nginx-agent + sudo apt install -y nginx-agent=2.42.0~`lsb_release -cs` ``` 1. Verify the installation: @@ -265,10 +265,10 @@ Before you install NGINX Agent for the first time on your system, you need to se sudo rpmkeys --import /tmp/nginx_signing.key ``` -1. To install `nginx-agent`, run the following command: +1. To install `nginx-agent`, with a specific version (example: 2.42.0): ```shell - sudo zypper install nginx-agent + sudo zypper install -y nginx-agent=2.42.0 ``` 1. Verify the installation: @@ -394,10 +394,10 @@ Before you install NGINX Agent for the first time on your system, you need to se enabled=1 ``` -1. To install `nginx-agent`, run the following command: +1. To install `nginx-agent`, with a specific version (example: 2.42.0): ```shell - sudo dnf install nginx-agent + sudo dnf install -y nginx-agent-2.42.0 ``` 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. @@ -442,10 +442,10 @@ Before you install NGINX Agent for the first time on your system, you need to se enabled=1 ``` -1. To install `nginx-agent`, run the following command: +1. To install `nginx-agent`, with a specific version (example: 2.42.0): ```shell - sudo yum install nginx-agent + sudo yum install -y nginx-agent-2.42.0 ``` 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. @@ -496,10 +496,10 @@ Before you install NGINX Agent for the first time on your system, you need to se SSL_CLIENT_KEY_FILE: "/etc/ssl/nginx/nginx-repo.key" } ``` -1. To install `nginx-agent`, run the following command: +1. To install `nginx-agent`, with a specific version (example: 2.42.0): ```shell - sudo pkg install nginx-agent + sudo pkg install nginx-agent-2.42.0 ``` 1. Verify the installation: diff --git a/content/agent/installation-upgrade/upgrade.md b/content/agent/installation-upgrade/upgrade.md index f942db01f..71beebb96 100644 --- a/content/agent/installation-upgrade/upgrade.md +++ b/content/agent/installation-upgrade/upgrade.md @@ -60,10 +60,10 @@ To upgrade NGINX Agent to a specific **v2.x version**, follow these steps: sudo apt-get install -y nginx-agent= -o Dpkg::Options::="--force-confold" ``` - Example (to upgrade to version 2.41.1~noble): + Example (to upgrade to version 2.42.0~noble): ```shell - sudo apt-get install -y nginx-agent=2.41.1~noble -o Dpkg::Options::="--force-confold" + sudo apt-get install -y nginx-agent=2.42.0~noble -o Dpkg::Options::="--force-confold" ``` - CentOS, RHEL, RPM-Based @@ -72,10 +72,10 @@ To upgrade NGINX Agent to a specific **v2.x version**, follow these steps: sudo yum install -y nginx-agent- ``` - Example (to upgrade to version `2.41.1`): + Example (to upgrade to version `2.42.0`): ```shell - sudo yum install -y nginx-agent-2.41.1 + sudo yum install -y nginx-agent-2.42.0 ``` 1. Verify the installed version: From 7a4f806afdbe200db6901bd0ef994d4a7c63f945 Mon Sep 17 00:00:00 2001 From: nginx-seanmoloney Date: Wed, 23 Jul 2025 14:17:17 +0100 Subject: [PATCH 2/2] Remove lsb_release from instructions, use code name instead Remove comma based on PR feedback --- .../installation-upgrade/installation-oss.md | 27 ++++++++++--------- .../installation-upgrade/installation-plus.md | 24 ++++++++++------- 2 files changed, 29 insertions(+), 22 deletions(-) diff --git a/content/agent/installation-upgrade/installation-oss.md b/content/agent/installation-upgrade/installation-oss.md index 7ef3081db..e58b0d6be 100644 --- a/content/agent/installation-upgrade/installation-oss.md +++ b/content/agent/installation-upgrade/installation-oss.md @@ -50,7 +50,7 @@ Before you install NGINX Agent for the first time on your system, you need to se module_hotfixes=true ``` -1. To install `nginx-agent`, with a specific version (example: 2.42.0): +1. To install `nginx-agent` with a specific version (example: 2.42.0): ```shell sudo yum install -y nginx-agent-2.42.0 @@ -105,11 +105,13 @@ Before you install NGINX Agent for the first time on your system, you need to se | sudo tee /etc/apt/sources.list.d/nginx-agent.list ``` -1. To install `nginx-agent`, with a specific version (example: 2.42.0): - +1. To install `nginx-agent` with a specific version (example: 2.42.0): + + Update your package index and install a specific version of the nginx-agent. Replace with your current Ubuntu codename (e.g., jammy, noble). + ```shell sudo apt update - sudo apt install -y nginx-agent=2.42.0~`lsb_release -cs` + sudo apt install -y nginx-agent=2.42.0~ ``` 1. Verify the installation: @@ -166,12 +168,13 @@ Before you install NGINX Agent for the first time on your system, you need to se http://packages.nginx.org/nginx-agent/debian/ `lsb_release -cs` agent" \ | sudo tee /etc/apt/sources.list.d/nginx-agent.list ``` -1. To install `nginx-agent`, with a specific version (example: 2.42.0): +1. To install `nginx-agent` with a specific version (example: 2.42.0): + Update your package index and install a specific version of the nginx-agent. Replace with your current Debian codename (e.g., bullseye). + ```shell sudo apt update - sudo apt install -y nginx-agent=2.42.0~`lsb_release -cs` - ``` + sudo apt install -y nginx-agent=2.42.0~ 1. Verify the installation: @@ -229,7 +232,7 @@ Before you install NGINX Agent for the first time on your system, you need to se sudo rpmkeys --import /tmp/nginx_signing.key ``` -1. To install `nginx-agent`, with a specific version (example: 2.42.0): +1. To install `nginx-agent` with a specific version (example: 2.42.0): ```shell sudo zypper install -y nginx-agent=2.42.0 @@ -303,7 +306,7 @@ Before you install NGINX Agent for the first time on your system, you need to se sudo mv /tmp/nginx_signing.rsa.pub /etc/apk/keys/ ``` -1. To install `nginx-agent`, with a specific version (example: 2.42.0): +1. To install `nginx-agent` with a specific version (example: 2.42.0): ```shell sudo apk add nginx-agent=2.42.0 @@ -334,7 +337,7 @@ Before you install NGINX Agent for the first time on your system, you need to se module_hotfixes=true ``` -1. To install `nginx-agent`, with a specific version (example: 2.42.0): +1. To install `nginx-agent` with a specific version (example: 2.42.0): ```shell sudo dnf install -y nginx-agent-2.42.0 @@ -370,7 +373,7 @@ Before you install NGINX Agent for the first time on your system, you need to se module_hotfixes=true ``` -1. To install `nginx-agent`, with a specific version (example: 2.42.0): +1. To install `nginx-agent` with a specific version (example: 2.42.0): ```shell sudo yum install -y nginx-agent-2.42.0 @@ -396,7 +399,7 @@ Before you install NGINX Agent for the first time on your system, you need to se } ``` -1. To install `nginx-agent`, with a specific version (example: 2.42.0): +1. To install `nginx-agent` with a specific version (example: 2.42.0): ```shell sudo pkg install nginx-agent-2.42.0 diff --git a/content/agent/installation-upgrade/installation-plus.md b/content/agent/installation-upgrade/installation-plus.md index fa6cc5209..744fbde26 100644 --- a/content/agent/installation-upgrade/installation-plus.md +++ b/content/agent/installation-upgrade/installation-plus.md @@ -73,7 +73,7 @@ Before you install NGINX Agent for the first time on your system, you need to se enabled=1 ``` -1. To install `nginx-agent`, with a specific version (example: 2.42.0): +1. To install `nginx-agent` with a specific version (example: 2.42.0): ```shell sudo yum install -y nginx-agent-2.42.0 @@ -131,11 +131,13 @@ Before you install NGINX Agent for the first time on your system, you need to se | sudo tee /etc/apt/sources.list.d/nginx-agent.list ``` -1. To install `nginx-agent`, with a specific version (example: 2.42.0): +1. To install `nginx-agent` with a specific version (example: 2.42.0): + Update your package index and install a specific version of the nginx-agent. Replace with your current Ubuntu codename (e.g., jammy, noble). + ```shell sudo apt update - sudo apt install -y nginx-agent=2.42.0~`lsb_release -cs` + sudo apt install -y nginx-agent=2.42.0~ ``` 1. Verify the installation: @@ -183,12 +185,14 @@ Before you install NGINX Agent for the first time on your system, you need to se Acquire::https::pkgs.nginx.com::SslKey "/etc/ssl/nginx/nginx-repo.key"; ``` -1. To install `nginx-agent`, with a specific version (example: 2.42.0): +1. To install `nginx-agent` with a specific version (example: 2.42.0): + Update your package index and install a specific version of the nginx-agent. Replace with your current Debian codename (e.g., bullseye). + ```shell sudo apt update - sudo apt install -y nginx-agent=2.42.0~`lsb_release -cs` - ``` + sudo apt install -y nginx-agent=2.42.0~ + 1. Verify the installation: @@ -265,7 +269,7 @@ Before you install NGINX Agent for the first time on your system, you need to se sudo rpmkeys --import /tmp/nginx_signing.key ``` -1. To install `nginx-agent`, with a specific version (example: 2.42.0): +1. To install `nginx-agent` with a specific version (example: 2.42.0): ```shell sudo zypper install -y nginx-agent=2.42.0 @@ -394,7 +398,7 @@ Before you install NGINX Agent for the first time on your system, you need to se enabled=1 ``` -1. To install `nginx-agent`, with a specific version (example: 2.42.0): +1. To install `nginx-agent` with a specific version (example: 2.42.0): ```shell sudo dnf install -y nginx-agent-2.42.0 @@ -442,7 +446,7 @@ Before you install NGINX Agent for the first time on your system, you need to se enabled=1 ``` -1. To install `nginx-agent`, with a specific version (example: 2.42.0): +1. To install `nginx-agent` with a specific version (example: 2.42.0): ```shell sudo yum install -y nginx-agent-2.42.0 @@ -496,7 +500,7 @@ Before you install NGINX Agent for the first time on your system, you need to se SSL_CLIENT_KEY_FILE: "/etc/ssl/nginx/nginx-repo.key" } ``` -1. To install `nginx-agent`, with a specific version (example: 2.42.0): +1. To install `nginx-agent` with a specific version (example: 2.42.0): ```shell sudo pkg install nginx-agent-2.42.0