Skip to content

Commit 0a1f7e3

Browse files
authored
Update howto-platform-prerequisites.md
made all the requested changes Note: Line#426 is a code output hence in a code fence.
1 parent 66f180c commit 0a1f7e3

File tree

1 file changed

+53
-28
lines changed

1 file changed

+53
-28
lines changed

articles/operator-nexus/howto-platform-prerequisites.md

Lines changed: 53 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -141,7 +141,7 @@ Terminal Server has been deployed and configured as follows:
141141
- Terminal Server interface is connected to the operators on-premises Provider Edge routers (PEs) and configured with the IP addresses and credentials
142142
- Terminal Server is accessible from the management VPN
143143

144-
### Step 1: Setting Up Hostname
144+
### Step 1: Setting up hostname
145145

146146
To set up the hostname for your terminal server, follow these steps:
147147

@@ -159,7 +159,7 @@ sudo ogcli update system/hostname hostname=\"$TS_HOSTNAME\"
159159

160160
[Refer to CLI Reference](https://opengear.zendesk.com/hc/articles/360044253292-Using-the-configuration-CLI-ogcli-) for more details.
161161

162-
### Step 2: Setting Up Network
162+
### Step 2: Setting up network
163163

164164
To configure network settings, follow these steps:
165165

@@ -183,7 +183,9 @@ sudo ogcli create conn << 'END'
183183
physif="net2"
184184
END
185185
```
186+
186187
**Parameters:**
188+
187189
| Parameter Name | Description |
188190
| --------------- | ----------------------------------------------- |
189191
| TS_NET1_IP | Terminal server PE1 to TS NET1 IP |
@@ -192,28 +194,44 @@ sudo ogcli create conn << 'END'
192194
| TS_NET2_IP | Terminal server PE2 to TS NET2 IP |
193195
| TS_NET2_NETMASK | Terminal server PE2 to TS NET2 netmask |
194196
| TS_NET2_GW | Terminal server PE2 to TS NET2 gateway |
195-
**Note:** Make sure to replace these parameters with appropriate values.
196-
### Step 3: Clearing net3 Interface (if Existing)
197+
198+
>[!NOTE]
199+
>Make sure to replace these parameters with appropriate values.
200+
201+
### Step 3: Clearing net3 interface (if existing)
202+
197203
To clear the net3 interface, follow these steps:
204+
198205
1. Check for any interface configured on the physical interface net3 and "Default IPv4 Static Address" using the following command:
206+
199207
```bash
200208
ogcli get conns
201209
**description="Default IPv4 Static Address"**
202210
**name="$TS_NET3_CONN_NAME"**
203211
**physif="net3"**
204212
```
213+
205214
**Parameters:**
215+
206216
| Parameter Name | Description |
207217
| ----------------- | ---------------------------------------- |
208218
| TS_NET3_CONN_NAME | Terminal server NET3 Connection name |
219+
209220
2. Remove the interface if it exists:
221+
210222
```bash
211223
ogcli delete conn "$TS_NET3_CONN_NAME"
212224
```
213-
**Note:** Make sure to replace these parameters with appropriate values.
214-
### Step 4: Setting Up Support Admin User
225+
226+
>[!NOTE]
227+
>Make sure to replace these parameters with appropriate values.
228+
229+
### Step 4: Setting up support admin user
230+
215231
To set up the support admin user, follow these steps:
232+
216233
1. For each user, execute the following command in the CLI:
234+
217235
```bash
218236
ogcli create user << 'END'
219237
description="Support Admin User"
@@ -232,8 +250,10 @@ END
232250
| SUPPORT_USER | Support admin user |
233251
| HASHED_SUPPORT_PWD | Encoded support admin user password |
234252

235-
>Note: Make sure to replace these parameters with appropriate values.
236-
### Step 5: Adding sudo Support for Admin Users
253+
>[!NOTE]
254+
>Make sure to replace these parameters with appropriate values.
255+
256+
### Step 5: Adding sudo support for admin users
237257

238258
To add sudo support for admin users, follow these steps:
239259

@@ -250,15 +270,16 @@ sudo vi /etc/sudoers.d/opengear
250270
%admin ALL=(ALL) NOPASSWD: ALL
251271
```
252272

253-
**Note:** Make sure to save the changes after editing the file.
273+
>[!NOTE]
274+
>Make sure to save the changes after editing the file.
254275
255276
This configuration allows members of the "netgrp" group to execute any command as any user and members of the "admin" group to execute any command as any user without requiring a password.
256277

257-
### Step 6: Ensuring LLDP Service Availability
278+
### Step 6: Ensuring LLDP service availability
258279

259280
To ensure the LLDP service is available on your terminal server, follow these steps:
260281

261-
1. Check if the LLDP service is running:
282+
Check if the LLDP service is running:
262283

263284
```bash
264285
sudo systemctl status lldpd
@@ -280,48 +301,50 @@ lldpd.service - LLDP daemon
280301
Notice: journal has been rotated since unit was started, output may be incomplete.
281302
```
282303

283-
2. If the service isn't active (running), start the service:
304+
If the service isn't active (running), start the service:
284305

285306
```bash
286307
sudo systemctl start lldpd
287308
```
288309

289-
3. Enable the service to start on reboot:
310+
Enable the service to start on reboot:
290311

291312
```bash
292313
sudo systemctl enable lldpd
293314
```
294315

295-
>Note: Make sure to perform these steps to ensure the LLDP service is always available and starts automatically upon reboot.
296-
### Step 7: Checking System Date/Time
316+
>[!NOTE]
317+
>Make sure to perform these steps to ensure the LLDP service is always available and starts automatically upon reboot.
318+
319+
### Step 7: Checking system date/time
297320

298321
Ensure that the system date/time is correctly set, and the timezone for the terminal server is in UTC.
299322

300-
#### Check Timezone Setting:
323+
#### Check timezone setting:
301324

302325
1. To check the current timezone setting:
303326

304327
```bash
305328
ogcli get system/timezone
306329
```
307330

308-
#### Set Timezone to UTC:
331+
#### Set timezone to UTC:
309332

310333
2. If the timezone is not set to UTC, you can set it using:
311334

312335
```bash
313336
ogcli update system/timezone timezone=\"UTC\"
314337
```
315338

316-
#### Check Current Date/Time:
339+
#### Check current date/time:
317340

318341
3. Check the current date and time:
319342

320343
```bash
321344
date
322345
```
323346

324-
#### Fix Date/Time if Incorrect:
347+
#### Fix date/time if incorrect:
325348

326349
4. If the date/time is incorrect, you can fix it using:
327350

@@ -337,11 +360,12 @@ time="$CURRENT_DATE_TIME"
337360
| ------------------ | --------------------------------------------- |
338361
| CURRENT_DATE_TIME | Current date time in format hh:mm MMM DD, YYYY |
339362

340-
Ensure the system date/time is accurate to prevent any issues with applications or services relying on it.
363+
>[!NOTE]
364+
>Ensure the system date/time is accurate to prevent any issues with applications or services relying on it.
341365
342-
### Step 8: Labeling TS Ports (if Missing/Incorrect)
366+
### Step 8: Labeling Terminal Server ports (if missing/incorrect)
343367

344-
To label terminal server ports, use the following command:
368+
To label Terminal Server ports, use the following command:
345369

346370
```bash
347371
ogcli update port "port-<PORT_#>" label=\"<NEW_NAME>\" <PORT_#>
@@ -354,7 +378,7 @@ ogcli update port "port-<PORT_#>" label=\"<NEW_NAME>\" <PORT_#>
354378
| NEW_NAME | Port label name |
355379
| PORT_# | Terminal Server port number |
356380

357-
### Step 9: Settings Required for PURE Array Serial Connections
381+
### Step 9: Settings required for PURE Array serial connections
358382

359383
For configuring PURE Array serial connections, use the following commands:
360384

@@ -371,7 +395,7 @@ ogcli update port ports-<PORT_#> 'pinout="X1"' <PORT_#> Pure Storage Controller
371395

372396
These commands set the baudrate and pinout for connecting to the Pure Storage Controller console.
373397

374-
### Step 10: Verifying Settings
398+
### Step 10: Verifying settings
375399

376400
To verify the configuration settings, execute the following commands:
377401

@@ -390,11 +414,12 @@ sudo lldpctl
390414
sudo lldpcli show neighbors # Check LLDP neighbors - should show data from NET1 and NET2
391415
```
392416

393-
**Note:** Ensure that the LLDP neighbors are as expected, indicating successful connections to PE1 and PE2.
417+
>[!NOTE]
418+
>Ensure that the LLDP neighbors are as expected, indicating successful connections to PE1 and PE2.
394419
395420
Example LLDP neighbors output:
396421

397-
```
422+
```Output
398423
-------------------------------------------------------------------------------
399424
LLDP neighbors:
400425
-------------------------------------------------------------------------------
@@ -422,8 +447,8 @@ Interface: net1, via: LLDP, RID: 1, Time: 0 day, 20:28:36
422447
-------------------------------------------------------------------------------
423448
```
424449

425-
Verify that the output matches your expectations and that all configurations are correct.
426-
```
450+
>[!NOTE]
451+
>Verify that the output matches your expectations and that all configurations are correct.
427452
428453
## Set up storage array
429454

0 commit comments

Comments
 (0)