User Tools

Site Tools


extensions:ocsng-data-collector

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
extensions:ocsng-data-collector [2019/01/21 15:59]
vdumas
extensions:ocsng-data-collector [2020/04/17 10:34] (current)
Line 1: Line 1:
 ====== Data collector for OCS Inventory ====== ====== Data collector for OCS Inventory ======
 ---- dataentry summary ---- ---- dataentry summary ----
-name             ​: Data collector for OCS Inventory +name                : Data collector for OCS Inventory 
-description_wiki : Data Collector for OCS Inventory NG +description_wiki ​   : Data Collector for OCS Inventory NG 
-index_hidden ​    ​: yes +index_hidden ​       : yes 
-version ​         : 1.0.4 +version ​            ​: 1.0.5 
-release_dt ​      ​2018-09-04 +release_dt ​         2019-10-29 
-itop-version-min :  +itop-version-min ​   :  
-dependencies_s ​  :  +download ​           ​: http://​www.combodo.com/​itop-extensions/​ 
-download_hidden ​    : http://​www.combodo.com/​itop-extensions/​ocsng-data-collector-1.0.3-368.zip +code                : ocsng-data-collector 
-code             ​: ocsng-data-collector +state               : stable 
-diffusion ​       : iTop Hub, Combodo site +product_hidden ​     ​: not-included 
-status_ ​          : stable +alias-code_hidden ​  : ocsng-data-collector 
-products ​        : not-included +alternate-name ​     : Data collector for OCS Inventory NG 
-module-lists_hidden : itop-data-collector-base/​1.0.12, itop-data-collector-ocsng/​1.0.1 +module-lists_hidden : itop-data-collector-base/​1.0.13, itop-data-collector-ocsng/​1.0.2 
-standalone ​         ​yes+diffusion ​          iTop Hub,Combodo site
 ---- ----
 +
  
 <​related_components>​Other versions of this component:</​related_components>​ <​related_components>​Other versions of this component:</​related_components>​
Line 23: Line 24:
 {{ :​extensions:​itopocsngcollector.png?​direct&​450 |}} {{ :​extensions:​itopocsngcollector.png?​direct&​450 |}}
  
-An additional (and optional) extension is available to display the content of the OCS Inventory pages directly inside iTop, for each synchronized object (Server, PC or Virtual Machine):+An additional (and optional) extension ​[[extensions:​itop-ocsng]] ​is available to display the content of the OCS Inventory pages directly inside iTop, for each synchronized object (Server, PC or Virtual Machine):
  
 {{ :​extensions:​ocsngitopframe.png?​direct&​650 |}} {{ :​extensions:​ocsngitopframe.png?​direct&​650 |}}
Line 35: Line 36:
   * Automatic creation and update of the Synchronization Data Sources in iTop.   * Automatic creation and update of the Synchronization Data Sources in iTop.
   * An optional small extension is available to display an extra tab "OCS Inventory"​ on synchronized PCs, Servers and VirtualMachines. This tab displays the OCS page for the device (using an IFRAME).   * An optional small extension is available to display an extra tab "OCS Inventory"​ on synchronized PCs, Servers and VirtualMachines. This tab displays the OCS page for the device (using an IFRAME).
 +
 +
 +
 +<note tip>This collector makes use of iTop's built-in Data Synchronization mechanism. For more information about how the data synchronization works, refer to [[latest:​advancedtopics:​data_synchro_overview|Data Synchronization Overview]] and relies on [[extensions:​itop-data-collector-base|Data collector Base]] mechanism</​note>​
  
 ===== Revision History ===== ===== Revision History =====
 ^ Date ^ Version ^ Description ^ ^ Date ^ Version ^ Description ^
 +|  2019-10-29 ​ |  1.0.5  | Handles TeemIp :\\ - Automatically detects if TeemIp (as an iTop module or as a standalone application) is present.\\ - Optional synchronization of IPv4 addresses\\ - Optional synchronisation of IP interfaces |
 |  2018-09-04 ​ |  1.0.4  | First public version. No longer requires an alteration of the data model. | |  2018-09-04 ​ |  1.0.4  | First public version. No longer requires an alteration of the data model. |
 |  2018-06-26 ​ |  1.0.3  | New debug trace | |  2018-06-26 ​ |  1.0.3  | New debug trace |
