Skip to content

Commit 5717e3d

Browse files
authored
Merge pull request #458 from ritza-co/19.06.09
Docs 19.06.09 release (Week 27, 2025)
2 parents a16c2cb + 57f7709 commit 5717e3d

138 files changed

Lines changed: 415 additions & 146 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/auto-discovery/operating-systems-supported-in-auto-discovery.mdx

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ Discovery of the **IBM i powered mid-range** line and **IBM z/OS** powered mainf
4040
<table>
4141
<tbody>
4242
<tr>
43-
<td width="450">
43+
<td width="450" style={{verticalAlign: 'top'}}>
4444
<ul>
4545
<li>AIX 5</li>
4646
<li>AIX 6</li>
@@ -73,13 +73,14 @@ Discovery of the **IBM i powered mid-range** line and **IBM z/OS** powered mainf
7373
<li>Microsoft Windows Server 2008 R2 Standard SP1</li>
7474
</ul>
7575
</td>
76-
<td width="414">
76+
<td width="450" style={{verticalAlign: 'top'}}>
7777
<ul>
7878
<li>Microsoft Windows Server 2012</li>
7979
<li>Microsoft Windows Server 2012 R2</li>
8080
<li>Microsoft Windows Server 2016</li>
8181
<li>Microsoft Windows Server 2019</li>
8282
<li>Microsoft Windows Server 2022</li>
83+
<li>Microsoft Windows Server 2025</li>
8384
<li>Miracle Linux 8.4</li>
8485
<li>OpenVMS 8.4</li>
8586
<li>Oracle Linux Server 6.7</li>
@@ -108,4 +109,4 @@ Discovery of the **IBM i powered mid-range** line and **IBM z/OS** powered mainf
108109
</td>
109110
</tr>
110111
</tbody>
111-
</table>
112+
</table>

docs/auto-discovery/virtual-machine-auto-discovery.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,10 @@ From the Device42 main menu, under **Discovery > Hypervisors/\*nix/Windows**, ad
6161

6262
**Discovery Target(s):** This is the FQDN or IP of the vCenter server or the ESX server. If using FQDN, set up DNS resolution in the Device42 VM console first.
6363

64+
:::note
65+
You need to add each vCenter server you wish to discover. Device42 does not automatically find or crawl additional vCenter servers linked to your first one.
66+
:::
67+
6468
**Port:** This is 443 by default. Only change if you have changed it.
6569

6670
**Enable Resource Utilization Tracking for Device(s):** This option enables the periodic collection and examination of server resource usage metrics. See [Resource Utilization](/auto-discovery/resource-utilization-overview/) for more information.
@@ -202,4 +206,4 @@ Newly created jobs will not run on the first day they are created to prevent an
202206

203207
## Under the Hood
204208

205-
Device42 uses VMware APIs and the open-source library [pyvmomi](https://github.com/vmware/pyvmomi).
209+
Device42 uses VMware APIs and the open-source library [pyvmomi](https://github.com/vmware/pyvmomi).

docs/infrastructure-management/assets.mdx

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,13 @@ sidebar_position: 5.5
66
import ThemedImage from "@theme/ThemedImage";
77
import useBaseUrl from "@docusaurus/useBaseUrl";
88

9-
Assets are useful for tracking items that may not be directly discoverable. Like devices in Device42, assets can be racked, support lifecycle events, and assigned parts. However, assets do not consume licenses.
9+
Assets are useful for tracking items that may not be directly discoverable. Like devices in Device42, assets can support lifecycle events, be racked, and be assigned parts. However, assets do not consume licenses.
1010

1111
You can search, view, add, and edit assets from the list page under **Resources > All Assets**.
1212

1313
## Adding Assets
1414

15-
From the assets list page, click the **+ Add Asset** button to create a new asset.
15+
From the Assets list page, click the **Create** button to create a new asset.
1616

1717
<ThemedImage
1818
alt="Assets list page"
@@ -24,7 +24,7 @@ From the assets list page, click the **+ Add Asset** button to create a new asse
2424

2525
### Asset Types
2626

27-
Choose an asset **Type** from the dropdown menu or create a custom asset type by clicking **+** to the right. Different options in the add asset form will be available depending on the asset **Type** you select.
27+
Choose an asset **Type** from the dropdown menu or create a custom asset type by clicking **+** to the right. Different options in the Add Asset form will be available depending on the asset type you select.
2828

2929
<ThemedImage
3030
alt="Assets Types menu"
@@ -34,15 +34,14 @@ Choose an asset **Type** from the dropdown menu or create a custom asset type by
3434
}}
3535
/>
3636

