Skip to content

Commit

Permalink
Merge pull request #28 from ritza-co/add-missing-pages
Browse files Browse the repository at this point in the history
Add missing pages
  • Loading branch information
sixhobbits authored Aug 2, 2023
2 parents dc0adda + a71d18c commit a360d96
Show file tree
Hide file tree
Showing 38 changed files with 1,555 additions and 9 deletions.
6 changes: 6 additions & 0 deletions docs/administration/appliance-manager/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
title: "Appliance Manager"
---

The Device42 Appliance Manager runs on port 4242 (HTTP by default; enable HTTPs within) to manage various Device42 Administrative functions. You can do backups & restores, manage HTTPS certifcates, Restart/Stop the application, generate logs or SNMPwalks for tech support, and more. The following topics are covered in this section:

6 changes: 6 additions & 0 deletions docs/administration/passwords/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
title: "Passwords"
---

Device42 software lets IT teams manage shared passwords in a secure fashion.  In this section, we will discuss the security and various password operations covered via the following topics:

186 changes: 186 additions & 0 deletions docs/administration/role-based-access-control/index.md

Large diffs are not rendered by default.

39 changes: 39 additions & 0 deletions docs/apps/application-components/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
title: "Application Components"
---

Application Components are intended to capture what people generally think of as "Applications." An application might be a CEO Dashboard that requires a web server/farm, an app server, and a database server. An application component might also be linked to just one service. Or an application component might be defined without any underlying service.

### Defining Application Components Based on Services

Each Service Instance edit form has an option to link that service with an Application Component.

![service-to-app.png](/assets/images/service-to-app.png)

In the example above, we've linked the oracle\_proce233442 service with the "Oracle Server 0006" Application Component.

If you navigate to the edit form for an Application Component, you can also link one or more services from that screen:

![service-to-app-2.png](/assets/images/service-to-app-2.png)

### Defining Application Components Not Based on Services

![](/assets/images/Application-Component-View-List.png)

Device42 now automatically categorizes application components by the following categories: Database, Application Layer, Web Server, Load Balancer, and Other. You can filter the list page based on application component category, and can categorize your custom components as well.

The _Application Component_ view page now also includes a _Has Resource_ column that displays the name of the associated resource for an application component.

![wpid2068-Defining_Application_Components_bottom_UP.png](/assets/images/wpid2068-Defining_Application_Components_bottom_UP.png)

In the example above, we are defining a "SAN Store" that depends on a device named "sh-SAN-Cluster01". If we'd like, we can also identify the Responsible Department, and choose which organizational groups are affected by this application component.

Next we will define an "exchange server" component as shown below.

![wpid2071-media_1334740220432.png](/assets/images/wpid2071-media_1334740220432.png)

Then we will add an Outlook Web Access(OWA) component that depends on the Exchange component as shown below:

![wpid2072-media_1334740452246.png](/assets/images/wpid2072-media_1334740452246.png)

All of the dependencies we just created will show up in impact charts, impact lists, and dependency graphs.
173 changes: 173 additions & 0 deletions docs/apps/business-applications/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,173 @@
---
title: "Business Applications"
---

## Using Business Applications

Device42 Business Applications offers a powerful way to build custom maps of business critical functions. Besides looking different than [Affinity Groups](apps/affinity-groups/index.md), Business Applications are also different because they are not automatically built out based solely on discovered connections and devices. Business Applications can be totally designed and customized by you, and can _include any and all of the resources that you identify as critical to your business!_

Using Business Applications, you'll be able to catalog all of your business and mission-critical applications. All of the following are possible:

- Creating Business Applications from scratch or from existing Affinity Groups
- Adding and removing devices and connectivity
- Customizing the resource layout, connections, and their labels
- Saving customized layout(s) and returning to edit them at any time

* * *

- Select _Applications > Business Applications_ from the Device42 menu to display a list of existing applications.

![](/assets/images/D42-23306_biz-app-list-page.png)

- Click on a Business Application _Name_ to view details about the application.

![](/assets/images/D42-23306_biz-app-view-page.png)