Line 49: Line 55:
   * The collector is not normalizing Model, OS Family and OS Version   * The collector is not normalizing Model, OS Family and OS Version
   * The collector synchronizes only PCs and Servers which have a valid serial number in OCS   * The collector synchronizes only PCs and Servers which have a valid serial number in OCS
-  * The current version ​is not compatible with TeemIP+  * If IP collection ​is enabled, only IPv4 addresses are collected, ​not IPv6
   * If your iTop is accessed using HTTPS, then the same must be true for OCS Inventory otherwise the inline frame of OCS Inventory inside iTop will not display because of browsers'​s security restrictions.   * If your iTop is accessed using HTTPS, then the same must be true for OCS Inventory otherwise the inline frame of OCS Inventory inside iTop will not display because of browsers'​s security restrictions.
   * There is no single sign-on between iTop and OCS, so you'll have to login to OCS when displaying the OCS tab.   * There is no single sign-on between iTop and OCS, so you'll have to login to OCS when displaying the OCS tab.
Line 58: Line 64:
   * An access to the OCS Inventory NG mysql database   * An access to the OCS Inventory NG mysql database
   * An access to the iTop web services (REST + synchro_import.php and synchro_exec.php). **Note**: starting with iTop 2.5.0, the user must have the profile ''​REST Services User''​ in iTop.   * An access to the iTop web services (REST + synchro_import.php and synchro_exec.php). **Note**: starting with iTop 2.5.0, the user must have the profile ''​REST Services User''​ in iTop.
 +  * + [[extensions:​itop-data-collector-base#​requirements|Data collector Base]] requirements.
  
 ===== Installation ===== ===== Installation =====
Line 167: Line 174:
  
 <note tip>The file ''​params.distrib.xml''​ contains the default values for the parameters. Both files (''​params.distrib.xml''​ and ''​params.local.xml''​) use exactly the same format. But ''​params.distrib.xml''​ is considered as the reference and should remain unmodified. Should you need to change the value of a parameter, copy and modify its definition in ''​params.local.xml''​. The values in ''​params.local.xml''​ have precedence over the ones in ''​params.distrib.xml''</​note>​ <note tip>The file ''​params.distrib.xml''​ contains the default values for the parameters. Both files (''​params.distrib.xml''​ and ''​params.local.xml''​) use exactly the same format. But ''​params.distrib.xml''​ is considered as the reference and should remain unmodified. Should you need to change the value of a parameter, copy and modify its definition in ''​params.local.xml''​. The values in ''​params.local.xml''​ have precedence over the ones in ''​params.distrib.xml''</​note>​
 +
 +==== IPs and IP Interfaces collection ====
 +
 +The collector automatically detects if TeemIp is present on the remote iTop application (as a module or even as a stand-alone application) and if TeemIp Zone Management extension is installed. Should that be the case, then the following parameters may trigger IP addresses and IP interfaces collection.
 +
 +<code xml>
 +<?xml version="​1.0"​ encoding="​UTF-8"?>​
 +  <​parameters>​
 +    ...
 +    <!-- TeemIp options -->
 +    <​collect_ips>​yes</​collect_ips>​
 +    <​default_ip_status>​allocated</​default_ip_status>​
 +    <​manage_ipv6>​no</​manage_ipv6>​
 +    <​default_view_name></​default_view_name>​
 +    ...
 +  </​parameters>​
 +</​code>​
 +
 +^ Parameter ^ Meaning ^ Sample value ^
 +| collect_ips | Triggers IP addresses collection | yes |
 +| default_ip_status | Satus of newly created IP addresses | allocated |
 +| manage_ipv6 | Triggers IPv6 collection - not working yet | no |
 +| default_view_name| View of the newly created IP addresses | <empty string> |
 +
 +<note warning>​At this stage, IPv6 are not collected. This is due to a limitation of the collector base which cannot handle such objects yet.</​note>​
 +
 +
 ===== Usage ===== ===== Usage =====
  
extensions/ocsng-data-collector.1548082769.txt.gz · Last modified: 2019/01/21 15:59 (external edit)

";