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.

Sign up for GitHub

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

Update upgrade documentation #526

Merged
merged 5 commits into from
Dec 11, 2023
+38 −7
Merged

Update upgrade documentation #526

Changes from 2 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
82793ea
Update upgrade documentation
dhurley Dec 6, 2023
093f6b6
Clean up
dhurley Dec 6, 2023
2384b62
Apply suggestions from code review
dhurley Dec 11, 2023
2968bd4
Update upgrading.md
dhurley Dec 11, 2023
7806941
Update upgrading.md
dhurley Dec 11, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 33 additions & 2 deletions hugo/content/upgrading.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 itself 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:

Expand Down Expand Up @@ -47,4 +78,4 @@ To upgrade the NGINX Agent, take the following steps:

```shell
sudo systemctl start nginx-agent
```
```