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
Merged

Update upgrade documentation #526

Changes from all 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
45 changes: 38 additions & 7 deletions hugo/content/upgrading.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,24 +10,55 @@ categories: ["configuration"]
doctypes: ["task"]
---

## Upgrade the NGINX Agent
## Upgrade NGINX Agent from version v2.31.0 or greater

To upgrade the NGINX Agent, take the following steps:
{{< note >}} Starting from version v2.31.0, NGINX Agent will automatically restart itself during an upgrade. {{< /note >}}

1. Open an SSH connection to the server where you’ve installed the NGINX Agent and log in.
To upgrade NGINX Agent, follow these steps:

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. Install the updated version of 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 NGINX Agent from a version less than v2.31.0

To upgrade NGINX Agent, take the following steps:

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 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

Expand All @@ -43,8 +74,8 @@ To upgrade the 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
```
```