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
Next revisionBoth sides next revision
collectors:teemip-ip-discovery-collector [2023/09/15 10:41] – [IP Discovery] cnaudcollectors:teemip-ip-discovery-collector [2023/11/03 17:05] – [Features] cnaud
Line 1: Line 1:
-{{ icons8-binoculars-48.png}} +{{ extensions:picto_ipdiscoverydatacollector.png}} 
-====== IP Discovery Collector ======+====== IP Discovery Data collector ======
 ---- dataentry summary ---- ---- dataentry summary ----
-name                : IP Discovery Colletor+name                : IP Discovery Data colletor
 description_wiki    : Data collector to discover IP addresses description_wiki    : Data collector to discover IP addresses
 index_hidden        : yes index_hidden        : yes
 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 25: Line 26:
  
  
- +TeemIp IP Discovery Data Collector is standalone application that discovers active IPs on networks based on directives provided by the the TeemIp IP Discovery Extension installed on TeemIp.
- +
- +
- +
- +
- +
- +
- +
- +
- +
- +
-TeemIp IP Discovery Collector is the standalone application that discovers active IPs on networks based on directives provided by the the TeemIp IP Discovery Extension installed on TeemIp.+
  
 <note>Vocabulary: by "TeemIp solution" or "TeemIP", it should be understood: TeemIp standalone or the iTop solution on top of which TeemIp as a module has been installed. <note>Vocabulary: by "TeemIp solution" or "TeemIP", it should be understood: TeemIp standalone or the iTop solution on top of which TeemIp as a module has been installed.
Line 44: Line 34:
 ===== Revision History ===== ===== Revision History =====
 ^  Version  ^  Release Date  ^  Comments  ^ ^  Version  ^  Release Date  ^  Comments  ^
 +|  **3.1.2**  |  2023-10-30  | Implement GitHub PR [[https://github.com/TeemIp/teemip-ip-discovery-collector/pull/4|#4]], [[https://github.com/TeemIp/teemip-ip-discovery-collector/pull/5|#5]] and [[https://github.com/TeemIp/teemip-ip-discovery-collector/pull/6|#6]] - Correct SF Bug [[https://sourceforge.net/p/teemip/tickets/140/|#140]]|
 |  3.1.1  |  2023-08-07  | Use fping as an option \\ Make sure collection order is respected \\ Complete list of optional attributes | |  3.1.1  |  2023-08-07  | Use fping as an option \\ Make sure collection order is respected \\ Complete list of optional attributes |
 |  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.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 |
Line 56: Line 47:
  
 The solution is made of 2 components: The solution is made of 2 components:
-  * a [[extensions:teemip-ip-discovery-collector|discovery engine]], called the IP Discovery 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 Extension, 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 88: Line 79:
 ===== 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 147: Line 144:
     <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.txt · Last modified: 2024/05/21 17:22 by cnaud