37-
Name your custom asset type. If you want to associate assets of this new type to devices, check the **Asset Device Relation** checkbox. Designate the types of locations that assets of this type will be assigned to (**Storage Room**, **Server Room**, **Building**, and **Rack**).
37+
Name your custom asset type. If you want to associate assets of this new type with devices, check the **Asset Device Relation** checkbox. Designate the types of locations (**Storage Room**, **Server Room**, **Building**, and **Rack**) that assets of this type will be assigned to.
3838

3939
<ThemedImage
4040
alt="Create a custom asset type"
4141
sources={{
4242
light: useBaseUrl("/assets/images/assets-page/custom-type-light.png"),
4343
dark: useBaseUrl("/assets/images/assets-page/custom-type-dark.png"),
4444
}}
45-
style={{ width: "80%" }}
4645
/>
4746

4847
### Asset Lifecycle
@@ -59,7 +58,7 @@ Add the **Date** and choose the lifecycle **Event**. Optionally, add an **End Us
5958

6059
### Rack Info
6160

62-
Depending on the selected asset **Type**, the **Rack Info** box will be available.
61+
Show the **Rack Info** section by choosing **ACL** from the **Type** dropdown (or another similarly configured custom asset type).
6362

6463
<ThemedImage
6564
alt="Asset Rack Info box"
@@ -71,15 +70,15 @@ Depending on the selected asset **Type**, the **Rack Info** box will be availabl
7170

7271
### Object Category Field
7372

74-
In v19.06, the **Object Category** field on the view pages of individual Assets is displayed when **Role-Based Access Control** (RBAC) is enabled globally.
73+
In v19.06, the **Object Category** field on individual asset view pages is displayed only when **Role-Based Access Control** (RBAC) is enabled globally.
7574

7675
A workaround on view pages is to use the **Legacy View** button to see the **Object Category** field.
7776

7877
Turn on **Role-Based Access Control** under **Tools > Settings > Global Settings**.
7978

8079
## Asset Actions
8180

82-
The action menu has options to delete, export, and update assets. You can also **Generate QR/Barcodes for selected Items** for asset management.
81+
The action menu has options for deleting, exporting, and updating assets. You can also **Generate QR/Barcodes for selected Items** for asset management.
8382

8483
Select one or several assets from the table, and select an action from the menu:
8584
- Delete with Detailed Confirmation
@@ -92,8 +91,7 @@ Select one or several assets from the table, and select an action from the menu:
9291
- Assign lifecycle state to selected Items
9392
- Generate QR/Barcodes for selected Items
9493
- Add tags to selected items
95-
96-
Click the **hammer icon** to execute the selected action.
94+
- Set Custom Field Value
9795

9896
<ThemedImage
9997
alt="Asset Actions menu options"

docs/infrastructure-management/ipam/dns-records.mdx

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,21 @@ title: "DNS Records"
33
sidebar_position: 1
44
---
55

6+
import ThemedImage from '@theme/ThemedImage'
7+
import useBaseUrl from '@docusaurus/useBaseUrl'
8+
69
### Types of Records
710

8-
![wpid576-Types_of_Records.png](/assets/images/wpid576-Types_of_Records.png)
11+
<ThemedImage
12+
alt="Types of DNS Records"
13+
sources={{
14+
light: useBaseUrl('/assets/images/dns-records/wpid576-Types_of_Records-light.png'),
15+
dark: useBaseUrl('/assets/images/dns-records/wpid576-Types_of_Records-dark.png'),
16+
}}
17+
/>
918

1019
A/AAAA, CNAME, MX and PTR records are supported and can be automatically populated using [DNS auto-discovery.](auto-discovery/setup-dns-autodiscovery.mdx)
1120

1221
A/AAAA records are automatically associated with existing IP addresses (or can be associated with new IP Addresses when they are created).
1322

14-
You can search for records or filter by domain to edit/view certain records.
23+
You can search for records or filter by domain to edit or view certain records.

