User Tools

Site Tools


collectors:teemip-ip-discovery-collector

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
collectors:teemip-ip-discovery-collector [2023/09/15 14:27] cnaudcollectors:teemip-ip-discovery-collector [2024/04/04 14:54] (current) – [Revision History] cnaud
Line 1: Line 1:
-{{ extensions:icons8-binoculars-48.png}}+{{ extensions:picto_ipdiscoverydatacollector.png}}
 ====== IP Discovery Data collector ====== ====== IP Discovery Data collector ======
 ---- dataentry summary ---- ---- dataentry summary ----
Line 7: Line 7:
 level_hidden        : 1 level_hidden        : 1
 collector_hidden    : yes collector_hidden    : yes
-version             : 3.1.1 +version             : 3.1.2 
-release_dt          : 2023-08-07+release_dt          : 2023-10-30
 TeemIp              : 3.x TeemIp              : 3.x
 iTop                : 3.x iTop                : 3.x
Line 17: Line 17:
 product_hidden      : included (standalone) product_hidden      : included (standalone)
 module-lists_hidden :  module-lists_hidden : 
 +provider            : TeemIp
 keyword_tags        : discovery, ping, fping, lookup, scan keyword_tags        : discovery, ping, fping, lookup, scan
 dependencies_s      :  dependencies_s      : 
-download_wiki       : [[https://sourceforge.net/projects/teemip/files/teemip%20-%20extensions/IP%20Discovery/IP%20Discovery%20-%20Collector/3.1.1/teemip-ip-discovery-collector-3.1.1-354.zip/download|teemip-ip-discovery-collector-3.1.1-354.zip]]+download_wiki       : [[https://sourceforge.net/projects/teemip/files/teemip%20-%20extensions/IP%20Discovery/IP%20Discovery%20-%20Collector/3.1.2/teemip-ip-discovery-collector-3.1.2-355.zip/download|teemip-ip-discovery-collector-3.1.2-355.zip]]
 github_wiki         : [[https://github.com/TeemIp/teemip-ip-discovery-collector|teemip-ip-discovery-collector]] github_wiki         : [[https://github.com/TeemIp/teemip-ip-discovery-collector|teemip-ip-discovery-collector]]
 php-max             : 8.1 php-max             : 8.1
Line 33: Line 34:
 ===== Revision History ===== ===== Revision History =====
 ^  Version  ^  Release Date  ^  Comments  ^ ^  Version  ^  Release Date  ^  Comments  ^
-|  3.1.1  |  2023-08-07  | Use fping as an option \\ Make sure collection order is respected \\ Complete list of optional attributes | +|  3.1.3  |  2024-xx-yy  | - PR [[https://github.com/TeemIp/teemip-ip-discovery-collector/pull/8|#8]] Fix fping command to not output stderr \\ - PR [[https://github.com/TeemIp/teemip-ip-discovery-collector/pull/7|#7]] Correctly call parent Prepare method for IPv4Collector | 
-|  3.1.0  |  2023-07-25  | Includes iTop Data Collector Base 1.3.0 \\ Implement collection plan feature of that collector base \\ Insure compatibility with PHP 8.1 | +|  **3.1.2**  |  2023-10-30  | - PR [[https://github.com/TeemIp/teemip-ip-discovery-collector/pull/6|#6]] IPv4SubnetCollector cleanup \\ - PR [[https://github.com/TeemIp/teemip-ip-discovery-collector/pull/5|#5]] Change IP Discovery Application synchro to use the primary_key as reconciliation  \\ - PR [[https://github.com/TeemIp/teemip-ip-discovery-collector/pull/4|#4]] Various cleanup\\ - Correct SF Bug [[https://sourceforge.net/p/teemip/tickets/140/|#140]]| 
-|  3.0.1  |  2022-09-21  | Align data model to TeemIp 3.x \\ Report number of discovered IPs at subnet level \\ Allow DHCP ranges to be skipped during discovery  |  +|  3.1.1  |  2023-08-07 Use fping as an option \\ Make sure collection order is respected \\ Complete list of optional attributes | 
-|  0.5.0  |  2020-10-20  | Improves reporting - Consider “connection refused” for scans | +|  3.1.0  |  2023-07-25 Includes iTop Data Collector Base 1.3.0 \\ Implement collection plan feature of that collector base \\ Insure compatibility with PHP 8.1 | 
-|  0.4.0  |  2019-10-11  | Improves IP lookup and handles DNS views | +|  3.0.1  |  2022-09-21 Align data model to TeemIp 3.x \\ Report number of discovered IPs at subnet level \\ Allow DHCP ranges to be skipped during discovery  |  
-|  0.3.0  |  2019-02-09  | Initial production release |+|  0.5.0  |  2020-10-20 Improves reporting - Consider “connection refused” for scans | 
 +|  0.4.0  |  2019-10-11 Improves IP lookup and handles DNS views | 
 +|  0.3.0  |  2019-02-09 Initial production release |
  
 ===== Features ===== ===== Features =====
Line 46: Line 49:
 The solution is made of 2 components: The solution is made of 2 components:
   * a [[collectors:teemip-ip-discovery-collector|discovery engine]], called the IP Discovery Data collector or the IP Discovery Application, that discovers IPs through pings, DNS reverse lookups and port scanning,   * a [[collectors:teemip-ip-discovery-collector|discovery engine]], called the IP Discovery Data collector or the IP Discovery Application, that discovers IPs through pings, DNS reverse lookups and port scanning,
-  * a [[extensions:teemip-ip-discovery-extension|TeemIp extension]], called the IP Discovery Data model, that adapts TeemIp's standard data model to store the discovery outputs and enables communication between a TeemIp instance and the different discovery engines deployed on the network.+  * a [[extensions:teemip-ip-discovery|TeemIp extension]], called the IP Discovery Data model, that adapts TeemIp's standard data model to store the discovery outputs and enables communication between a TeemIp instance and the different discovery engines deployed on the network.
  
-{{  ipdiscoveryprinciples3x.png  }}+{{  extensions:ipdiscoveryprinciples3x.png?0x550  }}
  
 The IP Discovery Application is a standalone PHP software that extends iTop's collectors principles. It has been built on top of [[https://wiki.openitop.org/doku.php?id=extensions:itop-data-collector-base| iTop data collector base]] extension. TeemIp administrators may deploy one or several IP Discovery Collectors on different servers, including the one that hosts TeemIp. Each of these remote applications connects to TeemIp to retrieve: The IP Discovery Application is a standalone PHP software that extends iTop's collectors principles. It has been built on top of [[https://wiki.openitop.org/doku.php?id=extensions:itop-data-collector-base| iTop data collector base]] extension. TeemIp administrators may deploy one or several IP Discovery Collectors on different servers, including the one that hosts TeemIp. Each of these remote applications connects to TeemIp to retrieve:
Line 77: Line 80:
 ===== Installation ===== ===== Installation =====
  
-<note important>Do not install this extension in your webserver directories (like apache). otherwise your configuration files (with URLs, credentials) may be accessible from outside</note>+<note important> 
 +Do not install this extension in your webserver directories (like apache). otherwise your configuration files (with URLs, credentials) may be accessible from outside 
 +</note>
  
 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.
 +
 +<note warning>
 +When upgrading from the 3.1.1 version or older toward the 3.1.2 version, you must **delete** the 2 existing synchro data source **TeemIp Discovery Application** and **TeemIp IPv4 Subnet Discovery** that you can reach under the "Configuration / Synchronization Data Sources" menu.
 +</note>
 ===== Configuration ===== ===== Configuration =====
  
Line 136: Line 145:
     <fping_absolute_path>/usr/bin/</fping_absolute_path>     <fping_absolute_path>/usr/bin/</fping_absolute_path>
     <!-- Absolute path for dig command - "dig" will be executed with no path if not provided-->     <!-- Absolute path for dig command - "dig" will be executed with no path if not provided-->
-    <dig_absolute_path>/usr/bin/</dig_absolute_path></parameters>+    <dig_absolute_path>/usr/bin/</dig_absolute_path>
          
     <!-- fping usage may be disabled here -->     <!-- fping usage may be disabled here -->
     <fping_enable>yes</fping_enable>     <fping_enable>yes</fping_enable>
  
-    +</parameters>    
 </code> </code>
  
collectors/teemip-ip-discovery-collector.1694780872.txt.gz · Last modified: 2023/09/15 14:27 by cnaud