Merge pull request #467 from ritza-co/19.06.14

Docs 19.06.14 release (Week 33, 2025)

Author: sixhobbits

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

@@ -92,7 +92,7 @@ The agent can be run from the command line or can be scheduled using the relevan
     -extended-logs
           enables extended logs
     -host string
-          overrides built-in host
+          specifies the Main Appliance or Remote Collector target (overrides built-in host)
     -hostname-precedence
           sets device name as 'new name' to prevent creation of new device if only hostname was changed
     -ignore-domain

docs/auto-discovery/nmap-autodiscovery.mdx

@@ -10,14 +10,14 @@ import useBaseUrl from '@docusaurus/useBaseUrl'
 
 Nmap (network mapper) is a tool primarily used for security scanning. However, it can be used to “guess” which services are running on which ports. Device42 uses Nmap to discover which services are running on which ports and automatically combines this data with the [NetFlow](auto-discovery/netflow-collector.mdx) data to automatically create a map of services and application dependencies.
 
-## Add a Nmap Autodiscovery Job
+## Add an Nmap Autodiscovery Job
 
 Navigate to the  **Discovery > Nmap** list page and click **Create** to add a new Nmap autodiscovery job. 
 
 Enter the following required fields for the Nmap job:
 
-- **Name:** Unique name for the job
-- **Remote Collector:** The Device42 ID for the remote collector to use for the job.
+- **Name:** A unique name for the job.
+- **Remote Collector:** The name of the Remote Collector to use. A Local Collector cannot be used.
 - **Target Host(s) and Network(s):** A comma-separated list of IP addresses, IP ranges, CIDR block(s), or hostname(s) to use for Nmap discovery.
 
 <ThemedImage
@@ -77,11 +77,11 @@ The **Run Now** button is also available on the list page (**Discovery > Nmap**)
 
 In Device42, NetFlow and Nmap can be used by themselves, together, or in combination with point-in-time discovery. Using NetFlow and Nmap data together but without point-in-time discovery results in a good services dependency mapping capability. However, just using these two sources of data is still limited in the following ways:
 
-1. A map of service inter-dependencies and interrelationships can be created. However, many services often combine applications and associated information to form the entire application. For example, there might be multiple Oracle services plus configuration files that together form the Oracle application. Installed apps on a web server and instances and named pipes on a database cannot be discovered by the NetFlow/Nmap combination.
-2. The services that Nmap finds are guesses and the guessed version number is probably wrong as often as it is right.
-3. Some enterprises have such restrictive firewall rules that Nmap will discover few if any services.
+1. A map of service inter-dependencies and interrelationships can be created. However, many services often combine applications and associated information to form the entire application. For example, there might be multiple Oracle services plus configuration files that together form the Oracle application. Installed apps on a web server, and instances and named pipes on a database, cannot be discovered by the NetFlow/Nmap combination.
+2. The services that Nmap finds are guesses, and the guessed version number is probably wrong as often as it is right.
+3. Some enterprises have such restrictive firewall rules that Nmap will discover few, if any, services.
 4. NetFlow can’t “see” application interactions inside a physical, virtual, or cloud server. NetFlow can only see interactions that go through the router. So, many dependencies will be missed.
-5. While NetFlow works well for physical routers and switches, it's not great for the virtual routers and switches found in hyper-visors because many hyper-visors do not support NetFlow.
+5. While NetFlow works well for physical routers and switches, it's not great for the virtual routers and switches found in hypervisors because many hypervisors do not support NetFlow.
 6. On routers and switches, NetFlow must be set up for every segment. If some segments are not set up, the application interactions will not be found.
 
 To overcome these limitations, it is better to use NetFlow and Nmap in conjunction with point-in-time discovery.

docs/infrastructure-management/accounting/purchases.mdx

@@ -11,34 +11,41 @@ Device42 can track purchases of devices and assets including service and warrant
 
 ### Add a Purchase
 
-To add a new purchase, navigate to **Infrastructure > Purchases** and click **+ Add Purchase**.
+To add a new purchase, navigate to **Infrastructure > Purchases** and click **Create**.
 
 This example is for a hypothetical purchase of 25 Dell PE1950 servers for the R&D department charged to **Cost Center** 12056:
-- To populate the **Total cost for non-recurring line items** value, fill in the **Quantity** and **Unit cost** details for the first line item and click **Save and continue editing**.
-- You can attach a PDF of the purchase contract by clicking **+ Add another File Attachment** and browsing to the file.
-
-<ThemedImage
-  alt="Add a new purchase"
-  sources={{
-    light: useBaseUrl('/assets/images/purchases/add-purchase-light.png'),
-    dark: useBaseUrl('/assets/images/purchases/add-purchase-dark.png'),
-  }}
-  style={{ width: '110%' }} 
-/>
+- To populate the **Total cost for non-recurring line items** value, fill in the **Quantity** and **Unit cost** details for the first line item.
+
+  <ThemedImage
+    alt="Add a new purchase"
+    sources={{
+      light: useBaseUrl('/assets/images/purchases/unit-costs-light.png'),
+      dark: useBaseUrl('/assets/images/purchases/unit-costs-dark.png'),
+    }}
+  />
+
+  <ThemedImage
+    alt="Add a new purchase"
+    sources={{
+      light: useBaseUrl('/assets/images/purchases/attachment-line-item-light.png'),
+      dark: useBaseUrl('/assets/images/purchases/attachment-line-item-dark.png'),
+    }}
+  />
+
+You can attach a PDF of the purchase contract by clicking **+ Add another File Attachment** and browsing to the file.
 
 ### Line Items 
 
 Each line item for the purchase will have a **Line Type** and an **Item Type**.
 
