Merge pull request #398 from ritza-co/docs-19.04.01

Docs 19.04.01 release (Week 51, 2024)

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

@@ -0,0 +1,44 @@
+---
+title: "Device42 Appliance Manager login"
+sidebar_position: 6
+---
+
+import ThemedImage from '@theme/ThemedImage'
+import useBaseUrl from '@docusaurus/useBaseUrl'
+
+Use the Device42 Appliance Manager to back up your data, update the Main Appliance, generate a log bundle [for uploading to the Device42 Support Portal](https://upload.device42.com/), restart the application, and configure **System** and **Global Settings**.
+
+## Access the Appliance Manager
+
+![Device42 Appliance Manager Home Screen v19](/assets/images/device42-appliance-manager-login/ap-home-view.png)
+
+- For HTTP, access the Appliance Manager using port 4242: `http://your-ip-address-or-FQDN:4242`
+- For HTTPS, use port 4343: `https://your-ip-address-or-FQDN:4343`
+
+Alternatively, go to your Main Appliance login page and click the **Appliance Manager** link.
+
+<ThemedImage
+  alt="Main Appliance login screen with Appliance Manager link"
+  sources={{
+    light: useBaseUrl('/assets/images/device42-appliance-manager-login/ma-login-screen-light.png'),
+    dark: useBaseUrl('/assets/images/device42-appliance-manager-login/ma-login-screen-dark.png'),
+  }}
+/>
+
+## Login Credentials
+
+The default username and password are `d42admin` and `default`. Please [change the password](#change-your-password) as soon as you log in.
+
+![Appliance Manager login screen](/assets/images/device42-appliance-manager-login/ap-login-screen.png)
+
+### Change Your Password
+
+Click your username at the top of the left sidebar and select **Change password**.
+
+![Change Password screen in Appliance Manager](/assets/images/device42-appliance-manager-login/change-password.png)
+
+## AWS Login 
+
+For **marketplace** AWS installations, use `d42admin` as the username and your **AWS Instance ID** as the default password. See [the AWS installation instructions](https://docs.device42.com/getstarted/installation/installation-amazon-web-services/#accessing-the-d42-appliance-manager---aws-marketplace-installs) for more information.
+
+If you **manually** installed AWS using a downloaded image, use the default Device42 username, `d42admin`, and password, `default`, to log in to the Appliance Manager.

docs/administration/appliance-manager/generate-log-bundle.mdx

@@ -19,7 +19,7 @@ To generate log bundle for a support call:
     />    
 
 2. If your issue is autoDiscovery related, re-run the failing autodiscovery job now that you've enabled the debug flag.
-3. Login to the appliance manager via the main menu, **Tools > Appliance Manager** or follow the [Device42 Appliance Manager login](device42-appliance-manager-login.md) directions.
+3. Login to the appliance manager via the main menu, **Tools > Appliance Manager** or follow the [Device42 Appliance Manager login](device42-appliance-manager-login.mdx) directions.
 4. Generate the log bundle via the Appliance Manager. Navigate to **Application > Generate Log Bundle** and click **Run**.
 
     ![Generate Log Bundle via Appliance Manager](/assets/images/generate-log-bundle/am-generate-log-bundle.png)

docs/administration/appliance-manager/index.md

@@ -11,7 +11,7 @@ The Device42 Appliance Manager runs on port 4242 (HTTP by default; enable HTTPs
 - [Changing Device42 Appliance Hostname](administration/appliance-manager/changing-device42-appliance-hostname.md)
 - [Collecting SNMPWALK output for troubleshooting](administration/appliance-manager/collecting-snmpwalk-output-for-troubleshooting.md)
 - [Delete History Logs](administration/appliance-manager/delete-history-logs.md)
-- [Device42 Appliance Manager login](administration/appliance-manager/device42-appliance-manager-login.md)
+- [Device42 Appliance Manager login](administration/appliance-manager/device42-appliance-manager-login.mdx)
 - [Device42 Restore](administration/appliance-manager/device42-restore.md)
 - [Enable or Disable TLS versions from Appliance Manager](administration/appliance-manager/enable-or-disable-tls-versions-from-appliance-manager.md)
 - [Enabling SSL in Appliance Manager](administration/appliance-manager/enabling-ssl-in-appliance-manager.md)

docs/infrastructure-management/devices/clone-a-device.mdx

@@ -0,0 +1,45 @@
+---
+title: "Clone a Device"
+sidebar_position: 3
+---
+
+import ThemedImage from '@theme/ThemedImage'
+import useBaseUrl from '@docusaurus/useBaseUrl'
+
+Cloning a device in Device42 saves time and provides consistency when adding multiple similar devices.
+
+Navigate to **Tools > Templates & Bulk Operations > Clone Device**.
+
+- Select a **Device to clone** using the **magnifying glass icon** and choose the properties to include in the clone(s) using the checkboxes.
+
+    **Notes** will not be associated with the clones.
+
+    <ThemedImage
+    alt="Device to Clone's name and properties"
+    sources={{
+        light: useBaseUrl('/assets/images/clone-a-device/name-and-properties-light.png'),
+        dark: useBaseUrl('/assets/images/clone-a-device/name-and-properties-dark.png'),
+    }}
+    />
+
+- Input the number of clones you wish to create in the **# of devices** field. Next, choose between naming all the clone(s) by selecting a **Device Name Profile** or naming each clone individually by entering a comma-separated list of names.
+
+    <ThemedImage
+    alt="Number of clones and naming options"
+    sources={{
+        light: useBaseUrl('/assets/images/clone-a-device/count-and-name-light.png'),
+        dark: useBaseUrl('/assets/images/clone-a-device/count-and-name-dark.png'),
+    }}
+    />
+
+- Optionally, you can include an original **Asset Number Profile**, **Service Level**, and **Customer** to be associated with the clone(s). If you apply a new **Service Level** or **Customer** to the clone(s), be sure you deselect the relevant checkbox under **Properties** to prevent the original device property from being cloned.
+
+- When you're ready to create the clone(s), click **Clone** in the bottom-right corner.
+
+    <ThemedImage
+    alt="Other properties options and Clone button"
+    sources={{
+        light: useBaseUrl('/assets/images/clone-a-device/other-properties-light.png'),
+        dark: useBaseUrl('/assets/images/clone-a-device/other-properties-dark.png'),
+    }}
+    />

docs/infrastructure-management/devices/device-blade-chassis.mdx

@@ -0,0 +1,107 @@
+---
+title: "Device - Blade Chassis"
+sidebar_position: 4
+---
+
+import ThemedImage from '@theme/ThemedImage'
+import useBaseUrl from '@docusaurus/useBaseUrl'
+
+## View Blade Chassis Devices
+
+Locate your blade chassis in Device42 by navigating to **Resources > All Devices** and filtering for blade chassis devices:
+
+- Click **+ More** and select the **Blade Chassis** checkbox to display its dropdown menu.
+- Choose **Yes** from the dropdown. 
+
+<ThemedImage
+  alt="Filtering for blade chassis on the Devices list page"
+  sources={{
+    light: useBaseUrl('/assets/images/device-blade-chassis/filter-devices-light.png'),
+    dark: useBaseUrl('/assets/images/device-blade-chassis/filter-devices-dark.png'),
+  }}
+/>
+
+## The Blades Tab
+
+Select a blade chassis from the Devices list page. Scroll down to the **Blades** tab, located below the device basic details section.
+
+The **Blades** tab shows information about each device in the chassis. Blades are sorted by **Slot** number. Each blade has a link to its device page and displays its **Serial #**, **Asset #**, **Slot Location**, and **Hardware Model**.
+
+<ThemedImage
+  alt="Blade tab on a blade chassis device"
+  sources={{
+    light: useBaseUrl('/assets/images/device-blade-chassis/blades-tab-light.png'),
+    dark: useBaseUrl('/assets/images/device-blade-chassis/blades-tab-dark.png'),
+  }}
+/>
+
+### Add a New Blade 
+
+In device **Edit** mode, from the **Blade** tab, you can add blades to a chassis by clicking **+ Add New Blade**. The hardware model for the blade device must exist beforehand.
+
+<ThemedImage
+  alt="Adding a new blade"
+  sources={{
+    light: useBaseUrl('/assets/images/device-blade-chassis/add-new-blade-window-light.png'),
+    dark: useBaseUrl('/assets/images/device-blade-chassis/add-new-blade-window-dark.png'),
+  }}
+/>
+
+## The Interactive Blade Chassis Layout
+
+Layouts allow you to visualize blades within their chassis. The overall layout architecture is defined by the chassis [Hardware Model](#editing-hardware-models), which needs to be defined before you add and position specific blades. 
+
+From the view mode of the [device chassis page](#view-blade-chassis-devices), click the **ellipsis menu** and select **Layout** from the dropdown. 
+
+<ThemedImage
+  alt="Device Layout button"
+  sources={{
+    light: useBaseUrl('/assets/images/device-blade-chassis/layout-button-light.png'),
+    dark: useBaseUrl('/assets/images/device-blade-chassis/layout-button-dark.png'),
+  }}
+/>
+
+Click **Turn ON** to edit the layout. Drag and drop the blades to position them in the correct slots. Please note that the blade slot numbers must be numeric and not alphanumeric.
+
+<ThemedImage
+  alt="Edit Layout button"
+  sources={{
+    light: useBaseUrl('/assets/images/device-blade-chassis/layout-view-light.png'),
+    dark: useBaseUrl('/assets/images/device-blade-chassis/layout-view-dark.png'),
+  }}
+/>
+
+
+:::tip
+For blade-specific templating information, see the [Blade Slots documentation](device-blade-slots.md).
+:::
+
+### Editing Hardware Models
+
+To edit the layout of a blade, first define its Hardware Model under **Infrastructure > Hardware Models > + Add Device Hardware Model**. 
+
+<ThemedImage
+  alt="Hardware Model menu"
+  sources={{
+    light: useBaseUrl('/assets/images/device-blade-chassis/hardware-model-menu-light.png'),
+    dark: useBaseUrl('/assets/images/device-blade-chassis/hardware-model-menu-dark.png'),
+  }}
+/>
+
+You can find a link to an existing Hardware Model in the right panel of an individual **Layout**.
+
+Add a **New Slot** to an existing model by dragging it to the layout and filling in the fields:
+
+<ThemedImage
+  alt="Add new blade"
+  sources={{
+    light: useBaseUrl('/assets/images/device-blade-chassis/new-blade-slot-in-model-light.png'),
+    dark: useBaseUrl('/assets/images/device-blade-chassis/new-blade-slot-in-model-dark.png'),
+  }}
+/>
+
+- **Choose Slot Size:**  Choose between full, half, double options, and quarter heights.
+- **Choose orientation:** Select **Vertical** or **Horizontal** positioning.
+- **Slot Number:** Enter the next slot number in the sequence.
+
+Visit the [Hardware Model (Templates)](hardware-models-templates.mdx) page to view details about Hardware Models that apply to all devices, not only blades.