docs/infrastructure-management/ipam/dns-zones.mdx

Lines changed: 21 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -3,18 +3,34 @@ title: "DNS Zones"
33
sidebar_position: 2
44
---
55

6+
import ThemedImage from '@theme/ThemedImage'
7+
import useBaseUrl from '@docusaurus/useBaseUrl'
8+
69
DNS zones can be added manually or (preferrably) via DNS auto-discovery as discussed at: [discovery/setup-dns-autodiscovery.mdx](auto-discovery/setup-dns-autodiscovery.mdx)
710

811
## DNS Zone Add/Edit page
912

10-
The DNS Zones add/edit page can be reached via the main menu, _Network -> DNS Zones_. Click the "Add DNS Zone" button in the upper right to add a new zone. Give your zone a name, and specify the Nameserver for that zone. Optionally, you can specify the VRF Group that your new Zone belongs to, tags relevant to your new zone, and any relevant notes. Click "Save" in the bottom right when finished, and you'll be brought back to the DNS Zones list page, where you will see your new zone along with any others that exist.
13+
The DNS Zones add or edit page can be reached via the main menu, under **Resources > DNS Zones**. Click the **Create** button in the upper right to add a new zone. Give your zone a name, and specify the **Nameserver** for that zone. Optionally, you can specify the **VRF Group** that your new Zone belongs to, add **Tags** relevant to your new zone, and add any relevant **Notes**. Click **Save** in the bottom right when finished, and you'll be brought back to the DNS Zones list page, where you will see your new zone along with any others that exist.
1114

12-
![Add DNS Zo ne](/assets/images/add_DNS_zone.png)
15+
<ThemedImage
16+
alt="Add DNS Zone"
17+
sources={{
18+
light: useBaseUrl('/assets/images/dns-zones/add_DNS_zone-light.png'),
19+
dark: useBaseUrl('/assets/images/dns-zones/add_DNS_zone-dark.png'),
20+
}}
21+
style={{ width: '70%' }}
22+
/>
1323

14-
To define a DNS Zone, add/edit the zone specific fields show above.
24+
To define a DNS Zone, add or edit the zone specific fields show above.
1525

1626
## Editing existing records
1727

18-
To edit an existing DNS Zone Record, click the name of the DNS Zone Record you're trying to edit: ![Edit DNS Zone Record](/assets/images/DNS_Zone_Records_List.png)
28+
To edit an existing DNS Zone record (under under **Resources > DNS Zones**), click the name of the DNS Zone record you want to edit and click the **Edit** button in the upper right.
1929

20-
You can edit individual \\records from the DNS Records list page, _Network menu -> DNS Records_
30+
<ThemedImage
31+
alt="Edit DNS Zone Record"
32+
sources={{
33+
light: useBaseUrl('/assets/images/dns-zones/DNS_Zone_Records_List-light.png'),
34+
dark: useBaseUrl('/assets/images/dns-zones/DNS_Zone_Records_List-dark.png'),
35+
}}
36+
/>

docs/infrastructure-management/ipam/ip-addresses.mdx

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ You can search for IPs with full or partial entries right here. Clicking on an I
2828

2929
### Bulk Actions for IP Addresses
3030

31-
To perform a bulk action, check the IP addresses to affect from the list and select an action from the **Select an action** dropdown menu. Then click on the **hammer** icon to perform the selected bulk action.
31+
To perform a bulk action, check the IP addresses to affect from the list and select an action from the **Select an action** dropdown menu. Then confirm the action in the dialog to perform the selected bulk action.
3232

3333
<ThemedImage
3434
alt="Bulk actions menu"
@@ -41,16 +41,16 @@ To perform a bulk action, check the IP addresses to affect from the list and sel
4141

4242
The following bulk actions are available for IP addresses:
4343

