Skip to content
Merged
Changes from 2 commits
Commits
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
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
Comment thread
dhurley marked this conversation as resolved.
Outdated

{{< 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 >}}
Comment thread
dhurley marked this conversation as resolved.
Outdated

To upgrade the NGINX Agent, take the following steps:
Comment thread
dhurley marked this conversation as resolved.
Outdated

1. Open an SSH connection to the server where you’ve installed the NGINX Agent and log in.
Comment thread
dhurley marked this conversation as resolved.
Outdated

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:
Comment thread
dhurley marked this conversation as resolved.
Outdated

- 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:
Comment thread
dhurley marked this conversation as resolved.
Outdated

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

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