**Note:**  Business Applications display information about any Devices and Application Components associated with the Business Application. (Device42 automatically categorizes application components as Database, Application Layer, Web Server, Load Balancer, or Other.) Application Component information also appears on the Business Application visualization canvas (see below).

- Click _View Application_ to see the visualization of the application.  Click the _Edit_ button at the top right to turn edit mode on.

![](/assets/images/D42-23306_biz-app-canvas.png)

The page displays the business application name; hover over _Application Details_ to see information about the application. The left panel contains icons for adding devices, affinity groups, or application components to your business application and a menu bar above the icons.  You can also now run a _Service Dependencies Report_ for the Business Application, which details all the communications for the devices within the Business Application.

Click a device, affinity group, or application component object on the canvas to see details about that item. Links in the details box or below the object take you to the view pages for those items.

![](/assets/images/D42-23306_biz-app-object-details.png)

## Add a Business Application

- Select _Applications > Business Applications_ from the Device42 menu to display the applications list, and then click _Add Business Application_.

![](/assets/images/D42-23306_biz-app-add-page.png)

- Enter the application _Name_ and select the _Application Type_ (COTS, COTS with Customization, or Custom) and add a _Description_ if wanted.
- Use the magnifying glass icons to select or enter the _Technical Application Owner__Business Application Owner_, and _Responsible Customer or Department_.
- Use the format **1w 2d 3h 4m 5s** (1 week, 2 days, 3 hours, 4 minutes, and 5 seconds) to denote the time period for _DR Recovery Point Objective_ and _DR Recovery Time Objective_. The individual terms are optional and numbers must be integers. For example, you can enter **2d 6h** to define two days and six hours.
- 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 application and add it to the applications list page.

**Note**: To edit an existing application, click its _Name_ in the business applications list page, and then click _Edit_.

![](/assets/images/D42-23306_biz-app-edit-page.png)

## Add or Edit Business Application Visualizations

- Select _Applications > Business Applications_ to display the Business Applications list, select an application _Name_, and then click _View Application_.
- Device42 displays the visualization canvas.  Click the _Edit_ button at the top right to turn edit mode on.

![](/assets/images/D42-23306_biz-app-add-resource-1.png)

### Add Devices

- To add a device to a business application, drag a _Device_ block to the canvas – this will open the Add Device box.  You can _Search_ for a device by the device name, service level, tag, or service name.
- Select a device from the list, and then click **Add**. Device42 adds the device to the canvas.

![](/assets/images/D42-23306_biz-app-add-device-popup.png)

### Add Affinity Groups

- To add an affinity group to an application, drag an _Affinity Group_ block to the canvas – this will bring up the Add Affinity Group box.  You can _Search_ by group type, group name, tag, primary device name, or service name
- When you click on a group in the list, you will see the number of devices in that group.
- Select an affinity group from the list, and then click **Add**. Device42 adds the Affinity Group with all its devices and connections to the canvas.

![](/assets/images/D42-23306_biz-app-add-affinity-group-popup.png)

### Add Application Components

- To add an application component to a business application, drag a _Application Component_ block to the canvas – this will open the Add Application Component box.  You can _Search_ for a component by its name or its device name.
- Select a component from the list, and then click **Add**. Device42 adds the application component to the canvas.

![](/assets/images/D42-23306_biz-app-add-app-comp-popup.png)

### Delete a Device

To delete a device (or other objects on the canvas), either select the device and press the _Delete_ key, or right-click on a selected device and select _Delete_ from the context menu.

![](/assets/images/WEB-542_BusinessApps-Canvas-Ex-3-PopupMenu.png)

**Note**: Removing a device does not remove connections on the canvas, nor does it affect calculated information stored in Affinity Groups.

### Rename a Device

To rename a device (or other objects on the canvas), select the device, double-click the device name, and type a new name.

**Note:** The name change does not change the device record and is only for display in this specific Business Application visualization.

## Add or Edit Connections in a Visualization

You can add and edit connections between object on the canvas.

1. Hover over a device object to display the object’s connection points (green dots). Click a green dot and drag the connection to a point on any other object. ![](/assets/images/WEB-542_BusinessApps-Canvas-Ex-4-ConnectorPoint.png)
2. To delete a connection, select the connection and press the _Delete_ key, or right-click and select _Delete_ from the context menu.