44-
- **Export selected items to CSV**: create CSV export file.
44+
- **Export selected items to CSV**: Create CSV export file.
45+
- **Do a re-importable export for selected items**: Create an export file that you can re-import.
4546
- **Delete with Detailed Confirmation:** Displays prompt before deleting.
4647
- **Fast Background Delete**: Delete without prompt.
4748
- **Mark selected IP as available:** Will only mark those IPs available that have no device association.
48-
- **Mark selected IPs as not available** : Will mark selected IPs as not available.
49-
- **Clear ALL fields and Mark selected IPs as available** : This command will clear all device association for the selected IPs and mark those IPs as available.
50-
- **Relocate Selected IPs** : This will bring up a matching subnets page based on first selected IPs. You can choose to move IPs to another subnet with this. Only IPs that are within the range will be moved.
51-
- **Do a re-importable export for selected items**: Create an export file that you can re-import.
49+
- **Mark selected IPs as not available**: Will mark selected IPs as not available.
50+
- **Clear ALL fields and Mark selected IPs as available**: This command will clear all device associations for the selected IPs and mark those IPs as available.
51+
- **Relocate Selected IPs**: This will bring up a matching subnets page based on the first selected IPs. You can choose to move IPs to another subnet with this. Only IPs that are within the range will be moved.
5252
- **Add tags to selected items**: add a comma-separated list of tags.
53-
- **Check/Fix selected IPs Subnet assignment**: Displays a page to check or fix Subnet assignment.
53+
- **Check/Fix selected IPs Subnet assignment**: Displays a page to check or fix the Subnet assignment.
5454

5555
### View IP Address Page
5656

@@ -65,17 +65,17 @@ Click on an IP address to view its details.
6565
/>
6666
<br/><br/>
6767

68-
You can see the history of changes for that IP address from the **History (Audit Logs)** button at the top right of the page (similar to all other view pages in the application). If you have appropriate permissions, the **Edit** button will be available. All DNS records that use this IP are shown in the view page as well.
68+
You can see the history of changes for that IP address from the **History (Audit Logs)** tab at the top of the page (similar to all other view pages in the application). If you have appropriate permissions, the **Edit** button will be available. All DNS records that use this IP are shown in the view page as well.
6969

70-
In the example above, clicking on the link called _demo_ in the **Resource** field will take you to the K8s cluster that is currently holding that IP.
70+
Clicking on the link in the **Resource** field will take you to the K8s cluster that is currently holding that IP.
7171

7272
:::note
73-
Entries in the **Configuration Resource** and **Configuration Resource Item** fields make sense only in the context of a Kubernetes cloud discovery job ([cloud platforms autodiscovery](auto-discovery/cloud-auto-discovery/index.mdx)) and are filled in automatically. These field should not be populated for a regular IP address.
73+
Entries in the **Configuration Resource** and **Configuration Resource Item** fields make sense only in the context of a Kubernetes cloud discovery job ([cloud platforms autodiscovery](auto-discovery/cloud-auto-discovery/index.mdx)) and are filled in automatically. These fields should not be populated for a regular IP address.
7474
:::
7575

7676
### Add/Edit Page
7777

78-
Click on the **Add IP Address** button on the view page to add an IP address.
78+
Click on the **Create** button on the view page to add an IP address.
7979

8080
<ThemedImage
8181
alt="Add IP address button"
@@ -86,7 +86,7 @@ Click on the **Add IP Address** button on the view page to add an IP address.
8686
/>
8787
<br/><br/>
8888

89-
When Adding or editing an IP, the Subnet field is required. Device42 will automatically check if the IP falls within the allowed IP range in the subnet and will not allow duplicate IP to be added in that VRF group or subnet (if not a VRF group). You can choose an existing Device and Port or add a new ones from this page.
89+
When adding or editing an IP, the Subnet field is required. Device42 will automatically check if the IP falls within the allowed IP range in the subnet and will not allow duplicate IPs to be added in that VRF group or subnet (if not a VRF group). You can choose an existing device and port or add new ones from this page.
9090

9191
<ThemedImage
9292
alt="Add IP address form"
@@ -97,7 +97,7 @@ When Adding or editing an IP, the Subnet field is required. Device42 will automa
9797
/>
9898
<br/><br/>
9999

100-
To enter additional device(s) to associate with an already-created IP address, click on the **Edit** button of the IP address from its view page. Then click on the **Add another device association** button.
100+
To enter additional device(s) to associate with an already-created IP address, click on the **Edit** button of the IP address from its view page. Then click on the **+ Add New** button.
101101

102102
<ThemedImage
103103
alt="Add device from editing view"
@@ -114,4 +114,4 @@ Select **Resources > DNS > All DNS Records** from the main menu to add DNS A/AAA
114114

115115
### IP Address Management from the Command Line
116116

