This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
extensions:teemip-ip-discovery-collector [2019/10/09 10:09] – [TeemIp IPv4 Discovery] cnaud | extensions:teemip-ip-discovery-collector [2023/08/07 16:18] – [Features] cnaud | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | {{ icons8-binoculars-48.png}} | ||
====== IP Discovery - Collector ====== | ====== IP Discovery - Collector ====== | ||
---- dataentry summary ---- | ---- dataentry summary ---- | ||
Line 5: | Line 6: | ||
index_hidden | index_hidden | ||
level_hidden | level_hidden | ||
- | version | + | version |
- | release_dt | + | release_dt |
- | TeemIp | + | TeemIp |
+ | iTop : 3.x | ||
code : teemip-ip-discovery-collector | code : teemip-ip-discovery-collector | ||
- | state : | + | localization |
+ | state : | ||
diffusion_hidden | diffusion_hidden | ||
product_hidden | product_hidden | ||
Line 15: | Line 18: | ||
keyword_tags | keyword_tags | ||
dependencies_s | dependencies_s | ||
- | download_url | + | download_wiki |
+ | github_wiki | ||
+ | php-max | ||
---- | ---- | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
Line 28: | Line 43: | ||
===== Revision History ===== | ===== Revision History ===== | ||
^ Version | ^ Version | ||
- | | 0.4.0 | | + | | 3.1.1 | 2023-08-07 |
+ | | 3.1.0 | 2023-07-25 | ||
+ | | 3.0.1 | 2022-09-21 | ||
+ | | 0.5.0 | 2020-10-20 | ||
+ | | 0.4.0 | | ||
| 0.3.0 | 2019-02-09 | | 0.3.0 | 2019-02-09 | ||
Line 39: | Line 58: | ||
* a [[extensions: | * a [[extensions: | ||
- | {{ | + | {{ |
The IP Discovery Application is a standalone PHP software that extends iTop's collectors principles. It has been built on top of [[https:// | The IP Discovery Application is a standalone PHP software that extends iTop's collectors principles. It has been built on top of [[https:// | ||
Line 48: | Line 67: | ||
At regular interval (defined by the administrator through a CRON command) the remote collector retrieves in TeemIp the list of networks that it has to discover and, for each of them, the list of IPs already registered. It, then, scans the network, computes | At regular interval (defined by the administrator through a CRON command) the remote collector retrieves in TeemIp the list of networks that it has to discover and, for each of them, the list of IPs already registered. It, then, scans the network, computes | ||
* New discovered IPs are created, | * New discovered IPs are created, | ||
- | * Ping, IP lookup or scan statuses are updated, | + | * Ping / fping, IP lookup or scan statuses are updated, |
* A few statics on the discovery are documented within each subnet. | * A few statics on the discovery are documented within each subnet. | ||
- | < | + | < |
Should your network be compartmentalized by different firewalls, the different instances will allow you to bypass the restrictions imposed by the firewalls: limited pings or udp / tcp connections, | Should your network be compartmentalized by different firewalls, the different instances will allow you to bypass the restrictions imposed by the firewalls: limited pings or udp / tcp connections, | ||
</ | </ | ||
Line 57: | Line 76: | ||
===== Licensing ===== | ===== Licensing ===== | ||
- | TeemIp IP Discovery | + | TeemIp IP Discovery |
===== Limitations ===== | ===== Limitations ===== | ||
Line 65: | Line 84: | ||
===== Requirements ===== | ===== Requirements ===== | ||
- | On the application' | + | On the application' |
===== Installation ===== | ===== Installation ===== | ||
- | + | <note important> | |
Expand the content of the zip archive in a folder of the server that will run the discovery. | Expand the content of the zip archive in a folder of the server that will run the discovery. | ||
Line 86: | Line 104: | ||
< | < | ||
+ | <!-- Class collection sequence --> | ||
+ | < | ||
+ | <!-- IPv4 addresses --> | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | <!-- IPv4 subnets --> | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | <!-- IP applications --> | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | | ||
<!-- Synchronization parameters --> | <!-- Synchronization parameters --> | ||
< | < | ||
Line 97: | Line 137: | ||
</ | </ | ||
- | <!-- IP Addresses Parameters --> | + | |
< | < | ||
< | < | ||
| | ||
- | <!-- Discovery functions --> | + | |
< | < | ||
< | < | ||
Line 113: | Line 153: | ||
| itop_login | Login (user account) for connecting to TeemIp. Must have admin rights for executing the data synchro. | admin | | | itop_login | Login (user account) for connecting to TeemIp. Must have admin rights for executing the data synchro. | admin | | ||
| itop_password | Password for the iTop account. | admin_pwd | | | itop_password | Password for the iTop account. | admin_pwd | | ||
+ | | collectors_launch_sequence | List of collectors to run | N/A | | ||
+ | | collector | Details for a collector class | N/A | | ||
+ | | name | Name of the collector class | TeemIpDiscoveryIPv4Collector | | ||
+ | | | ||
+ | | rank | Order of the collect amongst allother collectors | 1 | | ||
| contact_to_notify | The email address of an existing contact in TeemIp to be notified of the results of the synchronization. | john.doe@demo.com | | | contact_to_notify | The email address of an existing contact in TeemIp to be notified of the results of the synchronization. | john.doe@demo.com | | ||
| discovery_application_uuid | String that uniquely identifies the remote the IP Discovery Application in TeemIp. The string is automatically created at creation time of the IP Discovery object| FFF3_60D8_FEE6_520D | | | discovery_application_uuid | String that uniquely identifies the remote the IP Discovery Application in TeemIp. The string is automatically created at creation time of the IP Discovery object| FFF3_60D8_FEE6_520D | | ||
Line 125: | Line 170: | ||
<note tip>The [[https:// | <note tip>The [[https:// | ||
- | <note warning> | + | <note warning> |
===== Run the discovery ===== | ===== Run the discovery ===== | ||
Line 138: | Line 183: | ||
^ Option ^ Meaning ^ default value ^ | ^ Option ^ Meaning ^ default value ^ | ||
- | | < | + | | < |
- | | < | + | | < |
- | | < | + | | < |
- | | < | + | | < |
+ | | < | ||
+ | | < | ||
| < | | < | ||
+ | | < | ||
Once invoked through the command line, the discovery application will: | Once invoked through the command line, the discovery application will: | ||
- | | + | |
- | - Connect | + | |
- | | + | |
- | | + | |
- | | + | |
- | | + | * Ping and / or look up and / or scan all subnets' |
- | | + | |
- | | + | |
- | | + | |
+ | * Update statistics of discovery application. | ||
==== Scheduling ==== | ==== Scheduling ==== | ||
Line 177: | Line 226: | ||
The command is invoked through the exec PHP function. | The command is invoked through the exec PHP function. | ||
- | < | + | < |
For instance: | For instance: | ||
- | / | + | / |
Line 227: | Line 276: | ||
* If no answered is received, a test is done with TCP. | * If no answered is received, a test is done with TCP. | ||
- | ===== Synchronize | + | According to the parameter //Consider “connection refused” as valid//, a scan that fails with error 111 (connection is refused) may be considered as valid from a discovery standpoint. |
+ | |||
+ | ===== Synchronize | ||
Discovery results of an IP Discovery Application are fed back to TeemIp through standard synchro data sources. Every IP discovery application will automatically create its own synchro data sources and will use them to push its finding and statistics into TeemIp, systematically, | Discovery results of an IP Discovery Application are fed back to TeemIp through standard synchro data sources. Every IP discovery application will automatically create its own synchro data sources and will use them to push its finding and statistics into TeemIp, systematically, | ||
- | These synchro data sources can be listed and managed from the Synchronization Data Sources menu under the Admin tools section. | + | These synchro data sources can be listed and managed from the Synchronization Data Sources menu under the Admin tools section. |
+ | |||
+ | |||
+ | ==== TeemIp Discovery Application ==== | ||
+ | |||
+ | {{ details_synchrodatasource_applicationdiscovery3x.png }} | ||
+ | |||
+ | Default parameters for a given data source are defined in the remote IP Discovery application configuration file. | ||
+ | * The UUID of the application is appended to the name of the synchro data source for an easy identification, | ||
+ | * Statistics on discovery durations are updated. | ||
+ | |||
+ | Reconciliation of the Application is made on the UUID. The following attributes may be affected by this synchro: | ||
+ | |||
+ | ^ Name ^ When ? ^ Comment ^ | ||
+ | | Last discovery date | Creation and update | | | ||
+ | | Duration | Creation and update | | | ||
==== TeemIp IPv4 Discovery ==== | ==== TeemIp IPv4 Discovery ==== | ||
- | {{ details_synchrodatasource_ipdiscovery.png }} | + | {{ details_synchrodatasource_ipdiscovery3x.png }} |
Default parameters for a given data source are defined in the remote IP Discovery application configuration file. | Default parameters for a given data source are defined in the remote IP Discovery application configuration file. | ||
Line 244: | Line 311: | ||
Reconciliation of IP addresses is done on the Organization and Address attributes. The following attributes may be affected by this synchro: | Reconciliation of IP addresses is done on the Organization and Address attributes. The following attributes may be affected by this synchro: | ||
- | ^ Name ^ When ? ^ | + | ^ Name ^ When ? |
- | | Organization | Creation only | | + | | Organization | Creation only | | |
- | | Status | Creation only | | + | | Status | Creation only | | |
- | | Address | Creation only | | + | | Address | Creation only | |
- | | DNS View | Creation only | | + | | DNS View* | Creation only | If applicable |
- | | Last discovery date | Creation and update | | + | | Last discovery date | Creation and update |
- | | Responds to ping | Creation and update | | + | | Responds to ping | Creation and update |
- | | Responds to IP lookup| Creation and update | | + | | Responds to IP lookup| Creation and update |
- | | FQDN from IP lookup | Creation and update | | + | | FQDN from IP lookup | Creation and update |
- | | Responds to scan | Creation and update | | + | | Responds to scan | Creation and update |
<note tip> | <note tip> | ||
- | The discovery collector automatically detects if the Zone management | + | The discovery collector automatically detects if the Zone Management |
* If this is the case: the collector handles the DNS view attribute brought by the extension. | * If this is the case: the collector handles the DNS view attribute brought by the extension. | ||
- | * If this is NOT the ase: the DNS view attribute is not managed. | + | * If this is NOT the case: the DNS view attribute is not managed. |
</ | </ | ||
==== TeemIp IPv4 Subnet Discovery ==== | ==== TeemIp IPv4 Subnet Discovery ==== | ||
- | {{ details_synchrodatasource_subnetdiscovery.png }} | + | {{ details_synchrodatasource_subnetdiscovery3x.png }} |
Default parameters for a given data source are defined in the remote IP Discovery application configuration file. | Default parameters for a given data source are defined in the remote IP Discovery application configuration file. | ||
Line 274: | Line 341: | ||
| Last discovery date | Update | | | Last discovery date | Update | | ||
| Ping duration | Update | | | Ping duration | Update | | ||
+ | | Ping # | Update | | ||
| IP lookup duration | Update | | | IP lookup duration | Update | | ||
+ | | IP Lookup # | Update | | ||
| Scan duration | Update | | | Scan duration | Update | | ||
- | + | | Scan # | Update | | |
- | + | ||
- | As usual with synchro data sources, the Status tab will provide information on every synchronization that occurred between the remote IP Discovery application and TeemIp. | + | |
- | + | ||