From 82793eaf227a4509fb78bfdf4e6d34fdb5626d25 Mon Sep 17 00:00:00 2001 From: dhurley Date: Wed, 6 Dec 2023 14:44:39 +0000 Subject: [PATCH 1/5] Update upgrade documentation --- hugo/content/upgrading.md | 35 +++++++++++++++++++++++++++++++++-- 1 file changed, 33 insertions(+), 2 deletions(-) diff --git a/hugo/content/upgrading.md b/hugo/content/upgrading.md index 361f4ac8f..d5523bc04 100644 --- a/hugo/content/upgrading.md +++ b/hugo/content/upgrading.md @@ -10,7 +10,38 @@ categories: ["configuration"] doctypes: ["task"] --- -## Upgrade the NGINX Agent +## Upgrade the NGINX Agent from version v2.31.0 or greater + +{{< important >}} In version v2.31.0 of the NGINX Agent, the behavior has changed so that the NGINX Agent will automatically restart it's self during an upgrade. {{< /important >}} + +To upgrade the NGINX Agent, take the following steps: + +1. Open an SSH connection to the server where you’ve installed the NGINX Agent and log in. + +1. Make a backup copy of the following locations to ensure that you can successfully recover if the upgrade has issues: + + - `/etc/nginx-agent` + - `config_dirs` values for any configuration specified in `/etc/nginx-agent/nginx-agent.conf` + +1. Install the updated version of the NGINX Agent: + + - CentOS, RHEL, RPM-Based + + ```shell + sudo yum -y makecache + sudo yum update -y nginx-agent + ``` + + - Debian, Ubuntu, Deb-Based + + ```shell + sudo apt-get update + sudo apt-get install -y --only-upgrade nginx-agent -o Dpkg::Options::="--force-confold" + ``` + + + +## Upgrade the NGINX Agent from a version less than v2.31.0 To upgrade the NGINX Agent, take the following steps: @@ -47,4 +78,4 @@ To upgrade the NGINX Agent, take the following steps: ```shell sudo systemctl start nginx-agent - ``` \ No newline at end of file + ``` From 093f6b664a1ab8ea4af3ceb184e13ccafd1a31dd Mon Sep 17 00:00:00 2001 From: dhurley Date: Wed, 6 Dec 2023 14:49:50 +0000 Subject: [PATCH 2/5] Clean up --- hugo/content/upgrading.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hugo/content/upgrading.md b/hugo/content/upgrading.md index d5523bc04..d9874e8f6 100644 --- a/hugo/content/upgrading.md +++ b/hugo/content/upgrading.md @@ -12,7 +12,7 @@ doctypes: ["task"] ## Upgrade the NGINX Agent from version v2.31.0 or greater -{{< important >}} In version v2.31.0 of the NGINX Agent, the behavior has changed so that the NGINX Agent will automatically restart it's self during an upgrade. {{< /important >}} +{{< important >}} In version v2.31.0 of the NGINX Agent, the behavior has changed so that the NGINX Agent will automatically restart itself during an upgrade. {{< /important >}} To upgrade the NGINX Agent, take the following steps: From 2384b6212c8963ceb6e95506277dfd04819babf3 Mon Sep 17 00:00:00 2001 From: Donal Hurley Date: Mon, 11 Dec 2023 11:52:22 +0000 Subject: [PATCH 3/5] Apply suggestions from code review Co-authored-by: Jon Torre <78599298+Jcahilltorre@users.noreply.github.com> --- hugo/content/upgrading.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/hugo/content/upgrading.md b/hugo/content/upgrading.md index d9874e8f6..be95ac6f4 100644 --- a/hugo/content/upgrading.md +++ b/hugo/content/upgrading.md @@ -10,20 +10,20 @@ categories: ["configuration"] doctypes: ["task"] --- -## Upgrade the NGINX Agent from version v2.31.0 or greater +## Upgrade NGINX Agent from version v2.31.0 or greater -{{< important >}} In version v2.31.0 of the NGINX Agent, the behavior has changed so that the NGINX Agent will automatically restart itself during an upgrade. {{< /important >}} +{{< important >}} Starting from version v2.31.0, NGINX Agent will automatically restart itself during an upgrade. {{< /important >}} -To upgrade the NGINX Agent, take the following steps: +To upgrade NGINX Agent, follow these steps: -1. Open an SSH connection to the server where you’ve installed the NGINX Agent and log in. +1. Open an SSH connection to the server where you’ve installed NGINX Agent and log in. 1. Make a backup copy of the following locations to ensure that you can successfully recover if the upgrade has issues: - `/etc/nginx-agent` - `config_dirs` values for any configuration specified in `/etc/nginx-agent/nginx-agent.conf` -1. Install the updated version of the NGINX Agent: +1. Install the updated version of NGINX Agent: - CentOS, RHEL, RPM-Based @@ -41,9 +41,9 @@ To upgrade the NGINX Agent, take the following steps: -## Upgrade the NGINX Agent from a version less than v2.31.0 +## Upgrade NGINX Agent from a version less than v2.31.0 -To upgrade the NGINX Agent, take the following steps: +To upgrade NGINX Agent, take the following steps: 1. Open an SSH connection to the server where you’ve installed the NGINX Agent and log in. From 2968bd4df520d3a83a320c95949f5e219853ed49 Mon Sep 17 00:00:00 2001 From: Donal Hurley Date: Mon, 11 Dec 2023 11:54:12 +0000 Subject: [PATCH 4/5] Update upgrading.md --- hugo/content/upgrading.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/hugo/content/upgrading.md b/hugo/content/upgrading.md index be95ac6f4..45ab7b7c8 100644 --- a/hugo/content/upgrading.md +++ b/hugo/content/upgrading.md @@ -45,20 +45,20 @@ To upgrade NGINX Agent, follow these steps: To upgrade NGINX Agent, take the following steps: -1. Open an SSH connection to the server where you’ve installed the NGINX Agent and log in. +1. Open an SSH connection to the server where you’ve installed NGINX Agent and log in. 1. Make a backup copy of the following locations to ensure that you can successfully recover if the upgrade has issues: - `/etc/nginx-agent` - `config_dirs` values for any configuration specified in `/etc/nginx-agent/nginx-agent.conf` -1. Stop the NGINX Agent: +1. Stop NGINX Agent: ```shell sudo systemctl stop nginx-agent ``` -1. Install the updated version of the NGINX Agent: +1. Install the updated version of NGINX Agent: - CentOS, RHEL, RPM-Based @@ -74,7 +74,7 @@ To upgrade NGINX Agent, take the following steps: sudo apt-get install -y --only-upgrade nginx-agent -o Dpkg::Options::="--force-confold" ``` -1. Start the NGINX Agent: +1. Start NGINX Agent: ```shell sudo systemctl start nginx-agent From 78069419364654321b8c30f0c0ca05df5a904b54 Mon Sep 17 00:00:00 2001 From: Donal Hurley Date: Mon, 11 Dec 2023 11:59:37 +0000 Subject: [PATCH 5/5] Update upgrading.md --- hugo/content/upgrading.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hugo/content/upgrading.md b/hugo/content/upgrading.md index 45ab7b7c8..675dfb76d 100644 --- a/hugo/content/upgrading.md +++ b/hugo/content/upgrading.md @@ -12,7 +12,7 @@ doctypes: ["task"] ## Upgrade NGINX Agent from version v2.31.0 or greater -{{< important >}} Starting from version v2.31.0, NGINX Agent will automatically restart itself during an upgrade. {{< /important >}} +{{< note >}} Starting from version v2.31.0, NGINX Agent will automatically restart itself during an upgrade. {{< /note >}} To upgrade NGINX Agent, follow these steps: