{{ picto_ipamforitop.png}}
====== IPAM for iTop ======
---- dataentry summary ----
name                : IPAM for iTop
description_wiki    : Core TeemIp extension that provides full blown IP Address Management
index_hidden        : yes
level_hidden        : 1
collector_hidden    : no
version             : 3.2.0
release_dt          : 2024-08-14
iTop                : 3.1+
code                : teemip-core-ip-mgmt
localization        : English, French, German, Italian, Spanish
state               : stable
diffusion_hidden    : iTop Hub, Combodo site, Client Store
product_hidden      : Included
module-lists_hidden : la liste des module/versions de cette extension (fabriqué par la Factory)
keyword_tags        : IP Management, IPAM, IPv4, IPv6
dependencies_s      : itop-config-mgmt, itop-tickets
download_wiki       : [[https://sourceforge.net/projects/teemip/files/teemip%20-%20an%20iTop%20module/3.2.0/teemip-core-ip-mgmt-3.2.0-812.zip/download|teemip-core-ip-mgmt-3.2.0-812.zip]]
github_wiki         : [[https://github.com/TeemIp/teemip-core-ip-mgmt|teemip-core-ip-mgmt]]
php-max             : 8.3
----

IPAM for iTop is the extension version of TeemIp that can be integrated on an existing [[https://www.itophub.io/wiki/page?id=start|iTop]] instance. It provides the core IP management features on top of which you'll be able to add one or several other TeemIp extensions.

<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>

===== Revision History =====
^  Version  ^  Release Date  ^  Status  ^  iTop Min  ^  iTop Max  ^  Comments  ^
|  3.2.1  | | |  3.2.0  |  -  | - SF [[https://sourceforge.net/p/teemip/tickets/154/|#154]] Error when removing gateway IP from subnet \\ - Filtered badges correctly behave when used in auto refresh pages \\ - IP Block's tree view: delegated blocks can be unfolded \\ - List space in IP Blocks: % free space is graphically displayed \\ - Ranges of AS numbers can be documented \\ - Newsroom provider: //TeemIp// name has been changed into //TeemIp Headlines// \\ - Export of lnkIPInterfaceToIPAddress class has been fixed |
|  **3.2.0**  |  2024-08-14  | Supported |  3.1.0  |  -  | - PR [[https://github.com/TeemIp/teemip-core-ip-mgmt/pull/32|#32]] - feat: Allow to change gateway IP format after subnet creation \\ - PR [[https://github.com/TeemIp/teemip-core-ip-mgmt/pull/31|#31]] - Fix ipv4_gateway_format dict \\ - See general [[https://wiki.teemip.net/doku.php?id=download:whatsnew#section320|what's new]] |
|  3.1.4  |  2023-12-14  |  Supported  |  3.1.0  |  -  | - PR [[https://github.com/TeemIp/teemip-core-ip-mgmt/pull/29|#29]] - Restore iTop 3.0 compatibility for VirtualMachine presentation \\ - Add Chinese (simplified) translation \\ - Background tasks are not processed when activity status is checked \\ - Global IP Settings menu is accessible to non admins |
|  3.1.3  |  2023-10-31  |  Obsolete  |  3.1.0  |  -  | - PR [[https://github.com/TeemIp/teemip-core-ip-mgmt/pull/26|#26]] - Update VirtualMachine summary card \\ - PR [[https://github.com/TeemIp/teemip-core-ip-mgmt/pull/24|#24]] - Fix auto unassigns of IP with no CIs \\ - Review layout of IP's CIs tab |
|  3.1.2  |  2023-09-21  |  Obsolete  |  3.1.0  |  -  | - PR [[https://github.com/TeemIp/teemip-core-ip-mgmt/pull/23|#23]] - Fix SQL column expression for AttributeIPv6Address \\ - PR [[https://github.com/TeemIp/teemip-core-ip-mgmt/pull/20|#20]] - Add subnet_ip to IPv6Address and IPv6Range \\ - PR [[https://github.com/TeemIp/teemip-core-ip-mgmt/pull/19|#19]] - Better UUID generation \\ - Composer was missing in the teemip-newsroom-provider module \\ - Network Typology menu is now handled by TeemIp core |
|  3.1.0-1  |  2023-09-11  |  Obsolete  |  3.0.0  |  3.1.x  | - Creation of a new DNS Domain or Zone was generating a fatal error |
|  3.1.0  |  2023-07-20  |  Obsolete  |  3.0.0  |  3.1.x  | - See general [[https://wiki.teemip.net/doku.php?id=download:whatsnew#section310|what's new]] |
|  3.0.1  |  2022-09-01  |  Obsolete  |  2.7.0  |  3.0.x  | |  
|  3.0.0  |  2022-01-04  |  Obsolete  |  2.7.0  |  3.0.x  | |
|  2.7.1  |  2021-03-29  |  Obsolete  |  2.7.0  |  2.7.x  | |
|  2.7.0  |  2020-12-20  |  Obsolete  |  2.7.0  |  2.7.x  | |
|  2.6.1  |  2020-05-08  |  Obsolete  |  2.7.0  |  2.7.x  | |
|  2.6.0  |  2020-04-15  |  Obsolete  |  2.7.0  |  2.7.x  | |
|  2.5.1  |  2019-12-11  |  Obsolete  |  2.6.0  |  2.6.x  | |
|  2.5.0  |  2019-09-24  |  Obsolete  |  2.6.0  |  2.6.x  | |
|  2.4.0  |  2019-02-09  |  Obsolete  |  2.5.0  |  2.6.x  | |
|  2.3.1  |  2018-11-04  |  Obsolete  |  2.5.0  |  2.5.x  | |
|  2.3.0  |  2018-09-24  |  Obsolete  |  2.5.0  |  2.5.x  | |
|  2.2.1  |  2018-04-13  |  Obsolete  |  2.3.0  |  2.4.x  | |
|  2.2.0  |  2017-11-26  |  Obsolete  |  2.3.0  |  2.4.x  | |
|  2.1.2  |  2017-07-28  |  Obsolete  |  2.1.0  |  2.3.x  | |
|  2.1.0  |  2016-12-22  |  Obsolete  |  2.1.0  |  2.3.x  | |
|  2.0.2  |  2015-03-02  |  Obsolete  |  2.0.3  |  2.1.x  | |
|  2.0.1  |  2014-05-27  |  Obsolete  |  2.0.3  |  2.1.x  | |
|  2.0.0  |  2014-04-21  |  Obsolete  |  2.0.3  |  2.1.x  | |
|  1.1.0  |  2013-12-13  |  Obsolete  |  1.x  |  1.x  | |
|  1.0.0  |  2013-03-11  |  Obsolete  |  1.x  |  1.x  | |

You may check the obsolescence status of your iTop version [[extensions:teemip-core-ip-mgmt#supported_itop_releases|here below]]

===== Installation =====
=== Automated installation via iTop Hub ===
This IPAM for iTop extension is available through iTop Hub and can be automatically downloaded and deployed from there. Note that iTop Hub may not be up to date with the latest TeemIp version.

  * Go to the [[https://store.itophub.io/en_US/products/teemip-core-ip-mgmt|extensions store]] on iTop Hub
  * Click on the cart icon to make the acquisition of the extension and follow the on-screen instructions to deploy it on your iTop instance

=== Manual installation ===
  * Download [[https://sourceforge.net/projects/teemip/files/teemip%20-%20an%20iTop%20module/3.2.0/teemip-core-ip-mgmt-3.2.0-812.zip/download|teemip-core-ip-mgmt-3.2.0-812.zip]] from SourceForge
  * Unzip the zip file into the iTop ''extensions'' folder
  * Make sure that the web server process has enough rights to read the copied files
  * Launch iTop setup
  * Select the IPAM for iTop extension, when prompted:

{{ :2_x:teemip-core-installation3x.png |Select IP Management in the extensions list}}

<note tip>If IPAM for iTop does not appear in the list of extensions (or if the whole extensions step is skipped during the setup), make sure that the web server process has enough rights to read the ''extensions'' directory.</note>

===== Features =====
Comprehensive documentation can be found on this wiki in the chapter [[2_x:start|Core features]].



===== Supported iTop Releases =====
Here is the obsolescence status of the different iTop community releases.

^  Branch  ^  Latest version  ^  Date  ^  Status  ^
|  **3.2**  |  3.2.0  |  September 2024  |  Supported  |
|  **3.1**  |  3.1.2  |  September 2024  |  Supported  |
|  3.0  |  3.0.4  |  January 2024  |  //Obsolete//  |
|  **2.7**  |  2.7.11  |  August 2024  |  Supported  |
|  2.6  |  2.6.4  |  April 2020  |  //Obsolete//  |
|  2.5  |  2.5.4  |  January 2020  |  //Obsolete//  |
|  2.4  |  2.4.3  |  October 2018  |  //Obsolete//  |
|  2.3  |  2.3.4  |  June 2017  |  //Obsolete//  |
|  2.2  |  2.2.1  |  February 2016  |  //Obsolete//  |
|  2.1  |  2.1.0  |  December 2014  |  //Obsolete//  |
|  2.0  |  2.0.3  |  July 2014  |  //Obsolete//  |
|  1.x  |  1.2.0  |  Autumn 2011  |  //Obsolete//  |
 

You may refer to iTop's [[https://www.itophub.io/wiki/page?id=3_0_0%3Arelease%3Astart|Community Releases]] on iTop's Hub to find out the support status of a given iTop version.