Skip to content

Commit 8e4392d

Browse files
authored
Update upgrade documentation (#526)
1 parent 63943e9 commit 8e4392d

File tree

1 file changed

+38
-7
lines changed

1 file changed

+38
-7
lines changed

hugo/content/upgrading.md

Lines changed: 38 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10,24 +10,55 @@ categories: ["configuration"]
1010
doctypes: ["task"]
1111
---
1212

13-
## Upgrade the NGINX Agent
13+
## Upgrade NGINX Agent from version v2.31.0 or greater
1414

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

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

1921
1. Make a backup copy of the following locations to ensure that you can successfully recover if the upgrade has issues:
2022

2123
- `/etc/nginx-agent`
2224
- `config_dirs` values for any configuration specified in `/etc/nginx-agent/nginx-agent.conf`
2325

24-
1. Stop the NGINX Agent:
26+
1. Install the updated version of NGINX Agent:
27+
28+
- CentOS, RHEL, RPM-Based
29+
30+
```shell
31+
sudo yum -y makecache
32+
sudo yum update -y nginx-agent
33+
```
34+
35+
- Debian, Ubuntu, Deb-Based
36+
37+
```shell
38+
sudo apt-get update
39+
sudo apt-get install -y --only-upgrade nginx-agent -o Dpkg::Options::="--force-confold"
40+
```
41+
42+
43+
44+
## Upgrade NGINX Agent from a version less than v2.31.0
45+
46+
To upgrade NGINX Agent, take the following steps:
47+
48+
1. Open an SSH connection to the server where you’ve installed NGINX Agent and log in.
49+
50+
1. Make a backup copy of the following locations to ensure that you can successfully recover if the upgrade has issues:
51+
52+
- `/etc/nginx-agent`
53+
- `config_dirs` values for any configuration specified in `/etc/nginx-agent/nginx-agent.conf`
54+
55+
1. Stop NGINX Agent:
2556

2657
```shell
2758
sudo systemctl stop nginx-agent
2859
```
2960

30-
1. Install the updated version of the NGINX Agent:
61+
1. Install the updated version of NGINX Agent:
3162

3263
- CentOS, RHEL, RPM-Based
3364

@@ -43,8 +74,8 @@ To upgrade the NGINX Agent, take the following steps:
4374
sudo apt-get install -y --only-upgrade nginx-agent -o Dpkg::Options::="--force-confold"
4475
```
4576

46-
1. Start the NGINX Agent:
77+
1. Start NGINX Agent:
4778

4879
```shell
4980
sudo systemctl start nginx-agent
50-
```
81+
```

0 commit comments

Comments
 (0)