Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Migrate to v3 #42

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions docs/apps/services/service-communications.md
Original file line number Diff line number Diff line change
Expand Up @@ -135,23 +135,23 @@ For the two time spans – _Netflow Client Active Span_ and _Netflow Client Gap

**Sample File 1:**

_Communication A <=> B at 12:01:15 AM_
_Communication A `<=>` B at 12:01:15 AM_

_Communication A <=> B at 12:01:45 AM_
_Communication A `<=>` B at 12:01:45 AM_

**Sample File 2:**

_Communication A <=> B at 12:02:10 AM_
_Communication A `<=>` B at 12:02:10 AM_

_Communication A <=> B at 12:02:45 AM_
_Communication A `<=>` B at 12:02:45 AM_

**Sample File 3:**

_Communication A <=> B at 12:03:50 AM_
_Communication A `<=>` B at 12:03:50 AM_

_Communication A <=> B at 12:03:55 AM_
_Communication A `<=>` B at 12:03:55 AM_

**Results for A <=>B stats are:**
**Results for A `<=>` B stats are:**

Active Samples: 3

Expand All @@ -165,4 +165,4 @@ Active Span: 1 Min 40 sec

Gap Span: 1 Min 5 Sec (This is the gap between 12:02:45 AM and 12:03:50 AM since it is longer than the sample interval.)

Also note that D42 doesn't count the remaining 5 seconds of the last internal until D42 gets the next sample file. Once D42 gets that, it will either count those 5 seconds as a gap or as active based on when the next _A<=>B_ match appears.
Also note that D42 doesn't count the remaining 5 seconds of the last internal until D42 gets the next sample file. Once D42 gets that, it will either count those 5 seconds as a gap or as active based on when the next _A `<=>` B_ match appears.
6 changes: 4 additions & 2 deletions docs/auto-discovery/agent-based-offline-discovery.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,8 @@ Since you might want to run the discovery multiple times before processing the d
<table>
<tbody>
<tr>
<td><b>On Windows:</b>
<td>
<b>On Windows:</b>
<div></div>
C:\&gt;set var=%computername%-%date%-%time::=%
<div></div>
Expand All @@ -68,7 +69,8 @@ ASUS-GL553V-Thu03-14-2019-16265819.log
C:\&gt;d42_winagent_x64.exe -offline &gt; %var%.log
</td>

