Skip to content

Commit 27a02e0

Browse files
authored
Merge pull request #449 from ritza-co/19.06.03
Docs 19.06.03 release (Week 21, 2025)
2 parents e56529b + 29e09bd commit 27a02e0

327 files changed

Lines changed: 514 additions & 443 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/active-directory-sync.mdx

Lines changed: 54 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -22,43 +22,61 @@ Before you create and run your AD/LDAP discovery jobs, configure the **Active Di
2222

2323
1. From the main menu, head to **Tools > Settings > Active Directory Settings**:
2424

25-
<ThemedImage
26-
alt="Active Directory Settings menu location"
27-
sources={{
28-
light: useBaseUrl('/assets/images/active-directory-sync/config-menu-light.png'),
29-
dark: useBaseUrl('/assets/images/active-directory-sync/config-menu-dark.png'),
30-
}}
31-
/>
32-
33-
2. Click the **+ Add Active Directory / LDAP Settings** button and enter values specific to your Active Directory (or LDAP) domain. Refer to the explanation of the fields below the image.
25+
<ThemedImage
26+
alt="Active Directory Settings menu"
27+
sources={{
28+
light: useBaseUrl('/assets/images/active-directory-sync/active-directory-menu-light.png'),
29+
dark: useBaseUrl('/assets/images/active-directory-sync/active-directory-menu-dark.png'),
30+
}}
31+
/>
3432

35-
<ThemedImage
36-
alt="Active Directory Settings example values"
37-
sources={{
38-
light: useBaseUrl('/assets/images/active-directory-sync/settings-form-light.png'),
39-
dark: useBaseUrl('/assets/images/active-directory-sync/settings-form-dark.png'),
40-
}}
41-
/>
33+
2. Click the **Create** button and enter values specific to your Active Directory (or LDAP) domain.
4234

4335
**Explanation of the fields**
36+
4437
- **LDAP Type**: Choose either **Active Directory** or **Open LDAP** for Lightweight directory access protocol for non-Microsoft directory servers.
4538
- **Server**: Enter the AD or LDAP server IP address. Only use FQDN if your DNS can resolve it. Rather enter an IP address if your Device42 server doesn't use AD-Aware DNS servers, as it may not be able to resolve your domain name if it hasn't been configured across all your DNS servers
4639
- **Backup Server**: Add a secondary AD or LDAP server to use if the primary one isn't available.
40+
41+
<ThemedImage
42+
alt="Active Directory Settings example values"
43+
sources={{
44+
light: useBaseUrl('/assets/images/active-directory-sync/active-directory-name-light.png'),
45+
dark: useBaseUrl('/assets/images/active-directory-sync/active-directory-name-dark.png'),
46+
}}
47+
/>
48+
4749
- **Port**: Port for auth requests to your LDAP or Active Directory server. Note that **389** is the non-SSL default and **636** is the default SSL port. Ensure you change the port if you decide to enable SSL or run a non-standard port.
4850
- **Base**: Enter the Base DN that points to your users.
51+
52+
<ThemedImage
53+
alt="Active Directory Settings example values"
54+
sources={{
55+
light: useBaseUrl('/assets/images/active-directory-sync/active-directory-port-light.png'),
56+
dark: useBaseUrl('/assets/images/active-directory-sync/active-directory-port-dark.png'),
57+
}}
58+
/>
59+
4960
- **SSL**: Check this box if you want to query AD or LDAP using SSL. Please change the port to **636** or your configured SSL port if you check this box.
5061
- **Username/Password**: This is the username a password that will be used for authentication against AD.
51-
- **Username login Style**: Choose how Device42 accounts created for AD users will be formatted both in Device42 and for login.
62+
- **Username login style**: Choose how Device42 accounts created for AD users will be formatted both in Device42 and for login.
5263

5364
:::caution
5465
Changes to this setting only affects users imported after the change. To change the account and login format for all users, delete the existing Device42 accounts, change the login style setting, and then re-sync the accounts from AD.
5566
:::
5667

