Merge pull request #468 from ritza-co/19.07.00-updates

19.07.00 updates

Author: sixhobbits

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

@@ -3,26 +3,46 @@ title: "Collecting SNMP Walk Output"
 sidebar_position: 4
 ---
 
-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.
+You can collect SNMP walk output for a network device or PDU right from the GUI. Then, you can download the output and send it to us for further troubleshooting.
 
-### Collect SNMP Walk Output
+From the Appliance Manager, go to **Application > Generate SNMP Output**. 
 
-From the Appliance Manager, go to **Application > Generate SNMP Output**.
+### Simple SNMP Walk Output
 
-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.
+If this is not a new device, select the **No: Simple walk** option.
 
-![Collect SNMP walk Appliance Manager](/assets/images/collecting-snmpwalk-output-for-troubleshooting/generate-snmp-output-options.png)
+Add your target switch or other SNMP target device info, click **Submit**, and please be patient as it might take a few minutes. Download the generated file and send it to support.
 
-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:
+    ![Collect SNMP walk Appliance Manager](/assets/images/collecting-snmpwalk-output-for-troubleshooting/simple-walk.png)
+
+### MIB Browser-Based Walk
+
+For new devices, select **Yes: MIB browser based walk**. 
+
+- Select your **RC** and enter the required fields: **FQDN or IP Address**, **Community String**, and MIB file upload.
+
+    ![MIB file upload](/assets/images/collecting-snmpwalk-output-for-troubleshooting/browser-based-walk.png)
+
+- Select the data to generate for the new device and **Submit**.
+
+    ![Generation options](/assets/images/collecting-snmpwalk-output-for-troubleshooting/generate-snmp.png)
+
+- Click **Download Archive File** and save the file to attach to an existing support ticket. If needed, [create a new ticket](https://support.device42.com/hc/en-us/requests/new) or [email support](mailto:[email protected]).
+
+    ![Download Archive file](/assets/images/collecting-snmpwalk-output-for-troubleshooting/download-archive-file.png)
+
+## Alternative SNMP Walk Generation
+
+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 for SNMP v2:
 
 ```
 snmpbulkwalk -Cc -ObentU -v2c -c COMMUNITY DEVICE > output_file_name
 snmpbulkwalk -ObentU -v 2c -c COMMUNITY DEVICE .1.3.6.1.4.1 >> output_file_name
 ```
 
-Also, the current setup has a bug for v3, so please use the following for any system using SNMP v3:
+You can use the following for any system using SNMP v3:
 
 ```
 snmpbulkwalk -Cc -ObentU -v 3 -u user_name -l authNoPriv -a MD5 -A auth_pass DEVICE > output_file_name
 snmpbulkwalk -Cc -ObentU -v 3 -u user_name -l authNoPriv -a MD5 -A auth_pass DEVICE .1.3.6.1.4.1 >> output_file_name
-```
+```

docs/administration/passwords/password-security-and-permissions.mdx

@@ -77,15 +77,35 @@ If no permissions are entered, the User who created the Secret will have **view/
 
 ### Bulk Permissions Change
 
-From the Secrets list page, you can edit the group permissions of many Secrets at once by selecting **Change group permissions for selected passwords** from the **Actions** dropdown menu. 
+-  From the Secrets list page, you can edit the group permissions of many Secrets at once by selecting **Change group permissions for selected passwords** from the **Actions** dropdown menu. 
 
-<ThemedImage
-  alt="Secrets action menu"
-  sources={{
-    light: useBaseUrl('/assets/images/secret-security-permissions/secrets-action-menu-19.06-light.png'),
-    dark: useBaseUrl('/assets/images/secret-security-permissions/secrets-action-menu-19.06-dark.png'),
-  }}
-/>
+  <ThemedImage
+    alt="Secrets action menu"
+    sources={{
+      light: useBaseUrl('/assets/images/secret-security-permissions/secrets-action-menu-19.06-light.png'),
+      dark: useBaseUrl('/assets/images/secret-security-permissions/secrets-action-menu-19.06-dark.png'),
+    }}
+  />
+
+- Use the checkboxes to clear the existing group permissions for viewing and editing Secrets.
+
+  <ThemedImage
+    alt="Remove current settings"
+    sources={{
+      light: useBaseUrl('/assets/images/secret-security-permissions/change-group-action-light.png'),
+      dark: useBaseUrl('/assets/images/secret-security-permissions/change-group-action-dark.png'),
+    }}
+  />
+
+- Select new permission groups using the dropdown menu.
+
+  <ThemedImage
+    alt="Change group permissions"
+    sources={{
+      light: useBaseUrl('/assets/images/secret-security-permissions/add-group-action-light.png'),
+      dark: useBaseUrl('/assets/images/secret-security-permissions/add-group-action-dark.png'),
+    }}
+  />
 
 ### Secret Storage Details
 

docs/apps/application-groups/index.mdx

@@ -171,9 +171,9 @@ Edit a rule or create a new rule and [select **Fixed** as the **Starting Point**
 
   ![Invalidated Application Group Notification](/assets/images/application-groups/invalidated-ag-notice-custom-field.png)
 
-## Impact Charts
+## Charts
 
-- Under the **My Application Groups** tab, click on the **Chart** link next to an Application Group name to view the Application Group Impact Chart.
+- Under the **My Application Groups** tab, click on the **Chart** link next to an Application Group name to view the Application Group chart.
 
   <ThemedImage
     alt="Chart links"
@@ -183,7 +183,7 @@ Edit a rule or create a new rule and [select **Fixed** as the **Starting Point**
     }}
   />  
 
-The Application Group Impact Chart displays the relationships between Application Components, Services, and Devices.
+The Application Group chart displays the relationships between Application Components, Services, and Devices.
 
   <ThemedImage
     alt="Application Group Impact Chart"
@@ -226,6 +226,22 @@ If you don't see this historical communication metadata, make sure you have the
 
 You can also run a **Service Dependencies Report** from the chart view page. The Services Dependencies report details all the communications for devices within an Application Group.
 
+### Chart List View
+
+You can view the devices and root resources displayed in the chart in a handy, tabulated list view. Note that this chart list view is only available via the **Chart** tab, and not via the **Breakdown** panel on the AG main page. 
+
+- Click the **Chart** tab.
+
+  ![Chart button](/assets/images/application-groups/chart-icon.png)
+
+- Click the **list icon** button to the right of the chart.
+
+  ![Chart list view button](/assets/images/application-groups/list-view-button.png)
+
+- You can use the links in the list view to navigate to the details page of the listed items and toggle back to the chart view. 
+
+  ![Chart list view](/assets/images/application-groups/chart-list-view.png)
+
 ## Application Group Timelines
 
 Application Group timelines make it easy to see how a given group has changed over time. Changes to services and resources are marked along the timeline, indicating when they were added or removed from the group. 

docs/apps/business-services/building-business-services-in-device42.mdx

@@ -13,7 +13,7 @@ import useBaseUrl from '@docusaurus/useBaseUrl'
 
 ## Overview
 
-This is a technical guide that will walk you through a step-by-step process of building Business Services within Device42.  [Once you have successfully performed discovery,](auto-discovery) apply the methods outlined below to create Application Groups and then leverage these groups to facilitate the process of building your Business Applications.
+This is a technical guide that will walk you through a step-by-step process of building Business Services within Device42.  [Once you have successfully performed discovery,](auto-discovery) apply the methods outlined below to create Application Groups and then leverage these groups to facilitate the process of building your Business Services.
 
 ## Viewing Discovery Data
 
@@ -187,36 +187,29 @@ To choose one of these queries to generate your Application Groups, navigate to
 
 ## Building Business Services
 
-To build a Business Service, navigate to **Applications > Business Applications**, and then click **Create** in the top right of the page.
+To build a Business Service, navigate to **Applications > Business Services**, and then click **Create** in the top right of the page.
 
 <ThemedImage
   alt="Create button"
   sources={{
     light: useBaseUrl('/assets/images/building-business-services-in-device42/create-button-bs-light.png'),
     dark: useBaseUrl('/assets/images/building-business-services-in-device42/create-button-bs-dark.png'),
   }}
-  style={{ width: '60%' }} 
+  style={{ width: '50%' }} 
 />
 
-After naming and saving your new Business Service, click the **View Application** button and toggle on the **Edit** mode.  You'll see a blank canvas. Drag items from the left panel to start building the Business Service. 
+After naming and saving your new Business Service, click the **Application Layout** button and toggle on the **Edit** mode.  You'll see a blank canvas. Drag items from the left panel to start building the Business Service. 
 
-Select **Application Group** and drag it onto the canvas.
-
-You have several options to search for existing Application Groups. In the example, we searched for part of a server name (`server`) that we know is within the AppFocus group of the Application Group we're looking for. The AppFocus group is the focus point for the Application Group and is defined as the group's [Starting Point](/apps/application-groups/calculation-rules).
-
-You'll see that we found two Application Groups that had items containing the word `server` as their focus points.
+Select **Application Group** and drag it onto the canvas and choose the group(s) you want to add and click **Add** to include it on the canvas. 
 
 <ThemedImage
   alt= "Add Application Group modal window"
   sources={{
-    light: useBaseUrl('/assets/images/building-business-services-in-device42/app-group-search-light.png'),
-    dark: useBaseUrl('/assets/images/building-business-services-in-device42/app-group-search-dark.png'),
+    light: useBaseUrl('/assets/images/building-business-services-in-device42/add-app-group-light.png'),
+    dark: useBaseUrl('/assets/images/building-business-services-in-device42/add-app-group-dark.png'),
   }}
-  style={{ width: '60%'}} 
 />
 
-Select the group you want to add and click **Add** to include it on the canvas. Repeat this process if there are any other Application Groups, Components, Resources, or Devices that you need to add to the Business Service.
-
 Once you have successfully imported everything, use the toolbars at the top right of the screen to label and color-code the objects.
 
 Select a box with a device name, then use the **Style** tab on the right to change the color of this box.
@@ -237,20 +230,4 @@ Double-click a line or another area of the canvas to add text. Use this to repre
 Congratulations! You have now built a Business Service by leveraging Device42's discovery and Application Group capabilities.
 
 ![](/assets/images/Web_732_15.png)
- 
-
-## Tips and Tricks: Use Tags    
-
-In the add or edit mode of the **Hypervisors/\*nix/win for Autodiscovery** job pages, you can expand the **Miscellaneous** section to apply **Tags for discovered devices**. 
 
-- If you know which servers are part of your Business Service, you can tag them with the Business Service name, then easily search and filter devices by this tag when you are building your Business Service.
-
-- When creating a Business Service, drag the **Device** icon on the left, and then search for the tag to choose the devices you previously tagged in the discovery job.
-
-    <ThemedImage
-    alt= "Searching Devices using tags"
-    sources={{
-        light: useBaseUrl('/assets/images/building-business-services-in-device42/tagged-device-search-light.png'),
-        dark: useBaseUrl('/assets/images/building-business-services-in-device42/tagged-device-search-dark.png'),
-    }}
-    />

docs/apps/business-services/index.mdx

@@ -6,7 +6,7 @@ import ThemedImage from '@theme/ThemedImage';
 import useBaseUrl from '@docusaurus/useBaseUrl'
 
 :::info 
-Business Applications are now named **Business Services**. Affinity Groups have also been renamed as **Application Groups**. See [**Calculation Rules**](/apps/application-groups/calculation-rules) (previously AppFocus Filters) for details on the new ADM flow.
+Business Applications are now named **Business Services**. Affinity Groups have also been renamed **Application Groups**. See [**Calculation Rules**](/apps/application-groups/calculation-rules) (previously AppFocus Filters) for details on the new ADM flow.
 :::
 
 ## Overview
@@ -79,9 +79,33 @@ Select **Applications > Business Services** from the Device42 menu to display
 - Select or enter the **Migration Group** and **Criticality**, and add any **Notes** or **Tags** you want.
 - Click **Save** at the bottom right of the page to save the Business Service and add it to the applications list page.
 
-You'll be directed to a summary page for the new Business Service. Now it's time to work from the visualization canvas to add Devices, Application Groups, and Application Components to your new Business Service.
+You'll be directed to a summary page for the new Business Service. Now it's time to work from the visualization canvas to add items to your new Business Service.
 
-### Visualizations
+### Adding and Removing Items
+
+There are two methods of adding items to Business Services: inline and via the Application Layout canvas. Currently, Application Groups can only be added using the canvas. See the [Add Application Groups](#add-application-groups) section below.
+
+You can add, edit, and remove devices, resources, and application components as inline items from a Business Service details view page. 
+
+<ThemedImage
+  alt="Add Resources, Devices, and App Comps"
+  sources={{
+    light: useBaseUrl('/assets/images/business-services/add-inline-light.png'),
+    dark: useBaseUrl('/assets/images/business-services/add-inline-dark.png'),
+  }}
+/>
+
+Remove inline items by clicking the **Tashcan** icon. The item to be removed will be grayed out, giving you the option to restore the item in this session by clicking the **Restore** icon.
+
+<ThemedImage
+  alt="Restore button"
+  sources={{
+    light: useBaseUrl('/assets/images/business-services/restore-button-light.png'),
+    dark: useBaseUrl('/assets/images/business-services/restore-button-dark.png'),
+  }}
+/>
+
+## The Application Layout Canvas
 
 Click the **Application Layout** button from the Business Services details page to display the visualization canvas.
 
@@ -105,6 +129,8 @@ Click the **Edit** button on the top right of the canvas to activate the **Edit*
 
 From the left panel, drag the **Device**, **Resource**, **Application Group**, and **Application Component** boxes onto the canvas to open the dialog that allows you to search for specific items to add to the canvas.
 
+For efficiency, you can add multiple items of each item type at a time. 
+
 <ThemedImage
   alt="Add Device button"
   sources={{
@@ -322,6 +348,14 @@ As you construct your alert, Device42 displays the alert definition based on the
 
 > When the individual Business Service Jupiter service app has reported New Application Group Dependency Found then send notification to users assigned to Main profile.
 
+### Auto Apply Changes
+
+Make maintaining Business Services easier by automatically adding and removing connections. Check the **Auto Apply changes** box when configuring the alert. Connections to a newly found AG dependency will be made automatically, and if an AG dependency is removed, the Business Service connection will be automatically removed. You will receive a notification of these events as part of the alert.
+
+The **Auto Apply changes** option is unchecked by default. If left disabled, you'll receive a notification with the Add or Remove connection option for manually making changes to the Business Service.
+
+### Apply To Selected Objects
+
 Depending on which alert Rule Type you select, you may also see an **Apply To:** option, which you will use to select the objects you want to apply the alert to. Use the **Available objects** list on the left to select the objects you want to add to the **Chosen objects** list on the right.
 
 <ThemedImage
@@ -332,7 +366,7 @@ Depending on which alert Rule Type you select, you may also see an **Apply To:**
   }}
 />
 
-**Additional Options**
+### More Alert Options
 
 - **Priority**: Choose between Critical, High Priority, Medium Priority, and Low Priority.
 - **Resend Notification**: Number of seconds to wait before sending an email notification for the alert. Leave this field blank to send the email only once.

docs/auto-discovery/cloud-auto-discovery/other-cloud-autodiscoveries.mdx

@@ -212,11 +212,14 @@ Device42 needs your OpenStack **User Name** (`username@UserDomainID:ProjectDomai
 
 Select **OpenStack** from the **Type** dropdown menu, and fill in the **User** name, **Password**, and **Project name** fields.
 
+If you disable **Discover all projects/tenants**, then the **Project Name** is required. When **Discover all projects/tenants** is enabled, Device42 will discover resources across all available projects, making the specific project name unnecessary.
+
+
 <ThemedImage
   alt="Add OpenStack details"
   sources={{
-    light: useBaseUrl('/assets/images/other-cloud-autodiscovery/openstack-job-19.06-light.png'),
-    dark: useBaseUrl('/assets/images/other-cloud-autodiscovery/openstack-job-19.06-dark.png'),
+    light: useBaseUrl('/assets/images/other-cloud-autodiscovery/openstack-job-19.07-light.png'),
+    dark: useBaseUrl('/assets/images/other-cloud-autodiscovery/openstack-job-19.07-dark.png'),
   }}
 />
 

docs/auto-discovery/network-auto-discovery.mdx

@@ -214,17 +214,43 @@ If you keep **Get all switch ports** selected, you will see extra form items:
 
 ## Globally Exclude OIDs
 
-You can set certain OIDs to be ignored globally to prevent them from being collected during SNMP discovery.
+You can set certain OIDs to be ignored globally to prevent them from being collected during SNMP discovery. Navigate to **Tools > Global Settings** and scroll down to the **Ignore OID(s):** field. 
 
-Navigate to **Tools > Global Settings** and scroll down to the **Ignore OID(s):** field. Add an individual OID or a group of OIDs using dot notation. For documentation purposes, you can optionally include a comment in text notation on the same line as the OID(s).
+Device42 supports two methods of exclusion: Use a trailing dot (`.`) to ignore entire categories of data, or omit it to ignore specific OIDs.
 
-<ThemedImage
-  alt="Global Settings Ignore OID(s) field"
-  sources={{
-    light: useBaseUrl('/assets/images/network-auto-discovery/global-ignore-oids-light.png'),
-    dark: useBaseUrl('/assets/images/network-auto-discovery/global-ignore-oids-dark.png'),
-  }}
-/>
+- For an exact OID match, include the full OID without a dot at the end. For documentation purposes, you can optionally include a comment in text notation on the same line as the OID(s).
+
+  For example:
+
+  ```
+  1.3.6.1.2.1.4.35.1 # ignore this OID
+  ```
+
+  <ThemedImage
+    alt="Global Settings Ignore OID(s) field"
+    sources={{
+      light: useBaseUrl('/assets/images/network-auto-discovery/global-ignore-oids-light.png'),
+      dark: useBaseUrl('/assets/images/network-auto-discovery/global-ignore-oids-dark.png'),
+    }}
+  />
+
+- To exclude an OID category, include a period (`.`) at the end of the OID. 
+
+  For example:
+
+  ```
+  1.3.6.1.2.1.4.35.1. # ignore entire OID tree
+  ```
+
+  This will ignore `1.3.6.1.2.1.4.35.1.2`, `1.3.6.1.2.1.4.35.1.3`, and all other OIDs that start with `1.3.6.1.2.1.4.35.1.`
+
+  <ThemedImage
+    alt="Global Settings Ignore OID(s) field"
+    sources={{
+      light: useBaseUrl('/assets/images/network-auto-discovery/global-ignore-oids-tree-light.png'),
+      dark: useBaseUrl('/assets/images/network-auto-discovery/global-ignore-oids-tree-dark.png'),
+    }}
+  />
 
 :::note
 When OIDs are set to be ignored globally, existing discovery jobs will not automatically inherit these ignored OIDs. To apply the ignored OIDs to existing discovery jobs, a new discovery job must be created.