@@ -13,24 +13,22 @@ ms.custom: template-how-to, devx-track-azurecli
13
13
14
14
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.
15
15
16
- ---
17
-
18
16
## ** Prerequisites**
19
17
20
18
- ** Root account password** for the Terminal Server.
21
19
22
20
- An ** on-premises machine** with access to the Terminal Server for file transfers.
23
21
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/ ) .
25
23
26
24
> [ !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.
28
26
29
27
## ** Stage 1: Pre-Upgrade Checks (Terminal Server)**
30
28
31
29
### Check current version of Terminal Server
32
30
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.
34
32
35
33
``` bash
36
34
cat /etc/version
@@ -40,11 +38,11 @@ cat /etc/version
40
38
22.06.0
41
39
```
42
40
> [ !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.
44
42
45
43
### LLDP service check and enable
46
44
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.
48
46
49
47
``` bash
50
48
ogcli update services/lldp enabled=true
@@ -60,7 +58,7 @@ platform=""
60
58
61
59
### LLDP neighbor check
62
60
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.
64
62
65
63
``` bash
66
64
lldpctl
@@ -72,7 +70,7 @@ Mgmt Switch, PE2, PE1
72
70
73
71
### Ping connectivity check
74
72
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.
76
74
77
75
``` bash
78
76
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.
105
103
rtt min/avg/max/mdev = 0.305/0.328/0.344/0.015 ms
106
104
```
107
105
108
-
109
- ### Create backup of the current Terminal Server configuration
106
+ ### Backup current configuration
110
107
111
108
Execute following command on terminal server to create a backup of the current configuration.
112
109
113
110
``` bash
114
111
ogcli export ogcli_export_< date>
115
112
```
116
113
117
- ## ** Stage 2: Backup Files (On-Premises Machine )**
114
+ ## ** Stage 2: Backup Files (on-premises machine )**
118
115
119
- ### Transfer Backup Files to On-Premises Machine
116
+ ### Transfer Backup Files to on-nremises machine
120
117
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.
122
119
123
120
``` bash
124
121
mkdir ~ /ts_backup
@@ -149,38 +146,37 @@ scp -r -o
[email protected] ./operations_manager-24.07.1-production-
149
146
150
147
### Install Firmware
151
148
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: .
153
150
154
151
``` bash
155
152
puginstall --reboot-after /tmp/operations_manager-24.07.1-production-signed.raucb
156
153
```
157
154
> {!Note:]
158
- > The installation takes 5- 10 minutes, and the Terminal Server will reboot automatically.
155
+ The upgrade process takes 5– 10 minutes, during which the Terminal Server will reboot automatically.
159
156
160
157
161
158
## ** Stage 4: Cleanup (On-Premises Machine)**
162
159
163
160
### Remove Backup and Firmware
164
161
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 .
166
163
167
164
``` bash
168
165
rm -rf ~ /ts_backup
169
166
rm -rf ./operations_manager-24.07.1-production-signed.raucb
170
167
```
171
168
172
169
> [ !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.
174
171
175
- ## ** Appendix**
176
172
177
173
### Firmware Upgrade Failure
178
174
179
- If the firmware upgrade fails:
175
+ If the firmware upgrade fails, follow these steps :
180
176
181
177
1 . Perform a ** factory reset** :
182
178
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.
184
180
185
181
``` bash
186
182
factory_reset
@@ -190,9 +186,12 @@ Execute following command on the terminal server to perform a factory reset.
190
186
191
187
2 . Reinstall the latest firmware.
192
188
189
+ Repeat the firmware installation process.
190
+
193
191
3 . Reconfigure or restore the device from backup:
194
192
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
+
196
195
``` bash
197
196
ogcli restore < file_path>
198
197
```
0 commit comments