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

Docs 19.04.05 release (Week 3, 2025) #407

Open
wants to merge 41 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
41 commits
Select commit Hold shift + click to select a range
71488ce
update section links
Nadia-JSch Jan 14, 2025
b0cf0c9
add custom mapping results to eg 2, freshservice-integration
Nadia-JSch Jan 15, 2025
d5239be
add column drag gif and intro, arrange-and-save..
Nadia-JSch Jan 15, 2025
69f38cb
DOCS-636 update contract type sections, freshservice-integration.mdx
Nadia-JSch Jan 15, 2025
ef637a7
add software licensing image and move section, freshservice-integrati…
Nadia-JSch Jan 16, 2025
6c922cc
DOCS-631 update images and edit, device42-doql/index.md
Nadia-JSch Jan 16, 2025
1faf4e4
fix json
Nadia-JSch Jan 16, 2025
1b119d9
DOCS-632 update page, db-viewer-schema.md
Nadia-JSch Jan 17, 2025
6c3e4e9
minor rephrashing, db-viewer-schema.md
Nadia-JSch Jan 17, 2025
b2e03d6
minor edit
Nadia-JSch Jan 17, 2025
911b038
Edit freshservice-integration.mdx
bethh0rn Jan 17, 2025
36d955f
DOCS-631, edit index.md
bethh0rn Jan 17, 2025
a29dc92
DOCS-637, edit arrange-and-save-list-page-column-layout.mdx
bethh0rn Jan 17, 2025
5934153
DOCS-632, edit db-viewer-schema.md
bethh0rn Jan 17, 2025
020e03a
DOCS-636, remove "an" freshservice-integration.mdx
bethh0rn Jan 17, 2025
4bb2cb0
DOCS-649 mention IP import export case, spreadsheet-imports-and-expor…
Nadia-JSch Jan 17, 2025
9bad0e7
add limited account steps
AbdulDavids Jan 17, 2025
42af991
DOCS-647 add temp images of new UI & minor edit, insightsai.mdx
Nadia-JSch Jan 17, 2025
5c89c1f
DOCS-631, editing update index.md
bethh0rn Jan 17, 2025
93a5e6e
DOCS-637, editing update arrange-and-save-list-page-column-layout.mdx
bethh0rn Jan 17, 2025
beb022b
Merge pull request #418 from ritza-co/edit-freshservice-updates-2
Nadia-JSch Jan 17, 2025
5dab070
DOCS-632, specify "Find" field location db-viewer-schema.md
bethh0rn Jan 17, 2025
b806ab8
proofread, insightsai.mdx
Nadia-JSch Jan 17, 2025
62a1879
proofread, spreadsheet-imports-and-exports.mdx
Nadia-JSch Jan 17, 2025
989ac88
Merge pull request #420 from ritza-co/edit-631-doql
Nadia-JSch Jan 17, 2025
27a81cd
additional language changes, device42-doql/index.md
Nadia-JSch Jan 17, 2025
7abf396
add check for command access
AbdulDavids Jan 17, 2025
7dfff42
Merge pull request #422 from ritza-co/edit-637-arrange
Nadia-JSch Jan 17, 2025
dec7a9f
Merge pull request #423 from ritza-co/edit-632-schema
Nadia-JSch Jan 17, 2025
360f47a
DOCS-625, edit agent-based-discovery.mdx
bethh0rn Jan 17, 2025
3cb9062
DOCS-625, proofread agent-based-discovery.mdx
bethh0rn Jan 17, 2025
d6ab9e0
Merge pull request #425 from ritza-co/edit-625-agent
Nadia-JSch Jan 17, 2025
d4ff57d
Merge pull request #414 from ritza-co/freshervice-updates-2
Nadia-JSch Jan 17, 2025
20973cb
Merge pull request #415 from ritza-co/637-arrange
Nadia-JSch Jan 17, 2025
9eeb038
Merge pull request #416 from ritza-co/631-doql
Nadia-JSch Jan 17, 2025
510e1a0
Merge pull request #417 from ritza-co/632-schema
Nadia-JSch Jan 17, 2025
81d0f0a
Merge pull request #419 from ritza-co/649-imports
Nadia-JSch Jan 17, 2025
cbadc13
Merge pull request #421 from ritza-co/647-insights
Nadia-JSch Jan 17, 2025
d9f8d4c
Merge pull request #424 from ritza-co/625-agent
Nadia-JSch Jan 17, 2025
3c5f0cb
change to .mdx & update rel links
Nadia-JSch Jan 17, 2025
d68a368
update relative links
Nadia-JSch Jan 17, 2025
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
108 changes: 108 additions & 0 deletions docs/auto-discovery/agent-based-discovery.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -180,6 +180,114 @@ The agent can be run from the command line or can be scheduled using the relevan

For best results, we recommend running the command with `sudo`. Make sure that `/home/system\_dev42/bin/d42agent` is owned by `root` with `\-rwx—— (0700)` permissions. This prevents the non-root user `system\_dev42` from overwriting the agent or adding it to `root`’s _crontab_ (or `cron.daily/hourly`) while allowing root to execute it.