5768
- **Netbios name**: NetBIOS name is an up-to-15-character representation of your domain name, and may actually be entirely different from the domain name. Visit the [Microsoft Disjoint namespace scenarios](https://learn.microsoft.com/en-us/exchange/disjoint-namespace-scenarios-exchange-2013-help) article for help locating domain NetBIOS names.
5869

70+
<ThemedImage
71+
alt="Active Directory Settings example values"
72+
sources={{
73+
light: useBaseUrl('/assets/images/active-directory-sync/active-directory-username-light.png'),
74+
dark: useBaseUrl('/assets/images/active-directory-sync/active-directory-username-dark.png'),
75+
}}
76+
/>
5977
## Configure an AD/LDAP User Discovery Job
6078

61-
When you've configured the AD/LDAP settings, create an AD/LDAP sync job. From the main menu, go to **Discovery > AD/LDAP Users** and click **Add AD/LDAP Sync**.
79+
When you've configured the AD/LDAP settings, create an AD/LDAP sync job. From the main menu, go to **Discovery > AD/LDAP Users** and click **Create**.
6280

6381
### Choose User Type
6482

@@ -67,8 +85,8 @@ Name the AD/LDAP sync job. Then choose the Device42 user **Type** to create from
6785
<ThemedImage
6886
alt="User type dropdown"
6987
sources={{
70-
light: useBaseUrl('/assets/images/active-directory-sync/user-type-light.png'),
71-
dark: useBaseUrl('/assets/images/active-directory-sync/user-type-dark.png'),
88+
light: useBaseUrl('/assets/images/active-directory-sync/user-type-19.06-light.png'),
89+
dark: useBaseUrl('/assets/images/active-directory-sync/user-type-19.06-dark.png'),
7290
}}
7391
/>
7492

@@ -77,8 +95,8 @@ Name the AD/LDAP sync job. Then choose the Device42 user **Type** to create from
7795
<ThemedImage
7896
alt="User type attribute options"
7997
sources={{
80-
light: useBaseUrl('/assets/images/active-directory-sync/end-user-attributes-light.png'),
81-
dark: useBaseUrl('/assets/images/active-directory-sync/end-user-attributes-dark.png'),
98+
light: useBaseUrl('/assets/images/active-directory-sync/end-user-attributes-19.06-light.png'),
99+
dark: useBaseUrl('/assets/images/active-directory-sync/end-user-attributes-19.06-dark.png'),
82100
}}
83101
/>
84102

@@ -91,8 +109,8 @@ Name the AD/LDAP sync job. Then choose the Device42 user **Type** to create from
91109
<ThemedImage
92110
alt="Administrator options"
93111
sources={{
94-
light: useBaseUrl('/assets/images/active-directory-sync/administrator-options-light.png'),
95-
dark: useBaseUrl('/assets/images/active-directory-sync/administrator-options-dark.png'),
112+
light: useBaseUrl('/assets/images/active-directory-sync/administrator-options-19.06-light.png'),
113+
dark: useBaseUrl('/assets/images/active-directory-sync/administrator-options-19.06-dark.png'),
96114
}}
97115
/>
98116

@@ -103,8 +121,8 @@ Specify a Custom LDAP Filter in the **Custom Filter** field to define which obje
103121
<ThemedImage
104122
alt="Custom Filter field"
105123
sources={{
106-
light: useBaseUrl('/assets/images/active-directory-sync/custom-filter-light.png'),
107-
dark: useBaseUrl('/assets/images/active-directory-sync/custom-filter-dark.png'),
124+
light: useBaseUrl('/assets/images/active-directory-sync/custom-filter-19.06-light.png'),
125+
dark: useBaseUrl('/assets/images/active-directory-sync/custom-filter-19.06-dark.png'),
108126
}}
109127
/>
110128

@@ -133,8 +151,8 @@ Next, choose the settings configuration you created in the [Prerequisites sectio
133151
<ThemedImage
134152
alt="Settings and credential fields"
135153
sources={{
136-
light: useBaseUrl('/assets/images/active-directory-sync/settings-and-auth-light.png'),
137-
dark: useBaseUrl('/assets/images/active-directory-sync/settings-and-auth-dark.png'),
154+
light: useBaseUrl('/assets/images/active-directory-sync/settings-and-auth-19.06-light.png'),
155+
dark: useBaseUrl('/assets/images/active-directory-sync/settings-and-auth-19.06-dark.png'),
138156
}}
139157
/>
140158

@@ -147,8 +165,8 @@ Select from the available **Permission Groups** on the left and use the arrow bu
147165
<ThemedImage
148166
alt="Permission Groups for Administrators"
149167
sources={{
150-
light: useBaseUrl('/assets/images/active-directory-sync/permission-groups-light.png'),
151-
dark: useBaseUrl('/assets/images/active-directory-sync/permission-groups-dark.png'),
168+
light: useBaseUrl('/assets/images/active-directory-sync/permission-groups-19.06-light.png'),
169+
dark: useBaseUrl('/assets/images/active-directory-sync/permission-groups-19.06-dark.png'),
152170
}}
153171
/>
154172

@@ -157,8 +175,8 @@ To create a new Admin group, click the **plus icon**, and in the popup that open
157175
<ThemedImage
158176
alt="Create new Admin Groups"
159177
sources={{
160-
light: useBaseUrl('/assets/images/active-directory-sync/add-new-admin-group-light.png'),
161-
dark: useBaseUrl('/assets/images/active-directory-sync/add-new-admin-group-dark.png'),
178+
light: useBaseUrl('/assets/images/active-directory-sync/add-new-admin-group-19.06-light.png'),
179+
dark: useBaseUrl('/assets/images/active-directory-sync/add-new-admin-group-19.06-dark.png'),
162180
}}
163181
/>
164182

@@ -169,8 +187,8 @@ If you chose **End Users** as the **Type**, you'll have the option to add your D
169187
<ThemedImage
170188
alt="Departments for End Users"
171189
sources={{
172-
light: useBaseUrl('/assets/images/active-directory-sync/departments-light.png'),
173-
dark: useBaseUrl('/assets/images/active-directory-sync/departments-dark.png'),
190+
light: useBaseUrl('/assets/images/active-directory-sync/departments-19.06-light.png'),
191+
dark: useBaseUrl('/assets/images/active-directory-sync/departments-19.06-dark.png'),
174192
}}
175193
/>
176194

@@ -179,8 +197,8 @@ Click the **plus icon** to add a new customer, department, or end user that's no
179197
<ThemedImage
180198
alt="Departments for End Users"
181199
sources={{
182-
light: useBaseUrl('/assets/images/active-directory-sync/new-customer-form-light.png'),
183-
dark: useBaseUrl('/assets/images/active-directory-sync/new-customer-form-dark.png'),
200+
light: useBaseUrl('/assets/images/active-directory-sync/new-customer-form-19.06-light.png'),
201+
dark: useBaseUrl('/assets/images/active-directory-sync/new-customer-form-19.06-dark.png'),
184202
}}
185203
/>
186204

docs/auto-discovery/agent-based-offline-discovery.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,8 @@ The discovery agent is built-in to your Device42 instance, and can be downloaded
3737
<ThemedImage
3838
alt="Agent-Based Scans in menu"
3939
sources={{
40-
light: useBaseUrl('/assets/images/agent-based-offline-discovery/menu-agent-discovery-light.png'),
41-
dark: useBaseUrl('/assets/images/agent-based-offline-discovery/menu-agent-discovery-dark.png'),
40+
light: useBaseUrl('/assets/images/agent-based-offline-discovery/menu-agent-discovery-19.06-light.png'),
41+
dark: useBaseUrl('/assets/images/agent-based-offline-discovery/menu-agent-discovery-19.06-dark.png'),
4242
}}
4343
/>
4444

@@ -47,8 +47,8 @@ The discovery agent is built-in to your Device42 instance, and can be downloaded
4747
<ThemedImage
4848
alt="Agent-Based Scans in menu"
4949
sources={{
50-
light: useBaseUrl('/assets/images/agent-based-offline-discovery/download-agent-light.png'),
51-
dark: useBaseUrl('/assets/images/agent-based-offline-discovery/download-agent-dark.png'),
50+
light: useBaseUrl('/assets/images/agent-based-offline-discovery/download-agent-19.06-light.png'),
51+
dark: useBaseUrl('/assets/images/agent-based-offline-discovery/download-agent-19.06-dark.png'),
5252
}}
5353
/>
5454

@@ -62,7 +62,7 @@ The discovery agent is built-in to your Device42 instance, and can be downloaded
6262

6363
3. On Windows, you can skip this step. On Linux, change file permissions to make the file executable using the command:
6464
```
65-
chmod +x d42\_agentname:
65+
chmod +x d42_agentname:
6666
```
6767
_For example:_
6868

docs/auto-discovery/blade-systems-auto-discovery.mdx

Lines changed: 26 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ sidebar_position: 7
66
import ThemedImage from '@theme/ThemedImage'
77
import useBaseUrl from '@docusaurus/useBaseUrl'
88

9-
The Blade Systems autodiscovery method discovers HP and IBM blade systems, including the IBM BladeCenter. Cisco UCS is also supported but in a separate menu entry.
9+
The Blade Systems autodiscovery method discovers HP and IBM blade systems, including the IBM BladeCenter. Cisco UCS is also supported, but in a separate menu entry.
1010

1111
If you would like to see other vendors, please email [support@device42.comt](mailto:support@device42.com).
1212

@@ -17,13 +17,13 @@ Blade server discovery gets the following information:
1717

1818
## Add a Blade System Autodiscovery Job
1919

20-
Navigate to **Discovery > SNMP > Add SNMP Autodiscovery Job** and click **+ Add Jobs**.
20+
Navigate to **Discovery > SNMP** and click the **Create** button.
2121

2222
<ThemedImage
2323
alt="Blade system discovery job example"
2424
sources={{
25-
light: useBaseUrl('/assets/images/blade-systems-auto-discovery/add-snmp-job-light.png'),
26-
dark: useBaseUrl('/assets/images/blade-systems-auto-discovery/add-snmp-job-dark.png'),
25+
light: useBaseUrl('/assets/images/blade-systems-auto-discovery/add-snmp-job-19.06-light.png'),
26+
dark: useBaseUrl('/assets/images/blade-systems-auto-discovery/add-snmp-job-19.06-dark.png'),
2727
}}
2828
/>
2929

@@ -33,7 +33,15 @@ Fill in the basic job details:
3333
2. **Port:** The default is "161".
3434
3. **Give Precedence to hostname:** to overwrite the existing name, if one exists.
3535
4. **Strip domain name:** Strip domain suffix from discovered device name.
36-
5. Scroll down to **Credentials** and select the **SNMP version** (v1, v2c, v3 ) and add the authentication to use.
36+
5. Scroll down to **Credential(s)**, select the **SNMP version** (v1, v2c, v3 ), and add the authentication details.
37+
38+
<ThemedImage
39+
alt="Blade system discovery job example"
40+
sources={{
41+
light: useBaseUrl('/assets/images/blade-systems-auto-discovery/snmp-credentials-light.png'),
42+
dark: useBaseUrl('/assets/images/blade-systems-auto-discovery/snmp-credentials-dark.png'),
43+
}}
44+
/>
3745

3846
### Blade System Options
3947

@@ -42,13 +50,13 @@ Scroll down to the **Enclosure/blade system options** section and click **Show**
4250
<ThemedImage
4351
alt="Enclosure/blade system options section"
4452
sources={{
45-
light: useBaseUrl('/assets/images/blade-systems-auto-discovery/blade-system-options-light.png'),
46-
dark: useBaseUrl('/assets/images/blade-systems-auto-discovery/blade-system-options-dark.png'),
53+
light: useBaseUrl('/assets/images/blade-systems-auto-discovery/blade-system-options-19.06-light.png'),
54+
dark: useBaseUrl('/assets/images/blade-systems-auto-discovery/blade-system-options-19.06-dark.png'),
4755
}}
4856
/>
4957

50-
1. Choose the **Name to use for newly discovered module or IPMI**. Select **Serial #** to avoid duplicate names for newly discovered items.
51-
- Serial #
58+
1. Choose the **Name to use for newly discovered module or IPMI**. Select **Serial #** from the following list of options to avoid creating duplicate names for newly discovered items.
59+
- Serial #
5260
- Try name from SNMP, otherwise use serial #
5361
- Append serial # to name
5462
2. Deselect **Toggle in service on module power state** to prevent the system from automatically changing the service status of the module based on its power state.
@@ -61,30 +69,24 @@ Scroll down to the **Enclosure/blade system options** section and click **Show**
6169

6270
**Save** the blade autodiscovery job.
6371

64-
:::note
65-
Newly created jobs will not run on the first day they are created to prevent an unintentionally large amount of jobs from initially running. If you would like to run a job after its initial creation, select the **Run Now** button next to the job after creation.
66-
:::
67-
68-
### Schedule the Job
69-
70-
Scroll down to create a run schedule for the job. Create multiple schedules for the job with the **+ Add another Autodiscovery Schedule** button.
72+
Newly created jobs will not run on the first day they are created to prevent an unintentionally large number of jobs from initially running. If you would like to run a job after its initial creation, click the **Run Now** button on the job details page or on the SNMP Autodiscovery list page.
7173

7274
<ThemedImage
73-
alt="Schedule the blade system job"
75+
alt="Run the blade system job from the list page"
7476
sources={{
75-
light: useBaseUrl('/assets/images/blade-systems-auto-discovery/schedule-job-light.png'),
76-
dark: useBaseUrl('/assets/images/blade-systems-auto-discovery/schedule-job-dark.png'),
77+
light: useBaseUrl('/assets/images/blade-systems-auto-discovery/snmp-list-page-run-now-light.png'),
78+
dark: useBaseUrl('/assets/images/blade-systems-auto-discovery/snmp-list-page-run-now-dark.png'),
7779
}}
7880
/>
7981

80-
### Run Now
82+
### Schedule the Job
8183

82-
**Save** the blade autodiscovery job to return to the SNMP autodiscovery list page, and click **Run Now**.
84+
On the add or edit modes of the SNMP discovery job page, scroll down to create a run schedule for the job. Create multiple schedules for the job with the **+ Add another Autodiscovery Schedule** button.
8385

8486
<ThemedImage
85-
alt="Run the blade system job from the list page"
87+
alt="Schedule the blade system job"
8688
sources={{
87-
light: useBaseUrl('/assets/images/blade-systems-auto-discovery/run-now-button-light.png'),
88-
dark: useBaseUrl('/assets/images/blade-systems-auto-discovery/run-now-button-dark.png'),
89+
light: useBaseUrl('/assets/images/blade-systems-auto-discovery/snmp-schedule-job-19.06-light.png'),
90+
dark: useBaseUrl('/assets/images/blade-systems-auto-discovery/snmp-schedule-job-19.06-dark.png'),
8991
}}
9092
/>

0 commit comments

Comments
 (0)