-For **Line Type** choose **Contract** for service, warranty, and other contracts and choose **Device/Asset/Tax etc.** for everything else.
+For **Line Type** choose **Contract** for service, warranty, and other contracts, and choose **Device/Asset/Tax etc.** for everything else.
 
 <ThemedImage
   alt="Line item options"
   sources={{
     light: useBaseUrl('/assets/images/purchases/line-type-light.png'),
     dark: useBaseUrl('/assets/images/purchases/line-type-dark.png'),
   }}
-  style={{ width: '35%' }} 
 />
 
 The **Item Type** has a list of selections that can apply to either Line Type. For example, if the Line Type is **Device/Asset/Tax etc.**, choosing **Device** for the Item Type means that this line represents one or more devices. 
@@ -51,10 +58,9 @@ If a service contract is purchased for each device, you can include a second lin
     light: useBaseUrl('/assets/images/purchases/item-type-light.png'),
     dark: useBaseUrl('/assets/images/purchases/item-type-dark.png'),
   }}
-  style={{ width: '25%' }} 
 />
 
-Here is a full view of the both line items:
+
 
 <ThemedImage
   alt="Line item 1 example"
@@ -64,19 +70,20 @@ Here is a full view of the both line items:
   }}
   style={{ width: '110%' }} 
 />
-<ThemedImage
-  alt="Line item 1 example"
-  sources={{
-    light: useBaseUrl('/assets/images/purchases/line-item-2-light.png'),
-    dark: useBaseUrl('/assets/images/purchases/line-item-2-dark.png'),
-  }}
-  style={{ width: '110%' }} 
-/>
 
 A few things to note:  
-1. If the **Line Type** is **Contract** a set of extra fields like **Frequency** will become available.  
+1. If the **Line Type** is **Contract**, a set of extra fields like **Frequency** will become available.
+
+  <ThemedImage
+    alt="Contract type"
+    sources={{
+      light: useBaseUrl('/assets/images/purchases/contract-line-type-light.png'),
+      dark: useBaseUrl('/assets/images/purchases/contract-line-type-dark.png'),
+    }}
+  />
+
 2. You can assign a **Cost Center** and **Customer** at either the purchase header level (applies to all line items) or the individual line item level.  
-3. You can associate the actual devices purchased with the line item. This can be done at the time of purchase or a later date.
+3. You can associate the actual devices purchased with the line item. This can be done at the time of purchase or at a later date.
 
 ## Reporting
 
@@ -94,20 +101,18 @@ The [Insights+](https://www.device42.com/insights-plus/) option, located on the
     light: useBaseUrl('/assets/images/purchases/reports-menu-light.png'),
     dark: useBaseUrl('/assets/images/purchases/reports-menu-dark.png'),
   }}
-  style={{ width: '85%' }}
 />
 
 ### Standard Reports
 
-Navigate to **Analytics > Standard Reports** and click **Add Report**. Select **Purchases** or **Purchase Line Items** from the **Select Object** dropdown menu to reveal related options for configuring your purchases report. Like the other reports, you can schedule and email the report results.
+Navigate to **Analytics > Standard Reports** and click **Create**. Select **Purchases** or **Purchase Line Items** from the **Select Object** dropdown menu to reveal related options for configuring your purchases report. Like the other reports, you can schedule and email the report results.
 
 <ThemedImage
   alt="Create new Standard Report"
   sources={{
     light: useBaseUrl('/assets/images/purchases/new-standard-report-light.png'),
     dark: useBaseUrl('/assets/images/purchases/new-standard-report-dark.png'),
   }}
-  style={{ width: '85%' }}
 />
 
 ### Advanced Reporting
@@ -120,5 +125,4 @@ Device42 features an [Advanced Reporting](../../reports/reports/creating-reports
     light: useBaseUrl('/assets/images/purchases/advanced-reporting-create-light.png'),
     dark: useBaseUrl('/assets/images/purchases/advanced-reporting-create-dark.png'),
   }}
-  style={{ width: '85%' }}
 />

docs/infrastructure-management/devices/hardware-models-templates.mdx

@@ -28,7 +28,7 @@ Open a new hardware model form by clicking **Create** at the top right of the li
 
 In the **Name** field, enter the model name. The manufacturer name will be automatically added to the model name whenever this hardware model is displayed. For example, if you have specified the manufacturer as Dell, you can enter "PE2950" for a Dell PE2950 and the model will be displayed as "Dell PE2950".
 
-In the **Physical Subtype** field, indicate whether the model is for a physical device (rackable), blade device, or other device (for example, laptops or workstations). Depending on the type you choose, the size or blade size will be populated in the form.
+In the **Physical Subtype** field, indicate whether the model is for a physical device (rackable), blade device, or other device (for example, laptops or workstations). Depending on the type you choose, different fields will become available.
 
 **Size** is the size of the physical device or regular type in Us. You can enter "1/2" or "0.5".