**Note:** Deleting a connection does not affect calculated information stored in Affinity Groups.

### Name Connections

To name connections, simply click on the connection itself and type the description or name for the connection.

## Save a Business Application Visualization

Click the _File_ menu at the top of the canvas and select _Save_.

![](/assets/images/BusApps-canvas-6-file-save.png)

## Clone or Delete Business Applications

### Clone a Business Application

From the Business Applications list page, you can easily clone an existing Business Application. You might want to do this to experiment without editing the original, or as the base of a new Business Application, or even to plan out a future deployment or migration. Follow these steps:

- Select _Applications > Business Applications_ to display the Business Applications list, select the checkbox for the application you want to clone, and then click _Clone Business Application_.

![](/assets/images/D42-23306_biz-app-clone-ba.png)

- Click the _Business Application to clone_ magnifying glass to select (or search for) the application you want to clone.
- Enter the _\# of Business Applications_ to make and the name or names (_Comma separated names_) to give the newly cloned Business Applications and click _Clone_.

### Delete a Business Application

- Select _Applications > Business Applications_ to display the Business Applications list, and select the checkbox for the application you want to delete.
- Select _Delete selected Business Application_ from the Actions menu and click the blue lightning bolt.

## Exporting a Business Application for Migration

You can export Business Applications directly for migration by 3rd-party migration software suites. Device42 currently supports export to Microsoft Azure, RiverMeadow, and Carbonite.

### Exporting to Carbonite Migrate

Device42 can export one or more of your business applications directly to Carbonite Migrate.

### Exporting to Microsoft Azure Migrate (cloud migrations)

Device42 can export one or more of your business applications directly to the Microsoft [Azure cloud platform](https://portal.azure.com/#home) via [Azure Migrate](https://azure.microsoft.com/en-us/services/azure-migrate/).

For detailed instructions on [how to export a business application to the Azure cloud](integration/external-integrations/azure-migrate.md), go to the dedicated [Azure Migrate integration page](/external-integrations/azure-migrate/), at [Azure migrate](integration/external-integrations/azure-migrate.md).

### Exporting to RiverMeadow Data Migration

- Select _Applications > Business Application_, and then select the check boxes for the applications you want to migrate.

![](/assets/images/D42-23306_biz-app-select-migration-menu.png)

- Select _Create Migration for Selected Objects_ from the Action menu and click the blue lightning bolt.
- This will bring you to the Create Migration Export page. Select _RiverMeadow CSV_ from the _Choose target for migration_ drop-down, and click _Export_ button to export a CSV file with the IP address(es) and credentials for the server instance(s) that power your chosen Business Applications.

![](/assets/images/D42-23306_biz-app-select-migration-report.png)

- Save the exported CSV, and then open it using RiverMeadow to perform your migration.

Support for more migration software is being added and will be released shortly. Should you have any questions, please contact [[email protected]](mailto:[email protected]).

* * *

## Accessing Business Applications through DOQL

Business applications information is available through our query language (DOQL).

The following views support the applications and relationships in Business Applications:

- `view_businessapplication_v1`
- `view_businessapplicationelement_v1`
- `view_businessapplicationconnection_v1`
12 changes: 12 additions & 0 deletions docs/apps/enterprise-application-dependency-mapping/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
title: "Application Dependency Mapping"
---

_The Application Dependency Mapping module allows Device42 to autodiscover application dependencies and service dependencies on a deeper level throughout your network._

## **ADM Module Features include:**

- **Discover services to services mappings**: Device42 can show you which service on a machine/instance is connected to what other service(s) on other machines.
- **Automatic app component grouping**: auto-add application components based on groupings of services on a server. For example, once we discover different Oracle services running on a machine, those will be automatically grouped together as an Oracle application.
- **Grab the configuration data for major applications**: e.g. Oracle, Microsoft SQL, MongoDB, PostgreSQL, MySQL, Cold Fusion, IIS and Apache httpd, etc. With this, you are able to see config details (and for some software, the actual configuration file contents) for the applications from within Device42.

Loading

0 comments on commit a360d96

Please sign in to comment.