Skip to content

Commit 08d37d9

Browse files
authored
Merge pull request #451 from ritza-co/19.06.05
Docs 19.06.05 release (Week 23, 2025)
2 parents 27a02e0 + e2da28b commit 08d37d9

75 files changed

Lines changed: 959 additions & 766 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

docs/administration/appliance-manager/collecting-snmpwalk-output-for-troubleshooting.mdx

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,26 @@
11
---
2-
title: "Collecting SNMPWALK Output"
2+
title: "Collecting SNMP Walk Output"
33
sidebar_position: 4
44
---
55

6-
You can collect SNMP walk's output for a network device or a PDU right from the GUI, and can send the output to us for further troubleshooting or for adding a specific device into discovery.
6+
You can collect SNMP walk output for a network device or PDU right from the GUI. Then, you can send the output to us for further troubleshooting or to add a specific device to discovery.
77

8-
### Collect SNMPWALK output
8+
### Collect SNMP Walk Output
99

10-
![Collect SNMPwalk Appliance Manager](/assets/images/generate_SNMPwalk.png)
10+
From the Appliance Manager, go to **Application > Generate SNMP Output**.
1111

12-
**Go to:** Application > Generate SNMPWALK output
12+
Add your target switch or other SNMP target device info, click **Submit**, and please be patient as it might take a few minutes. Please send us the file that is generated.
1313

14-
Add your target switch \[or other SNMP target device\] info, click generate, and please be patient as it might take few minutes. Please send us the file that is generated.
14+
![Collect SNMP walk Appliance Manager](/assets/images/collecting-snmpwalk-output-for-troubleshooting/generate-snmp-output-options.png)
1515

16-
If there is an issue, the network is not reachable, or if you simply prefer using the terminal, you can alternatively run the following from any machine which has 'snmpwalk' installed:
16+
If there is an issue, the network is not reachable, or you simply prefer using the terminal, you can instead run the following from any machine that has 'snmpwalk' installed:
1717

1818
```
1919
snmpbulkwalk -Cc -ObentU -v2c -c COMMUNITY DEVICE > output_file_name
2020
snmpbulkwalk -ObentU -v 2c -c COMMUNITY DEVICE .1.3.6.1.4.1 >> output_file_name
2121
```
2222

23-
Also, the current setup has a bug for v3, so please use following for any system using SNMP v3:
23+
Also, the current setup has a bug for v3, so please use the following for any system using SNMP v3:
2424

2525
```
2626
snmpbulkwalk -Cc -ObentU -v 3 -u user_name -l authNoPriv -a MD5 -A auth_pass DEVICE > output_file_name

docs/administration/appliance-manager/device42-appliance-manager-login.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Device42 Appliance Manager login"
2+
title: "Device42 Appliance Manager Login"
33
sidebar_position: 6
44
---
55

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,18 @@
11
---
2-
title: "Enable or Disable TLS versions from Appliance Manager"
2+
title: "Enable or Disable TLS Versions from Appliance Manager"
33
sidebar_position: 8
44
---
55

6-
# Disabling or Enabling TLS versions from the Appliance Manager
6+
# Disabling or Enabling TLS Versions From the Appliance Manager
77

88
Device42 allows you to restrict TLS versions for Appliance Manager Access. The radio buttons shown below control this feature.
99

1010
:::note
11-
The appliance manager now defaults to **Enable TLS v1.2 only**. You an change the TLS settings in the appliance manager to **Enable TLS v.1.1 and v1.2** or **Enable All TLS**.
11+
The Appliance Manager now defaults to **Enable TLS v1.2 only**. You can change the TLS settings in the Appliance Manager to **Enable TLS v.1.1 and v1.2** or **Enable All TLS**.
1212
:::
1313

14-
- To apply TLS version restrictions, log into the Device42 Appliance Manager by clicking the link at the bottom of the main login page, and enter your Device42 Appliance Manager credentials. The default username and password for the Appliance Manager is `d42admin/default`.
15-
16-
![](/assets/images/TLS-appliance-mgr-login.png)
14+
- To apply TLS version restrictions, log in to the Device42 Appliance Manager. See [Device42 Appliance Manager Login](device42-appliance-manager-login.mdx) for more details about accessing and logging in to the Appliance Manager.
1715
- From the main menu on the left side of the Appliance Manager, select **Global Settings** and then **TLS versions for Web Console** or **TLS versions for Appliance Manager**.
1816
- Select the appropriate radio button and click **Submit** to apply your changes.
1917

20-
![](/assets/images/16.23.00_TLS_Settings.png)
18+
![](/assets/images/enable-or-disable-tls-versions-from-appliance-manager/main-appliance-tls-options.png)
Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,34 @@
11
---
2-
title: "Setup & Troubleshooting Menu"
2+
title: "Setup and Troubleshooting Menu"
33
sidebar_position: 14
44
---
55

6-
The following console menu, titled "Device42 Setup/Troubleshooting Menu", is presented to a user logged in to the Device42 VM:
6+
The following console menu, titled **Device42 Appliance Management**, is presented when you log in to the Device42 Virtual Machine:
77

8-
![device42-console-menu](/assets/images/setup_troubleshooting_menu.png)
8+
![device42-console-menu](/assets/images/console-menu-19.06.png)
99

1010
The current options are as follows:
1111

1212
```
13-
=====================================
14-
Device42 Setup/Troubleshooting Menu
15-
=====================================
16-
17-
1. Configure IP/Networking
18-
2. Restart Application
19-
3. Apply Update
20-
4. Restart Server / Appliance
21-
5. Shutdown Server / Appliance
22-
6. NTP Client Setup
23-
7. Time Zone Setup
24-
9. Install VMWare/XenServer Tools
25-
10. Change Password (user device42)
26-
11. Change keyboard layout
27-
12. Disable Appliance Manager SSL
28-
13. Drop me to a ROOT shell :)
29-
14. Clear Logs
30-
15. Advanced Routing
31-
16. Compact Database
32-
17. Compact only Audit Log in Database
33-
0. Logout
13+
(a) Apply Update
14+
15+
(n) NTP Settings
16+
(i) Set Timezone
17+
(c) Clear Logs
18+
(p) Change Password (user device42)
19+
(k) Change Keyboard Layout
20+
21+
(s) Server Settings
22+
(l) Disable Appliance Manager SSL
23+
24+
(u) Network, Connectivity and Utilities
25+
26+
(z) Restart Services
27+
(b) Reboot Server
28+
(d) Shutdown
29+
30+
(e) Compact Database
31+
(f) Compact only Audit Log in Database
32+
33+
(x) Exit
3434
```

docs/administration/generating-csrs.mdx

Lines changed: 20 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -3,36 +3,49 @@ title: "Generating CSRs"
33
sidebar_position: 10
44
---
55

6-
## Generating a certificate via OpenSSL
6+
## Generating a Certificate Via OpenSSL
77

88
Instructions to generate certificates with openSSL can also be found [documented here, on our support site.](https://support.device42.com/hc/en-us/articles/222221348-My-demo-certificate-for-https-expired-how-can-I-add-a-new-one-)
99

10-
To generate a CSR (Certificate Signing Request), open a terminal that has the _openssl_ package installed. The following commands will generate a (self-signed) SSL certificate from a new or existing OpenSSL installation:
10+
To generate a CSR (Certificate Signing Request), open a terminal that has the **openssl** package installed. The following commands will generate a (self-signed) SSL certificate from a new or existing OpenSSL installation:
11+
1112

12-
```
1313
1. Generate a **private** key for your server CA (Certificate Authority):
14+
```bash
1415
$ openssl genrsa -des3 -out ca.key 4096
16+
```
1517

1618
2. Create a certificate file using the generated CA private key:
19+
```bash
1720
$ openssl req -new -x509 -days 3650 -key ca.key -out ca_file
21+
```
1822

1923
3. Create a **private** key for your new SSL certificate:
24+
```bash
2025
$ openssl genrsa -des3 -out server.key 2048
26+
```
2127

2228
4. Create certificate signing request (CSR) for your SSL certificate:
29+
```bash
2330
$ openssl req -new -key server.key -out server.csr
31+
```
2432

2533
5. Sign the CSR we created above with our CA key, and export the signed x509 certificate:
34+
```bash
2635
$ openssl x509 -req -days 365 -in server.csr -CA ca_file -CAkey ca.key -set_serial 01 -out cert_file
36+
```
2737

2838
6. Export the private key file in the correct format:
39+
```bash
2940
$ openssl rsa -in server.key -out key_file
30-
```
41+
```
3142

3243
Adding a new certificate is easy; See [add a new certificate via appliance manager instructions here](appliance-manager/set-up-https-cert.mdx).
3344

34-
## Generating non-production CSRs
45+
## Generating Non-Production CSRs
3546

36-
**WARNING! You should most likely use the OpenSSL method outlined ABOVE! Use the following online generator at your own risk, and ONLY for NON-PRODUCTION purposes. A 'Private' key generated by this link [or any third party] is, by definition, NOT private!!**
47+
:::caution
48+
We recommend using the OpenSSL method outlined above. Use the following online generator at your own risk, and only for non-production purposes. A 'private' key generated by this link (or any third party) is unlikely to be truly private.
49+
:::
3750

38-
If you need to quickly generate a non-production Certificate Signing Request (CSR), you can use this online CSR generator at your own risk: [CSR Generator](https://csrgenerator.com)
51+
If you need to quickly generate a non-production Certificate Signing Request (CSR), you can use this online CSR generator at your own risk: [CSR Generator](https://csrgenerator.com).

docs/administration/licensing.mdx

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -15,22 +15,22 @@ Device42 licenses are valid for one year from the date of purchase. To continue
1515
To see your current Device42 licenses, navigate to **Tools > Settings > Licensing** from the main menu to display the Licensing page.
1616

1717
<ThemedImage
18-
alt="Licensing in menu"
18+
alt="Licensing menu option"
1919
sources={{
20-
light: useBaseUrl('/assets/images/licensing/license-menu-light.png'),
21-
dark: useBaseUrl('/assets/images/licensing/license-menu-dark.png'),
20+
light: useBaseUrl('/assets/images/licensing/licensing-menu-19.06-light.png'),
21+
dark: useBaseUrl('/assets/images/licensing/licensing-menu-19.06-dark.png'),
2222
}}
2323
/>
2424

25-
The top left of the page displays the available license modules and whether they are enabled.
25+
The page displays the available license modules and whether they are enabled.
2626

2727
<ThemedImage
2828
alt="Enabled licenses"
2929
sources={{
30-
light: useBaseUrl('/assets/images/licensing/license-section-light.png'),
31-
dark: useBaseUrl('/assets/images/licensing/license-section-dark.png'),
30+
light: useBaseUrl('/assets/images/licensing/license-section-19.06-light.png'),
31+
dark: useBaseUrl('/assets/images/licensing/license-section-19.06-dark.png'),
3232
}}
33-
style={{ width: '40%' }}
33+
style={{ width: '80%' }}
3434
/>
3535

3636
### How Do I Get a Device42 License?
@@ -50,8 +50,8 @@ Go to the License page under **Tools > Settings > Licensing** and do the followi
5050
<ThemedImage
5151
alt="Upload license"
5252
sources={{
53-
light: useBaseUrl('/assets/images/licensing/upload-license-light.png'),
54-
dark: useBaseUrl('/assets/images/licensing/upload-license-dark.png'),
53+
light: useBaseUrl('/assets/images/licensing/upload-license-19.06-light.png'),
54+
dark: useBaseUrl('/assets/images/licensing/upload-license-19.06-dark.png'),
5555
}}
5656
/>
5757

@@ -109,8 +109,8 @@ The lower portion of the **Tools > Settings > Licensing** page displays the numb
109109
<ThemedImage
110110
alt="License breakdown"
111111
sources={{
112-
light: useBaseUrl('/assets/images/licensing/breakdown-light.png'),
113-
dark: useBaseUrl('/assets/images/licensing/breakdown-dark.png'),
112+
light: useBaseUrl('/assets/images/licensing/breakdown-19.06-light.png'),
113+
dark: useBaseUrl('/assets/images/licensing/breakdown-19.06-dark.png'),
114114
}}
115115
/>
116116

docs/administration/setting-time-zone-and-ntp.mdx

Lines changed: 23 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -3,42 +3,41 @@ title: "Setting Time Zone and NTP"
33
sidebar_position: 14
44
---
55

6-
Here is brief run down on setting or changing your time zone in Device42. This is probably one of the first steps you should take so that autodiscovery scheduling and log history work correctly. The virtual appliance takes the clock from virtual host, so make sure the time is correct on the host and it's not a bad idea to set up an NTP time source to ensure the time stays correct.
6+
import ThemedImage from '@theme/ThemedImage'
7+
import useBaseUrl from '@docusaurus/useBaseUrl'
78

8-
## Set time Zone
9+
Here is a brief run-down on setting or changing your time zone in Device42. This is probably one of the first steps you should take so that autodiscovery scheduling and log history work correctly. The virtual appliance takes the clock from the virtual host, so make sure the time is correct on the host. It's also a good idea to set up an NTP time source to ensure the time stays correct.
910

10-
![Time Zone settings Administration](/assets/images/time_settings_menu-HL.png)
11+
## Set the Time Zone
1112

12-
In the Device42 main menu, go to _Tools > Settings > Time Settings_.
13+
In the Device42 main menu, go to **Tools > Settings > Time Settings**.
1314

14-
Here, you can select the correct time zone for your location and click Apply.
15+
Here, you can select the correct time zone for your location and click **Apply**.
1516

16-
## Apply the correct time zone settings.
17+
<ThemedImage
18+
alt="Time zone settings"
19+
sources={{
20+
light: useBaseUrl('/assets/images/setting-time-zone-and-ntp/select-time-zone-success-light.png'),
21+
dark: useBaseUrl('/assets/images/setting-time-zone-and-ntp/select-time-zone-success-dark.png'),
22+
}}
23+
/>
1724

18-
![Apply the new Time Zone Setting](/assets/images/apply_new_TZ-hl.png)
25+
## OS-Level Time Settings
1926

20-
After you've selected the correct new time zone and received confirmation it's been applied, go to the Device42 console and restart the Device42 application \[Option #2\]. When it restarts, it will have the new time zone.
27+
After you've selected the correct new time zone and received confirmation that it has been applied, go to the Device42 console and restart the Device42 application. When it restarts, the console menu will show the new time zone.
2128

22-
## OS Level Time Settings
29+
- Use the VM console menu options, **NTP Settings** and **Set Timezone**, to set time at the OS level.
2330

24-
![NTP & Time Zone settings d42 Console](/assets/images/ntptz_settings_console.png)
31+
![NTP and Time Zone settings d42 Console](/assets/images/setting-time-zone-and-ntp/console-main-menu.png)
2532

26-
Use VM console menu options 6 & 7 to set time at the OS level. Here is a example of how to setup NTP.
33+
- Select **NTP Settings** from the main menu and enter the IP or FQDN of the NTP server. Toggle on the **Daily sync** option to add the NTP server to the daily scheduled jobs.
2734

28-
![Configure new NTP Server ](/assets/images/Config_NTP_Console-2019.png)
35+
![Configure new NTP Server ](/assets/images/setting-time-zone-and-ntp/console-ntp-settings.png)
2936

30-
First, enter the IP or FQDN of the NTP server. Then select 'y' to add the NTP server to the daily scheduled jobs.
37+
- Go back to the main menu and select **Set Timezone** to set the time zone on the OS level. If you don't see your exact location, choose the location closest to you:
3138

32-
![Update OS TZ from D42 console](/assets/images/Set_TZ_via_console.png)
39+
![Update OS TZ from D42 console](/assets/images/setting-time-zone-and-ntp/console-set-timezone.png)
3340

34-
Use option 7 to set the time zone on the OS level. If you don't see your exact location, choose the location closest to you:
41+
- Select **Restart Services** for the new time zone settings to take effect immediately.
3542

36-
![Set Time Zone for OS part 2](/assets/images/Set-TZ-console-p2.png)
37-
38-
Once you've completed the TZ settings, you'll be able to see your new Time Zone at the top of the Device42 Console Menu:
39-
40-
![Current Time Zone visible on D42 Console](/assets/images/new_TZ_on_console.png)
41-
42-
### Restart Application from console.
43-
44-
**After changing your time settings, select Option 2 to restart the application** and the new time zone settings will take effect immediately.
43+
![Update OS TZ from D42 console](/assets/images/setting-time-zone-and-ntp/console-restart-services.png)

0 commit comments

Comments
 (0)