Skip to content

Commit 1c579c3

Browse files
committed
Update howto-upgrade-os-of-terminal-server.md
1 parent 5ef1b58 commit 1c579c3

File tree

1 file changed

+21
-22
lines changed

1 file changed

+21
-22
lines changed

articles/operator-nexus/howto-upgrade-os-of-terminal-server.md

Lines changed: 21 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -13,24 +13,22 @@ ms.custom: template-how-to, devx-track-azurecli
1313

1414
This document provides a step-by-step guide to upgrade the operating system (OS) of a Terminal Server. The outlined procedure is manual and includes essential checks, a backup process, and actions for post-upgrade validation.
1515

16-
---
17-
1816
## **Prerequisites**
1917

2018
- **Root account password** for the Terminal Server.
2119

2220
- An **on-premises machine** with access to the Terminal Server for file transfers.
2321

24-
- **Latest firmware download**: [Opengear Firmware](https://ftp.opengear.com/download/opengear_appliances/OM/current/).
22+
- Dow**Latest firmware download**: [Opengear Firmware](https://ftp.opengear.com/download/opengear_appliances/OM/current/).
2523

2624
>[!Note:]
27-
> Terminal server upgrade was validated with the opengear version is 24.07.1.
25+
> This guide has been validated with Opengear firmware version 24.07.1.
2826
2927
## **Stage 1: Pre-Upgrade Checks (Terminal Server)**
3028

3129
### Check current version of Terminal Server
3230

33-
Execute following command on the terminal server to get the current OS version.
31+
Run the following command on the Terminal Server to check the existing OS version.
3432

3533
```bash
3634
cat /etc/version
@@ -40,11 +38,11 @@ cat /etc/version
4038
22.06.0
4139
```
4240
> [!Note:]
43-
> Current OS version running on the terminal server should be lesser than the one your upgrading to.
41+
> Ensure the current OS version is lower than the version you are upgrading to.
4442
4543
### LLDP service check and enable
4644

47-
Execute following on the terminal server to check and enable the LLDP service.
45+
Run the following command on the Terminal Server to check and enable the LLDP service.
4846

4947
```bash
5048
ogcli update services/lldp enabled=true
@@ -60,7 +58,7 @@ platform=""
6058

6159
### LLDP neighbor check
6260

63-
Execute following command on the terminal server to check the LLDP neighbor.
61+
Run the following command on the Terminal Server to check the LLDP neighbor.
6462

6563
```bash
6664
lldpctl
@@ -72,7 +70,7 @@ Mgmt Switch, PE2, PE1
7270

7371
### Ping connectivity check
7472

75-
Execute following command on the terminal server to perform a ping connectivity check.
73+
Run the following command on the Terminal Server to perform a ping connectivity check.
7674

7775
```bash
7876
default_routes=$(ip route show default | awk '{print $3}')
@@ -105,20 +103,19 @@ PING 10.103.0.6 (10.103.0.6) 56(84) bytes of data.
105103
rtt min/avg/max/mdev = 0.305/0.328/0.344/0.015 ms
106104
```
107105

108-
109-
### Create backup of the current Terminal Server configuration
106+
### Backup current configuration
110107

111108
Execute following command on terminal server to create a backup of the current configuration.
112109

113110
```bash
114111
ogcli export ogcli_export_<date>
115112
```
116113

117-
## **Stage 2: Backup Files (On-Premises Machine)**
114+
## **Stage 2: Backup Files (on-premises machine)**
118115

119-
### Transfer Backup Files to On-Premises Machine
116+
### Transfer Backup Files to on-nremises machine
120117

121-
Execute following command on the on premise machine to create a backup of terminal server configration and to transfer it to the on premise machine.
118+
Run following command on the on-premises machine to copy the Terminal Server configuration and related files to the on-premises machine.
122119

123120
```bash
124121
mkdir ~/ts_backup
@@ -149,38 +146,37 @@ scp -r -o [email protected] ./operations_manager-24.07.1-production-
149146
150147
### Install Firmware
151148

152-
Execute following command on the terminal server to install the firmware.
149+
Run the following command on the Terminal Server to initiate the firmware installation:.
153150

154151
```bash
155152
puginstall --reboot-after /tmp/operations_manager-24.07.1-production-signed.raucb
156153
```
157154
> {!Note:]
158-
> The installation takes 5-10 minutes, and the Terminal Server will reboot automatically.
155+
The upgrade process takes 510 minutes, during which the Terminal Server will reboot automatically.
159156

160157

161158
## **Stage 4: Cleanup (On-Premises Machine)**
162159

163160
### Remove Backup and Firmware
164161

165-
Execute following command on the on-premise machine to clean up the downloaded firmware and back up files.
162+
After confirming the successful upgrade, delete temporary files from the on-premises machine.
166163

167164
```bash
168165
rm -rf ~/ts_backup
169166
rm -rf ./operations_manager-24.07.1-production-signed.raucb
170167
```
171168

172169
>[!Note:]
173-
> Perform this action once the terminal server has been upgraded successfully.
170+
> Perform this action only once the terminal server has been upgraded successfully.
174171
175-
## **Appendix**
176172

177173
### Firmware Upgrade Failure
178174

179-
If the firmware upgrade fails:
175+
If the firmware upgrade fails, follow these steps:
180176

181177
1. Perform a **factory reset**:
182178

183-
Execute following command on the terminal server to perform a factory reset.
179+
Run the following command on the terminal server to perform a factory reset.
184180

185181
```bash
186182
factory_reset
@@ -190,9 +186,12 @@ Execute following command on the terminal server to perform a factory reset.
190186

191187
2. Reinstall the latest firmware.
192188

189+
Repeat the firmware installation process.
190+
193191
3. Reconfigure or restore the device from backup:
194192

195-
Execute following command on the terminal server to reconfigure or restore the device from backup
193+
Run the following command on the terminal server to reconfigure or restore the device from backup
194+
196195
```bash
197196
ogcli restore <file_path>
198197
```

0 commit comments

Comments
 (0)