TeemIp as an iTop module - version 1.0-2 - 25-Apr-2013
Readme file

1.   ABOUT THIS RELEASE
2.   INSTALLATION
2.1. Requirements
2.2. Install procedure
3.   FEATURES
3.1. Changes since 1.0-1
3.2. Changes since 1.0
3.3. Known limitations
3.4. Known issues

1. ABOUT THIS RELEASE
   ==================
This package is the module version of TeemIp release 1.0-2. It contains all what is necessary to include TeemIp's 
IP management modules into an iTop application.

TeemIp's documentation can be found at: http://sourceforge.net/p/teemip/wiki/Home/
iTop's documentation is available as a Wiki at: http://www.combodo.com/wiki

TeemIp is released under the AGPL (v3) license. (Check license.txt in this directory).
The source code of TeemIp can be found on SourceForge: http://teemip.sourceforge.net

1.1 What's new?
    -----------
NOthing much from version 1.0-1 but a correction in the datamodel for the Server class.


1.2 Special Thanks To:
    ------------------
The Combodo team: Denis Flaven, Romain Quetiez and Erwan Taloc.


2. INSTALLATION
   ============

2.1. Requirements
     ------------
Server configuration:
TeemIp as an iTop module doesn't require anyting more than what iTop requires.

End-user configuration:
Although TeemIp should work with most modern web browsers, the application has been tested mostly with Firefox 3, 
IE8, IE9, Safari 5 and Chrome. TeemIp was designed for at least a 1024x768 screen resolution.


2.2. Install procedure
     -----------------
1) Unpack the files contained in the zipped package, and copy the content of the "web" directory into your current
   iTop web diretory. TeemIp directories should appear in the web/extensions directory. 
2) Make sure that the configuration file located at web/conf/production/config-itop.php is writable by the 
   web server (on Windows: remove the "read-only" flag, on Linux adjust the rights of the file).
3) Re-launch the installation process by pointing your browser to web/setup/ and follow the indications on the 
   screen. 
4) When selecting optional adaptor extensions, make sure that you only select the ones that correspond to iTop modules 
   that have indeed been selected. And vice versa, don't select an adaptor which iTop corresponding module has not
   been selected.
    
    
3. FEATURES
   ========

3.1. Changes since 1.0-1
     -------------------
Lists related to the class Server have been modified so that attribute 'managementip' becomes attribute 'managmentip_id'.
 

3.2. Changes since 1.0
     -----------------
Next to the teemip-config-mgmt-adaptor and teemip-virtualization-mgmt-adaptor modules, an adaptor module for the 
itop-storage-mgmt module has been added: teemip-storage-mgmt-adaptor. It insures that, when teemip module is selected, 
all Management IPs points to TeemIp IPs. 


Localization
------------
English and French only. If you wish to contribute to add langages to TeemIp, please, contact us.


Minor changes
-------------
None

3.2. Known limitations
     -----------------
Warning: when you decide to install TeemIp as an iTop module and to link TeemIp IP objects to iTop CMDB, make sure 
to use the directory teemip-config-mgmt-adaptor provided in the module zip (this package) and not the one from the product zip. 
Indeed, the adaptor of the product will modify the fields of the Organization object in a way that is not compatible 
with iTop application (it will remove the link to the delivery models).


3.3. Known issues (https://sourceforge.net/p/teemip/tickets/)
     ------------
#1 Deleting a cascaded list of subnet blocks will generate an exception and all blocks won't be delete as requested. 
However, system will not be affected and operations can continue. This bug comes from the deletion policy for the 
type of hierarchical key used to define subnet blocks.