Names and look-ups: Difference between revisions
No edit summary |
No edit summary |
||
| Line 1: | Line 1: | ||
It is possible to label IP and MAC address with custom names and group | It is possible to label IP and MAC address with custom names and group them together into categories to allow for easy access to specific systems. | ||
them together into categories to allow for easy access to specific | For example, all your internal machines could be labeled to match their actual name and you can categorize them into different departments. | ||
systems. For example, all your internal machines could be labeled to | |||
match their actual name and you can categorize them into different | |||
departments. | |||
These user defined names are persistent and are available from start | These user defined names are persistent and are available from start on. | ||
on. | |||
== Configuration== | == Configuration== | ||
| Line 15: | Line 10: | ||
'''Adding or remove entries''' | '''Adding or remove entries''' | ||
The configuration of the list of names is available via "Settings -> | The configuration of the list of names is available via "Settings -> User defined names". | ||
User defined names". | |||
The configuration page shows on top the list of IP and MAC names | The configuration page shows on top the list of IP and MAC names currently set in the system. | ||
currently set in the system. It is possible to search for a specific | It is possible to search for a specific entry by entering the IP or MAC address, or the category or actual name. | ||
entry by entering the IP or MAC address, or the category or actual | |||
name. | |||
Individual entries may be removed from the list by clicking at the | Individual entries may be removed from the list by clicking at the trashcan symbol in the last column. | ||
trashcan symbol in the last column. | |||
At the bottom of the table new elements can be added by entering the | At the bottom of the table new elements can be added by entering the IP or MAC address, and the category and name of the element. | ||
IP or MAC address, and the category and name of the element. By | By clicking at the "plus" symbol, the entry is added and will be used without further doing. | ||
clicking at the "plus" symbol, the entry is added and will be used | |||
without further doing. | |||
The complete IP or MAC address list can be cleared by clicking at the | The complete IP or MAC address list can be cleared by clicking at the bottom below the table. A dialog will ask for confirmation. | ||
bottom below the table. A dialog will ask for confirmation. | |||
Names may also be set directly at the IP or MAC detail page, see below for more information. | |||
'''Importing IP list''' | '''Importing IP list''' | ||
The IP names allows importing an IP list from an external URL or | The IP names allows importing an IP list from an external URL or from a file in the format: | ||
from a file in the format: | |||
{| class="wikitable" | |||
|#A line with a commend | |#A line with a commend | ||
1.2.3.1 | 1.2.3.1 | ||
| Line 50: | Line 36: | ||
1.2.3.3 | 1.2.3.3 | ||
|} | |||
By clicking on "Import list" a dialog will be openend where you can choose to | By clicking on "Import list" a dialog will be openend where you can choose to download such a list from a given URL or specify a file from your system. | ||
download such a list from a given URL or specify a file from your system. The | The IPs are added to the already existing ones. | ||
IPs are added to the already existing ones. | |||
'''Uploading or downloading the complete list''' | '''Uploading or downloading the complete list''' | ||
Depending on the use case, the number of elements to add may be | Depending on the use case, the number of elements to add may be large. | ||
large. In this case it is also possible to upload a comma separated | In this case it is also possible to upload a comma separated text file (.csv). | ||
text file (.csv). The format is simple as follows: | The format is simple as follows: | ||
{| class="wikitable" | {| class="wikitable" | ||
| Line 70: | Line 54: | ||
|} | |} | ||
The first column defines whether the line describes an IP or MAC | The first column defines whether the line describes an IP or MAC address. | ||
address. The second column is the actual address and the third and | The second column is the actual address and the third and fourth is the category and the name of the entry. | ||
fourth is the category and the name of the entry | |||
The | The web page allows to download a template file which may be opened in a spreadsheet application. | ||
The | The final file can be uploaded by clicking at the upload button and selecting the file from your local directory. | ||
button | |||
The current list can be downloaded also by clicking at the download button. The CSV file will contain both IP and MAC addresses. | |||
== Name display for user defined names== | |||
If a user defined name is configured for an IP or MAC address, the | If a user defined name is configured for an IP or MAC address, the name will be shown among the alternative names (which also include possible DNS, DHCP name, or other sources of information). | ||
name will be shown among the alternative names (which also include | |||
possible DNS, DHCP name, or other sources of information). | |||
{| | {| | ||
| Line 102: | Line 77: | ||
In the detailed page for a single IP or MAC address, you can click on the pencil symbol to directly set a name for this specific address. | |||
In the detailed page for a single IP or MAC address, you can click on | |||
the pencil symbol to directly set a name for this specific address. | |||
{| | {| | ||
| Line 116: | Line 87: | ||
|} | |} | ||
The IP and MAC overview, the IP or MAC column is highlighted to | The IP and MAC overview, the IP or MAC column is highlighted to indicate such special entries for which a name is configured. | ||
indicate such special entries for which a name is configured. | |||
== Filtering== | |||
It is possible to enter the category or user defined name for IP and | It is possible to enter the category or user defined name for IP and MAC filters. | ||
MAC filters. | |||
Also, the "name" check in [[9- Live filtering of tables|complex filters]] matches | Also, the "name" check in [[9- Live filtering of tables|complex filters]] matches the user defined name, like in this example: | ||
the user defined name, like in this example: | |||
{| class="wikitable" | {| class="wikitable" | ||
|(name=systemA) | |||
|} | |} | ||
It is also possible to filter for specific category by using the | It is also possible to filter for specific category by using the "category" check: | ||
"category" check: | |||
{| class="wikitable" | {| class="wikitable" | ||
|(category=server) | |||
|} | |} | ||
In this example, the list would only show those element for which a | In this example, the list would only show those element for which a user defined name is set and its category contains the string "server". | ||
user defined name is set and its category contains the string | |||
"server". | |||
Revision as of 08:25, 14 April 2020
It is possible to label IP and MAC address with custom names and group them together into categories to allow for easy access to specific systems. For example, all your internal machines could be labeled to match their actual name and you can categorize them into different departments.
These user defined names are persistent and are available from start on.
Configuration
Adding or remove entries
The configuration of the list of names is available via "Settings -> User defined names".
The configuration page shows on top the list of IP and MAC names currently set in the system. It is possible to search for a specific entry by entering the IP or MAC address, or the category or actual name.
Individual entries may be removed from the list by clicking at the trashcan symbol in the last column.
At the bottom of the table new elements can be added by entering the IP or MAC address, and the category and name of the element. By clicking at the "plus" symbol, the entry is added and will be used without further doing.
The complete IP or MAC address list can be cleared by clicking at the bottom below the table. A dialog will ask for confirmation.
Names may also be set directly at the IP or MAC detail page, see below for more information.
Importing IP list
The IP names allows importing an IP list from an external URL or from a file in the format:
| #A line with a commend
1.2.3.1 1.2.3.2 1.2.3.3 |
By clicking on "Import list" a dialog will be openend where you can choose to download such a list from a given URL or specify a file from your system. The IPs are added to the already existing ones.
Uploading or downloading the complete list
Depending on the use case, the number of elements to add may be large. In this case it is also possible to upload a comma separated text file (.csv). The format is simple as follows:
| ip,192.168.0.1,category,name
mac,00:00:00:00:00:00,category,name ... |
The first column defines whether the line describes an IP or MAC address. The second column is the actual address and the third and fourth is the category and the name of the entry.
The web page allows to download a template file which may be opened in a spreadsheet application.
The final file can be uploaded by clicking at the upload button and selecting the file from your local directory.
The current list can be downloaded also by clicking at the download button. The CSV file will contain both IP and MAC addresses.
Name display for user defined names
If a user defined name is configured for an IP or MAC address, the name will be shown among the alternative names (which also include possible DNS, DHCP name, or other sources of information).
| IP | MAC |
|---|
In the detailed page for a single IP or MAC address, you can click on the pencil symbol to directly set a name for this specific address.
| IP | MAC |
|---|
The IP and MAC overview, the IP or MAC column is highlighted to indicate such special entries for which a name is configured.
Filtering
It is possible to enter the category or user defined name for IP and MAC filters.
Also, the "name" check in complex filters matches the user defined name, like in this example:
| (name=systemA) |
It is also possible to filter for specific category by using the "category" check:
| (category=server) |
In this example, the list would only show those element for which a user defined name is set and its category contains the string "server".