### Using a Limited Account

The Linux agent runs as `root` by default. However, it is possible to configure the agent to run with a limited, non-root account. Here's how you can create one:

1. **Create a limited account**:
- Create a new Linux account (for example, `d42_limited`) without root access.
- Disable login access to ensure the account cannot be used for remote shell access. Use the following command:

```bash
sudo useradd -r -s /usr/sbin/nologin d42_limited
```

2. **Grant sudo permissions for required commands**:
- Assign the account permission to run the commands required by the discovery agent. Edit the `/etc/sudoers` file using `visudo`:

```bash
sudo visudo
```

- Add the following entry to grant `d42_limited` access to specific commands:

```
d42_limited ALL=(ALL) NOPASSWD: /usr/sbin/arp, /bin/cat, /sbin/ifconfig, /usr/bin/curl, /usr/bin/wget, /bin/ls, /usr/sbin/dmidecode, /usr/bin/lsof, /usr/bin/ps, /usr/bin/python3, /bin/uname, /usr/bin/systemctl, /sbin/ip, /usr/bin/df, /usr/bin/free, /usr/bin/mount, /usr/sbin/iptables
```

Read the [Commands Required by the Discovery Agent](#commands-required-by-the-discovery-agent) section to see the full list of commands required by the agent.

3. **Configure the file ownership and permissions**:
- Make sure that the `d42agent` binary is still owned by `root` and has restricted permissions:

```bash
sudo chown root:root /home/system_dev42/bin/d42agent
sudo chmod 0700 /home/system_dev42/bin/d42agent
```

4. **Run the agent with the limited account**:
- Use `sudo` to execute the agent with the limited account:

```bash
sudo -u d42_limited /home/system_dev42/bin/d42agent
```

### Commands Required by the Discovery Agent

The limited account must have access to the following commands to ensure proper functionality:

```bash
arp
cat
chkconfig
crontab
curl
df
dmesg
dmidecode
docker
dpkg
fdisk
find
format
getconf
grep
hdparm
hostname
ifconfig
ip
iptables
lsof
lsblk
lspci
mount
netstat
ps
python3
rpm
service
systemctl
uname
wget
```

We need to ensure the limited account can execute all these commands through `sudo` without requiring a password.

Here's a shell script that can be used to check whether the limited account has access to the commands:

```bash
#!/bin/bash

# List of commands required by the discovery agent
commands=(
arp
cat
chkconfig
...
# Add the rest of the commands from the list above
)

# Check if the limited account has access to all the required commands
for command in "${commands[@]}"; do
sudo -u d42_limited command -v $command > /dev/null 2>&1
if [ $? -ne 0 ]; then
echo "Command $command not found or not executable by d42_limited"
fi
done
```

You can run this script to verify that the limited account has access to all the required commands.

## Linux and Mac Note

After downloading the agent, make it executable by running the command `chmod +x <agentname>` and use `sudo` for best results. Use the command `--sudo-password="password"` to pass in the password.
Expand Down
18 changes: 16 additions & 2 deletions docs/getstarted/arrange-and-save-list-page-column-layout.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,21 @@ sidebar_position: 8
import ThemedImage from '@theme/ThemedImage'
import useBaseUrl from '@docusaurus/useBaseUrl'

Create a new default view of a list page by rearranging columns and the sorting order of records and saving the changes.
Each category of data (such as devices, assets, and administrators) or tasks (such as webhooks and autodiscovery) in Device42 is displayed in what we refer to as a 'list page', which is the view you see when clicking on most items on the Main Appliance menu.

Each list page consists of a table with sortable columns displaying the records, a **Select an action** dropdown (which includes bulk actions, like deleting and exporting items), a search bar, and filters.

This guide explains how to resize column widths, rearrange columns, and save the column layout as the default view for list pages.

## Resize Column Widths

Control the number of characters visible in column cells by dragging the column heading divider to resize the column width.

![Column drag](/assets/images/arrange-and-save-list-page/column-drag-trimmed.gif)

## Rearrange and Save the List Page Column Layout

Create a new default view for a list page by rearranging the columns and the sorting order of the records, and then saving the changes.

- Click the **gear icon** button on the right.

Expand All @@ -18,7 +32,7 @@ Create a new default view of a list page by rearranging columns and the sorting
}}
/>

- The page displays a **Table Columns** dropdown menu you can use to select the columns you want to include on the page.
- The page displays a **Table Columns** dropdown menu, which you can use to select the columns you want to include on the page.

<ThemedImage
alt="Table columns"
Expand Down
2 changes: 1 addition & 1 deletion docs/how-to-videos/device42-object-query-language-doql.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ sidebar_position: 13

* * *

**See The [Device42 DOQL DOCUMENTATION PAGE](docs/reports/device42-doql/index.md) for DOQL documentation.**
**See The [Device42 DOQL DOCUMENTATION PAGE](docs/reports/device42-doql/index.mdx) for DOQL documentation.**

* * *

Expand Down
Loading