117-
With Device42, you can find if an IP is already in a D42 instance, suggest a next available IP and add an IP from the command line using the REST APIs. Here is a post discussing this: [https://www.device42.com/blog/2013/03/27/ip-address-management-from-the-command-line/](https://www.device42.com/blog/2013/03/27/ip-address-management-from-the-command-line/)
117+
With Device42, you can find if an IP is already in a D42 instance, suggest the next available IP, and add an IP from the command line using the REST APIs. Here is a post discussing this: [https://www.device42.com/blog/2013/03/27/ip-address-management-from-the-command-line/](https://www.device42.com/blog/2013/03/27/ip-address-management-from-the-command-line/)

docs/infrastructure-management/ipam/ip-nat-map.mdx

Lines changed: 41 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -3,27 +3,50 @@ title: "IP NAT/Map"
33
sidebar_position: 4
44
---
55

6+
import ThemedImage from '@theme/ThemedImage'
7+
import useBaseUrl from '@docusaurus/useBaseUrl'
8+
69
IP Nat/Map functions are used for routing, such as routing external IPs to internal IPs or routing traffic within different network segments. You define IP Nat/Maps as they are not found during discovery.
710

8-
- To create an IP Nat/Map, go to _Resources > IPs > IP NAT_ to display Nat/Map list page, and then click _Add IP Nat/Map_ at the top right.
11+
- To create an IP Nat/Map, go to **Resources > IPs > IP NAT** to display Nat/Map list page, and then click **Create** at the top right.
912

10-
![](/assets/images/WEB-597_ip-nat-map-menu-1-700x351.png)
13+
<ThemedImage
14+
alt="IP NAT/Map menu"
15+
sources={{
16+
light: useBaseUrl('/assets/images/ip-nat-map/WEB-597_ip-nat-map-menu-1-700x351-light.png'),
17+
dark: useBaseUrl('/assets/images/ip-nat-map/WEB-597_ip-nat-map-menu-1-700x351-dark.png'),
18+
}}
19+
/>
1120

1221
Device42 displays the Nat/Map add page.
1322

14-
![](/assets/images/WEB-597_ip-nat-map-add-700x390.png)
15-
16-
- Enter a _Name_ for the Nat/Map, and then enter the _Source IP Address Start_ and _Target IP Address Start_. You can also use the magnifying glass icon to select an IP address.
17-
18-
![](/assets/images/WEB-597_ip-nat-map-select-ipaddress-1-700x313.png)
19-
20-
- You can also or select or enter these options:
21-
- _Two way relation_
22-
- _Protocol_
23-
- _Source IP Address End_
24-
- _Source Port Stat_
25-
- _Source Port End_
26-
- _Target IP Address End_
27-
- _Target Port Start_
28-
- _Target Port End_
29-
- When done, click _Save_. The IP Nat/Map is added to the list.
23+
<ThemedImage
24+
alt="IP NAT/Map add page"
25+
sources={{
26+
light: useBaseUrl('/assets/images/ip-nat-map/WEB-597_ip-nat-map-add-700x390-light.png'),
27+
dark: useBaseUrl('/assets/images/ip-nat-map/WEB-597_ip-nat-map-add-700x390-dark.png'),
28+
}}
29+
/>
30+
31+
- Enter a **Name** for the Nat/Map, and then enter the **Source IP Address Start** and **Target IP Address Start**. You can also use the plus icon to select an IP address.
32+
33+
<ThemedImage
34+
alt="Select IP address"
35+
sources={{
36+
light: useBaseUrl('/assets/images/ip-nat-map/WEB-597_ip-nat-map-select-ipaddress-1-700x313-light.png'),
37+
dark: useBaseUrl('/assets/images/ip-nat-map/WEB-597_ip-nat-map-select-ipaddress-1-700x313-dark.png'),
38+
}}
39+
/>
40+
41+
- You can also select or enter these options:
42+
43+
- **Two way relation**
44+
- **Protocol**
45+
- **Source IP Address End**
46+
- **Source Port Stat**
47+
- **Source Port End**
48+
- **Target IP Address End**
49+
- **Target Port Start**
50+
- **Target Port End**
51+
52+
- When done, click **Save**. The IP Nat/Map is added to the list.

0 commit comments

Comments
 (0)