This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
extensions:teemip-ip-discovery-extension [2020/11/21 13:45] – cnaud | extensions:teemip-ip-discovery-extension [2024/01/24 10:15] – [IP Discovery - Extension] cnaud | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | {{ classicon_ipdiscovery.png}}====== IP Discovery - Extension ====== | + | {{ icons8-binoculars-48.png}} |
+ | ====== IP Discovery - Extension ====== | ||
---- dataentry summary ---- | ---- dataentry summary ---- | ||
name : IP Discovery - Extension | name : IP Discovery - Extension | ||
description_wiki | description_wiki | ||
index_hidden | index_hidden | ||
- | level_hidden | + | level_hidden |
- | version | + | collector_hidden |
- | release_dt | + | version |
- | TeemIp | + | release_dt |
+ | TeemIp | ||
+ | iTop : 3.1+ | ||
code : teemip-ip-discovery | code : teemip-ip-discovery | ||
+ | localization | ||
state : stable | state : stable | ||
diffusion_hidden | diffusion_hidden | ||
Line 15: | Line 19: | ||
keyword_tags | keyword_tags | ||
dependencies_s | dependencies_s | ||
- | download_wiki | + | download_wiki |
+ | github_wiki | ||
+ | php-max | ||
---- | ---- | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
Line 35: | Line 33: | ||
===== Revision History ===== | ===== Revision History ===== | ||
^ Version | ^ Version | ||
+ | | 3.1.1 | 2023-12-21 | ||
+ | | 3.1.0 | 2023-06-21 | ||
+ | | 3.0.1 | 2022-09-01 | ||
+ | | 1.0.0 | 2021-04-01 | ||
| 0.6.0 | 2020-10-20 | | 0.6.0 | 2020-10-20 | ||
| 0.5.1 | 2020-04-14 | | 0.5.1 | 2020-04-14 | ||
Line 49: | Line 51: | ||
The solution is made of 2 components: | The solution is made of 2 components: | ||
- | * a [[extensions: | + | |
* a [[extensions: | * a [[extensions: | ||
- | {{ | + | {{ |
Line 66: | Line 68: | ||
===== Licensing ===== | ===== Licensing ===== | ||
- | TeemIp IP Discovery | + | TeemIp IP Discovery |
The nice binocular icon attached to the IP Discovery Application in TeemIp has been found on [[https:// | The nice binocular icon attached to the IP Discovery Application in TeemIp has been found on [[https:// | ||
Line 92: | Line 94: | ||
Once installed, the extension will alter the IP Management menu by adding a sub menu group under the Tools section. | Once installed, the extension will alter the IP Management menu by adding a sub menu group under the Tools section. | ||
- | {{ details_menu_ipdiscovery.png }} | + | {{ details_menu_ipdiscovery3x.png }} |
- | The "IP Discovery" link provides statistics on IP addresses and discovery results. | + | ==== IP Discovery |
+ | It provides statistics on IP addresses and discovery results. | ||
- | {{ ipdiscovery_dashboard.png }} | + | {{ ipdiscovery_dashboard3x.png }} |
Clicking on the count figure next to an IP Discovery application provides the list of subnets discovered by the given application. | Clicking on the count figure next to an IP Discovery application provides the list of subnets discovered by the given application. | ||
+ | |||
+ | ==== Listing IP Discovery applications ==== | ||
+ | |||
+ | The IP Discovery applications shorcut displays all the applications that belong to the selected organization. | ||
+ | |||
+ | {{ classlist_ipdiscovery3x.png }} | ||
===== IP Discovery applications ===== | ===== IP Discovery applications ===== | ||
- | {{classicon_ipdiscovery.png }} | + | {{icons8-binoculars-48.png }} |
These objects define the remote applications that actually perform the discovery work. They enable these remote applications to communicate with TeemIp, list the subnets to be discovered and define how they should be discovered. | These objects define the remote applications that actually perform the discovery work. They enable these remote applications to communicate with TeemIp, list the subnets to be discovered and define how they should be discovered. | ||
Line 112: | Line 121: | ||
| Organization | Foreign key to a(n) Organization | Yes | | | Organization | Foreign key to a(n) Organization | Yes | | ||
| Status | Possible values: implementation, | | Status | Possible values: implementation, | ||
- | | Business | + | | Business |
| Location | Foreign key to a(n) Location | No | | | Location | Foreign key to a(n) Location | No | | ||
| Description | Multiline character string | | Description | Multiline character string | ||
Line 119: | Line 128: | ||
| UUID | Alphanumeric string | Read Only | | | UUID | Alphanumeric string | Read Only | | ||
| **Operations** || | | **Operations** || | ||
+ | | DHCP ranges discovery enabled | Possible values: yes, no | No | | ||
| Last discovery date | Date (year-month-day hours: | | Last discovery date | Date (year-month-day hours: | ||
| Duration | Time ( hours: | | Duration | Time ( hours: | ||
| **Ping Function** ||| | | **Ping Function** ||| | ||
| Ping enabled | Possible values: yes, no| No | | | Ping enabled | Possible values: yes, no| No | | ||
- | | Ping timeout | Integer | No | | + | | Ping timeout |
| **IP lookup Function** ||| | | **IP lookup Function** ||| | ||
| IP lookup enabled | Possible values: yes, no| No | | | IP lookup enabled | Possible values: yes, no| No | | ||
Line 132: | Line 142: | ||
| Port number | Integer | No | | | Port number | Integer | No | | ||
| Protocol | Possible values: tcp, udp, both | No | | | Protocol | Possible values: tcp, udp, both | No | | ||
- | | Scan timeout | Integer | No | | + | | Scan timeout |
| Consider " | | Consider " | ||
Line 140: | Line 150: | ||
| Documents | All the documents linked to this object | | | Documents | All the documents linked to this object | | ||
| Managed IPv4 subnets | All the IPv4 subnets that the application must discover | | | Managed IPv4 subnets | All the IPv4 subnets that the application must discover | | ||
- | |||
- | ==== Listing IP Discovery applications ==== | ||
- | |||
- | The IP Discovery applications shorcut displays all the applications that belong to the selected organization. | ||
- | |||
- | {{ classlist_ipdiscovery.png }} | ||
==== Creating a new IP Discovery application ==== | ==== Creating a new IP Discovery application ==== | ||
Line 151: | Line 155: | ||
From the listing view, click on the “New…” menu to display the creation form. | From the listing view, click on the “New…” menu to display the creation form. | ||
- | {{ classcreate_ipdiscovery.png }} | + | {{ classcreate_ipdiscovery3x.png }} |
* UUID attribute uniquely identifies the remote IP Discovery application and must be unique across TeemIp, regardless the organization it belongs to. UUID is automatically generated by TeemIp when the application is created. | * UUID attribute uniquely identifies the remote IP Discovery application and must be unique across TeemIp, regardless the organization it belongs to. UUID is automatically generated by TeemIp when the application is created. | ||
Line 164: | Line 168: | ||
===== Subnets ===== | ===== Subnets ===== | ||
- | {{classicon_ipv4subnet.png }} | + | {{icons8-subnet-48.png }} |
The extension enhances the IP Subnet datamodel so that an IP discovery application can look after them. For that purpose, the following attributes are added: | The extension enhances the IP Subnet datamodel so that an IP discovery application can look after them. For that purpose, the following attributes are added: | ||
Line 172: | Line 176: | ||
| **Discovery: | | **Discovery: | ||
| IP Discovery application | Foreign key to a(n) IP Discovery application | No | | | IP Discovery application | Foreign key to a(n) IP Discovery application | No | | ||
+ | | IP discovery DHCP ranges discovery enabled | Possible values: yes, no | Read only | | ||
| IP discovery ping enabled | Foreign attribute of the application | Read only | | | IP discovery ping enabled | Foreign attribute of the application | Read only | | ||
| IP discovery IP lookup enabled | Foreign attribute of the application | Read only | | | IP discovery IP lookup enabled | Foreign attribute of the application | Read only | | ||
Line 178: | Line 183: | ||
| **Discovery: | | **Discovery: | ||
| Discovery activated | Possible values: yes, no | No | | | Discovery activated | Possible values: yes, no | No | | ||
+ | | DHCP ranges discovery enabled for subnet | Possible values: yes, no | No | | ||
| Ping enabled for subnet | Possible values: yes, no | No | | | Ping enabled for subnet | Possible values: yes, no | No | | ||
| IP lookup enabled for subnet | Possible values: yes, no | No | | | IP lookup enabled for subnet | Possible values: yes, no | No | | ||
| Scan enabled for subnet | Possible values: yes, no | No | | | Scan enabled for subnet | Possible values: yes, no | No | | ||
- | | IP discovery considers | + | | Considers |
| **Discovery: | | **Discovery: | ||
- | | Last discovery date | | read only | | + | | Last discovery date | Date and time (year-month-day hh: |
- | | Ping duration | Time it took to ping the subnet | read only | | + | | Ping duration | Time it took to ping the subnet | Read only | |
- | | Ping # | Number of IPs discovered by ping | read only | | + | | Ping # | Number of IPs discovered by ping | Read only | |
- | | IP lookup duration | Time it took to lookup the whole subnet | read only | | + | | IP lookup duration | Time it took to lookup the whole subnet | Read only | |
- | | IP lookup # | Number of IPs discovered by IP lookup | read only | | + | | IP lookup # | Number of IPs discovered by IP lookup | Read only | |
- | | Scan duration | Time it took to scan the whole subnet | read only | | + | | Scan duration | Time it took to scan the whole subnet | Read only | |
- | | Scan # | Number of IPs discovered by scan | read only | | + | | Scan # | Number of IPs discovered by scan | Read only | |
- | ==== Creating a new subnet ==== | + | ==== Details of an IPv4 subnet ==== |
- | IP discovery attributes alter the subnet | + | IP discovery attributes alter the subnet |
- | {{ classcreate_ipv4subnet_ipdiscovery.png }} | + | {{ classdetails_ipv4subnet3x_ipdiscovery.png }} |
The 3 attributes Ping, IP lookup and Scan enabled for subnet may change the way the subnet' | The 3 attributes Ping, IP lookup and Scan enabled for subnet may change the way the subnet' | ||
Line 212: | Line 218: | ||
From the detailed display of a subnet, selecting 'List & Pick' under 'Other Actions' | From the detailed display of a subnet, selecting 'List & Pick' under 'Other Actions' | ||
- | {{ classlistips_ipv4subnet_ipdiscovery.png }} | + | {{ classlistips_ipv4subnet_ipdiscovery3x.png }} |
The following image may appear next to each IP of the subnet: | The following image may appear next to each IP of the subnet: | ||
Line 227: | Line 233: | ||
==== IP Addresses ==== | ==== IP Addresses ==== | ||
- | {{classicon_ipv4address.png }} | + | {{icons8-rj45-48.png }} |
The IP Discovery Module alters as well the IPAddress datamodel so that discovery informations related to IP addresses can be displayed at their level. The following attributes are added: | The IP Discovery Module alters as well the IPAddress datamodel so that discovery informations related to IP addresses can be displayed at their level. The following attributes are added: | ||
Line 244: | Line 250: | ||
IP discovery attributes alter the address details screen as follows: | IP discovery attributes alter the address details screen as follows: | ||
- | {{ classdetails_ipv4address_ipdiscovery.png }} | + | {{ classdetails_ipv4address_ipdiscovery3x.png }} |
* The IP discovery application is inherited from the subnet that that IP belongs to. | * The IP discovery application is inherited from the subnet that that IP belongs to. | ||
* All IP discovery parameters are, of course, **read only** as they are the result of the discovery process. | * All IP discovery parameters are, of course, **read only** as they are the result of the discovery process. | ||
+ | |||
+ | === Explode discovered FQDN === | ||
+ | In the case where IP lookup has been enabled for a subnet, discovery operations may return FQDN for IPs and it may happen that these FQDNs differs from the registered one. In such case, the "Other Actions" | ||
+ | |||
+ | When the action is launched, TeemIp will try to best match a registered domain name within the FQDN. If found, the preceding characters in the FQDN will be considered as the IP's short name, as long as it complies with the hostname format. Our above example will give: | ||
+ | |||
+ | {{ classdetails_ipv4address_ipdiscovery3x_nomenu.png }} | ||
+ | |||
+ | <note tip> | ||
+ | * The **Explode discovered FQDN** menu is available at Subnet, IP range and IP levels... as long as the IP Lookup has been authorized in the discovery parameters of the related subnet. | ||
+ | * When applied at Subnet or IP range level, all IPs contained in them will have their discovered FQDN exploded, if feasible. | ||
+ | </ | ||
+ | <note warning> | ||
+ | The **Explode discovered FQDN** menu will not appear if there is no domain name that can match with the discovered FQDN ! | ||
+ | </ | ||