<td><b>On Linux:</b>
<td>
<b>On Linux:</b>
<div></div>
$ VAR1=`hostname`-`date +%Y%m%d-%k%M%S`
<div></div>
Expand Down
66 changes: 11 additions & 55 deletions docs/auto-discovery/cloud-auto-discovery/azure-autodiscovery.md
Original file line number Diff line number Diff line change
Expand Up @@ -137,68 +137,34 @@ Configure any other discovery options as required, such as adding vendor metadat
</thead>
<tbody class="row-hover">
<tr class="row-2 even">
<td class="column-1">SQL Server</td><td class="column-2">Resources –&gt; All Resources</td><td class="column-3">management.azure.com</td><td class="column-4">Name, virtual subtype, tags</td><td class="column-5">Microsoft.Sql/servers/read <br/>
<br/>
Microsoft.Sql/servers/databases/read </td>
<td class="column-1">SQL Server</td><td class="column-2">Resources –&gt; All Resources</td><td class="column-3">management.azure.com</td><td class="column-4">Name, virtual subtype, tags</td><td class="column-5">Microsoft.Sql/servers/read <br/><br/>Microsoft.Sql/servers/databases/read </td>
</tr>
<tr class="row-3 odd">
<td class="column-1">Managed SQL Server</td><td class="column-2">Resources –&gt; All Resources</td><td class="column-3">management.azure.com</td><td class="column-4">Name, virtual subtype, tags, tables</td><td class="column-5">Microsoft.Sql/managedInstances/read <br/>
<br/>
Microsoft.Sql/managedInstances/databases/read</td>
<td class="column-1">Managed SQL Server</td><td class="column-2">Resources –&gt; All Resources</td><td class="column-3">management.azure.com</td><td class="column-4">Name, virtual subtype, tags, tables</td><td class="column-5">Microsoft.Sql/managedInstances/read <br/><br/>Microsoft.Sql/managedInstances/databases/read</td>
</tr>
<tr class="row-4 even">
<td class="column-1">Azure DB for MySQL</td><td class="column-2">Resources –&gt; All Resources</td><td class="column-3">management.azure.com</td><td class="column-4">Name, virtual subtype, tags, tables</td><td class="column-5">Microsoft.DBforMySQL/servers/read<br/>
<br/>
Microsoft.DBforMySQL/servers/databases/read</td>
<td class="column-1">Azure DB for MySQL</td><td class="column-2">Resources –&gt; All Resources</td><td class="column-3">management.azure.com</td><td class="column-4">Name, virtual subtype, tags, tables</td><td class="column-5">Microsoft.DBforMySQL/servers/read<br/><br/>Microsoft.DBforMySQL/servers/databases/read</td>
</tr>
<tr class="row-5 odd">
<td class="column-1">Azure DB for Postgres</td><td class="column-2">Resources –&gt; All Resources</td><td class="column-3">management.azure.com</td><td class="column-4">Name, virtual subtype, tags, tables</td><td class="column-5">Microsoft.DBforPostgreSQL/servers/read<br/>
<br/>
Microsoft.DBforPostgreSQL/servers/databases/read</td>
<td class="column-1">Azure DB for Postgres</td><td class="column-2">Resources –&gt; All Resources</td><td class="column-3">management.azure.com</td><td class="column-4">Name, virtual subtype, tags, tables</td><td class="column-5">Microsoft.DBforPostgreSQL/servers/read<br/><br/>Microsoft.DBforPostgreSQL/servers/databases/read</td>
</tr>
<tr class="row-6 even">
<td class="column-1">Azure DB for MariaDB</td><td class="column-2">Resources –&gt; All Resources</td><td class="column-3">management.azure.com</td><td class="column-4">Name, virtual subtype, tags, tables</td><td class="column-5">Microsoft.DBforMariaDB/servers/read<br/>
<br/>
Microsoft.DBforMariaDB/servers/databases/read</td>
<td class="column-1">Azure DB for MariaDB</td><td class="column-2">Resources –&gt; All Resources</td><td class="column-3">management.azure.com</td><td class="column-4">Name, virtual subtype, tags, tables</td><td class="column-5">Microsoft.DBforMariaDB/servers/read<br/><br/>Microsoft.DBforMariaDB/servers/databases/read</td>
</tr>
<tr class="row-7 odd">
<td class="column-1">Cosmos DB</td><td class="column-2">Resources –&gt; All Resources</td><td class="column-3">management.azure.com</td><td class="column-4">Name, virtual subtype, tags, tables</td><td class="column-5">Microsoft.DocumentDB/databaseAccounts/read <br/>
<br/>
Microsoft.DocumentDB/databaseAccounts/sqlDatabases/read <br/>
<br/>
Microsoft.DocumentDB/databaseAccounts/cassandrakeyspaces/read <br/>
<br/>
Microsoft.DocumentDB/databaseAccounts/gremlinDatabases/read <br/>
<br/>
Microsoft.DocumentDB/databaseAccounts/mongodbDatabases/read <br/>
<br/>
Microsoft.DocumentDB/databaseAccounts/tables/read<br/>
<br/>
Microsoft.DBforPostgreSQL/serverGroupsv2/* <br/>
<br/>
Microsoft.DocumentDB/databaseAccounts/privateEndpointConnections/read<br/>
<br/>
Microsoft.Network/privateEndpoints/read<br/>
<br/>
Microsoft.OperationalInsights/workspaces/read (Log Analytics Reader on workspace level) </td>
<td class="column-1">Cosmos DB</td><td class="column-2">Resources –&gt; All Resources</td><td class="column-3">management.azure.com</td><td class="column-4">Name, virtual subtype, tags, tables</td><td class="column-5">Microsoft.DocumentDB/databaseAccounts/read <br/><br/>Microsoft.DocumentDB/databaseAccounts/sqlDatabases/read <br/><br/>Microsoft.DocumentDB/databaseAccounts/cassandrakeyspaces/read <br/><br/>Microsoft.DocumentDB/databaseAccounts/gremlinDatabases/read <br/><br/>Microsoft.DocumentDB/databaseAccounts/mongodbDatabases/read <br/><br/>Microsoft.DocumentDB/databaseAccounts/tables/read<br/><br/>Microsoft.DBforPostgreSQL/serverGroupsv2/* <br/><br/>Microsoft.DocumentDB/databaseAccounts/privateEndpointConnections/read<br/><br/>Microsoft.Network/privateEndpoints/read<br/><br/>Microsoft.OperationalInsights/workspaces/read (Log Analytics Reader on workspace level) </td>
</tr>
<tr class="row-8 even">
<td class="column-1">SQL VM</td><td class="column-2">Resources –&gt; All Resources</td><td class="column-3">management.azure.com</td><td class="column-4">Name, virtual subtype, tags, tables</td><td class="column-5">Microsoft.SqlVirtualMachine/sqlVirtualMachines/read</td>
</tr>
<tr class="row-9 odd">
<td class="column-1">Functions</td><td class="column-2">Resources –&gt; All Resources</td><td class="column-3">management.azure.com</td><td class="column-4">Resource group name, runtime, trigger, function type</td><td class="column-5">Microsoft.Web/sites/read <br/>
<br/>
Microsoft.Web/sites/functions/read</td>
<td class="column-1">Functions</td><td class="column-2">Resources –&gt; All Resources</td><td class="column-3">management.azure.com</td><td class="column-4">Resource group name, runtime, trigger, function type</td><td class="column-5">Microsoft.Web/sites/read <br/><br/>Microsoft.Web/sites/functions/read</td>
</tr>
<tr class="row-10 even">
<td class="column-1">Kubernetes (AKS)</td><td class="column-2">Devices –&gt; Unknown</td><td class="column-3">management.azure.com</td><td class="column-4">Containers, nodes, clusters</td><td class="column-5">Microsoft.ContainerService/managedClusters/read<br/>
<br/>
Microsoft.ContainerService/managedClusters/accessProfiles/listCredential/action</td>
<td class="column-1">Kubernetes (AKS)</td><td class="column-2">Devices –&gt; Unknown</td><td class="column-3">management.azure.com</td><td class="column-4">Containers, nodes, clusters</td><td class="column-5">Microsoft.ContainerService/managedClusters/read<br/><br/>Microsoft.ContainerService/managedClusters/accessProfiles/listCredential/action</td>
</tr>
<tr class="row-11 odd">
<td class="column-1">Load Balancers</td><td class="column-2">Devices –&gt; All Devices</td><td class="column-3">management.azure.com</td><td class="column-4">Name, tags, IP</td><td class="column-5">Microsoft.Network/loadBalancers/read <br/>
<br/>
Microsoft.Network/publicIPAddresses/read</td>
<td class="column-1">Load Balancers</td><td class="column-2">Devices –&gt; All Devices</td><td class="column-3">management.azure.com</td><td class="column-4">Name, tags, IP</td><td class="column-5">Microsoft.Network/loadBalancers/read <br/><br/>Microsoft.Network/publicIPAddresses/read</td>
</tr>
<tr class="row-12 even">
<td class="column-1">Networks (as VRF Groups)</td><td class="column-2">Network --&gt; VRF Groups</td><td class="column-3">management.azure.com</td><td class="column-4">Name</td><td class="column-5">Microsoft.Network/virtualNetworks/read </td>
Expand All @@ -207,20 +173,10 @@ Microsoft.Network/publicIPAddresses/read</td>
<td class="column-1">Subnets</td><td class="column-2">Network --&gt; All Subnets</td><td class="column-3">management.azure.com</td><td class="column-4">Network, mask, name</td><td class="column-5">Microsoft.Network/virtualNetworks/read</td>
</tr>
<tr class="row-14 even">
<td class="column-1">VMs</td><td class="column-2">Devices –&gt; All Devices</td><td class="column-3">management.core.windows.net</td><td class="column-4">Name, OS version, RAM size, CPU, IP, MAC</td><td class="column-5">Microsoft.Compute/virtualMachines/read <br/>
<br/>
Microsoft.Network/networkInterfaces/read <br/>
<br/>
Microsoft.Network/publicIPAddresses/read </td>
<td class="column-1">VMs</td><td class="column-2">Devices –&gt; All Devices</td><td class="column-3">management.core.windows.net</td><td class="column-4">Name, OS version, RAM size, CPU, IP, MAC</td><td class="column-5">Microsoft.Compute/virtualMachines/read <br/><br/>Microsoft.Network/networkInterfaces/read <br/><br/>Microsoft.Network/publicIPAddresses/read </td>
</tr>
<tr class="row-15 odd">
<td class="column-1">Blob Storage</td><td class="column-2">Resources --&gt; All Resources</td><td class="column-3">management.azure.com</td><td class="column-4">Capacity, available capacity</td><td class="column-5">Microsoft.Storage/storageAccounts/read<br/>
<br/>
Microsoft.Storage/storageAccounts/blobServices/containers/read<br/>
<br/>
Microsoft.Storage/storageAccounts/privateEndpointConnections/read<br/>
<br/>
Microsoft.Network/privateEndpoints/read</td>
<td class="column-1">Blob Storage</td><td class="column-2">Resources --&gt; All Resources</td><td class="column-3">management.azure.com</td><td class="column-4">Capacity, available capacity</td><td class="column-5">Microsoft.Storage/storageAccounts/read<br/><br/>Microsoft.Storage/storageAccounts/blobServices/containers/read<br/><br/>Microsoft.Storage/storageAccounts/privateEndpointConnections/read<br/><br/>Microsoft.Network/privateEndpoints/read</td>
</tr>
<tr class="row-16 even">
<td class="column-1">Workspaces</td><td class="column-2">Resources --&gt; All Resources</td><td class="column-3">management.azure.com</td><td class="column-4"></td><td class="column-5">Microsoft.OperationalInsights/workspaces/read</td>
Expand Down
24 changes: 11 additions & 13 deletions docs/auto-discovery/database-discovery/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ By default, the target machine ports are defined by different database vendors a

Dynamic discovery can discover different ports to use. As of v16.17.00, Device42 supports MSSQL and Oracle database discovery for customers that have database instances configured to listen on non-standard ports, especially on a shared database server hosting multiple instances. During database discovery, Device42 will identify and connect through the discovered active listening port.

If you want to specify DB discovery details yourself, including the DB server port, server IP address, and DB access credentials, use [Database Connections Discovery](#database-connections-discovery-jobs) jobs (see below) to discover databases.
If you want to specify DB discovery details yourself, including the DB server port, server IP address, and DB access credentials, use [Database Connections Discovery](#database-connections-discovery-jobs) jobs (see below) to discover databases.

## MS SQL Server DB Discovery (on Windows targets)

Expand Down Expand Up @@ -76,11 +76,11 @@ You can enter an ordered list of preferred _Discovery Target(s) Credential(s)_

There are a couple of different ways to see the database details; the most direct is via the discovered MSSQL Application components themselves. Head to the Device42 main menu, Apps menu -> Application Components. If you don't see your SQL Server instances right at the top of the list, you can search for "SQL" to narrow the list down.

You can see the newly discovered SQL Server instances in the example below -- Click any one of the Application Component Names for more details:
You can see the newly discovered SQL Server instances in the example below -- Click any one of the Application Component Names for more details:

![MSSQL Application Components](/assets/images/Apps-Application-Components-menu-annotated.png)

Scroll to the bottom, and click the database instance name to view database details:
Scroll to the bottom, and click the database instance name to view database details:

![](/assets/images/click-to-view-SQL-details.png)

Expand All @@ -89,7 +89,7 @@ For a rundown of the database details discovery provides, jump to the ["Availabl
### Another way to view SQL Database details

Results are also available by browsing to the discovered Windows server instance's CI; either search for the device from the dashboard, via "Devices -> All Devices", or view your discovery job's results/score page and jump to the servers from there:

![](/assets/images/click-success-for-discovery-scores.png)

Click any of the "device names" (right-hand side) to jump to each discovered machine's details view. From the details view, you can simply click the "Services" tab to view a list of services, and can then click on the Microsoft SQL Server instance in that list. ![](/assets/images/discovery-score-to-view-1.png)
Expand All @@ -111,9 +111,9 @@ If your environment includes SQL cluster databases, discovery returns the follow
- Does Passive Node use Log Ship
- Does Passive Node use DB Mirroring

A snippet from each section of the page can be seen below:
A snippet from each section of the page can be seen below:

![](/assets/images/database-list.png) ![](/assets/images/DB-Connection-Details.png)
![](/assets/images/database-list.png) ![](/assets/images/DB-Connection-Details.png)

![](/assets/images/database-size-details.png) ![](/assets/images/extra-DB-details.png)

Expand Down Expand Up @@ -156,19 +156,17 @@ As of v16.17.00, Device42 database autodiscovery for Windows and \*nix targets s

For discovery to return detailed info about your database instance, you will require read/view permissions for the following system views/tables:

<table><tbody><tr><td width="288">
<ul><li>V$SESSION</li><li>V$DATABASE</li><li>V$CONTAINERS</li><li>DBA_SEGMENTS</li></ul></td>
<td width="288"><ul><li>DBA_OBJECTS</li><li>SYS.ALL_USERS</li><li>DATABASE_COMPATIBLE_LEVEL</li><li>SYS.PRODUCT_COMPONENT_VERSION</li></ul></td></tr></tbody></table>
<table><tbody><tr><td width="288"><ul><li>V$SESSION</li><li>V$DATABASE</li><li>V$CONTAINERS</li><li>DBA_SEGMENTS</li></ul></td><td width="288"><ul><li>DBA_OBJECTS</li><li>SYS.ALL_USERS</li><li>DATABASE_COMPATIBLE_LEVEL</li><li>SYS.PRODUCT_COMPONENT_VERSION</li></ul></td></tr></tbody></table>

To get information about Pluggable Databases (PDBs) within a Container Database (CDB) in Oracle for non-DBA users, two key permission configurations are required:

- SELECT permission on the V$CONTAINERS view.
- Set `container_data=all container=current` for context configuration. For example:

```sql
ALTER USER c##<username>
SET
CONTAINER_DATA = ALL
ALTER USER c##<username>
SET
CONTAINER_DATA = ALL
CONTAINER = CURRENT;
```

Expand Down Expand Up @@ -371,7 +369,7 @@ This database discovery job is useful in cases when the main detailed database d
- _Instance_ for Oracle (required)
- _Database_ for Postgres and DB2 (required)
- Not required for MS SQL

- Use the **trash can icon** to remove a Connections line.
- Scroll down the page to add or edit the **Discovery Schedule** for the job.
- Click **Save** to save the job.
Expand Down
2 changes: 1 addition & 1 deletion docs/auto-discovery/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ Hypervisors, Windows & Linux/UNIX discovery jobs can all be created using the ma

- Windows-based machine inventory details are discovered with WMI
- Linux machines inventory details are discovered via SSH
- VMWare hypervisor host and guest VM details are discovered using appropriate APIs <small(VMware, WMI)
- VMWare hypervisor host and guest VM details are discovered using appropriate APIs &lt;small(VMware, WMI)
- Hyper-V hypervisors / guests are discovered as Windows machines using WinRM, and documented separately.

Click here for the [VMware & VM discovery docs](virtual-machine-auto-discovery.md) page, and find the [Linux/UNIX discovery page](auto-discovery/linux-unix-server-auto-discovery.md) here. Finally, learn more about [Windows (and HyperV) discoveries are documented here](auto-discovery/windows-and-hyper-v-auto-discovery.md).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -70,8 +70,8 @@ useradmin user add -g
1. Connect to your NetApp cluster via SSH.
2. Create a user with the following config:

- VServer to discover: <vserver\_name>
- Discovery User name: <user\_name>
- VServer to discover: `<vserver\_name>`
- Discovery User name: `<user\_name>`
- Role: readonly (existing system role)
- Application: ontapi
- Auth Method: Password
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Once you download the virtual appliance file, take following steps:

Default username: device42
Default password: adm!nd42
(NOTE: Use credentials (ubuntu/default) for the power appliance) (NOTE: **Much** Older {32bit, unsupported} versions may have the default login "ubuntu" rather than "device42". If you have an appliance that uses these credentials, UPGRADE it if at all possible!)
(NOTE: Use credentials (ubuntu/default) for the power appliance) (NOTE: **Much** Older `{32bit, unsupported}` versions may have the default login "ubuntu" rather than "device42". If you have an appliance that uses these credentials, UPGRADE it if at all possible!)

You can change the password with option 10 below.

Expand Down
Loading