|2.6.0||5.6||5.6||10.1||MySQL8 not working, PHP7.3 not working|
|2.6.1||5.6||5.6||10.1||MySQL8 not working, PHP7.3 supported|
|2.7.0||5.6||5.6||10.1||MySQL8 not recommended for large database,
IE9 no more supported
|2.8.0||7.1||5.7||10.3 ?||IE11 no more supported|
Why upgrading? What features are brought by new versions:
Before upgrading your instance of iTop to a new version, read all migration notes on the upgrade path.
How to upgrade
Before upgrading, check all of your installed extensions are compatible with the new version !
List of installed extensions and their version can be found in the “about iTop…” dialog, located in the log-off menu.
Check compatibility by opening each extension documentation.
Also, you should first try the update on a test environment running the same environment (PHP and MySQL version and configuration) and same data.
If your installed iTop version is above 2.7.0, you should use the updater in System / Application Upgrade, especially for security updates. The application upgrader will check the system configuration and warn you if the requirements are not met. If you can't use it for any reason (upload size, write permissions, …), use the below process.
Get your corresponding iTop package :
iTop Professional or Essential : for Combodo and Combodo partners clients, download it from the Designer. On the Designer home screen, click on your instance's version, in the displayed dialog select the version you need and click download
iTop Community : from sourceforge
Make a backup of your current iTop directory (you should exclude /data/backups)
Unzip the downloaded package in your iTop directory : this will create a /web subdirectory
If you used the /webservices/cron.params file, copy it to /web/webservices
Remove previous version core files :
rm -rf addons datamodels images lib manifest.xml portal application core dictionaries env-test index.php navigator setup webservices approot.inc.php css js pages synchro sources documentation
Your iTop directory should now contains
the following subdirectories : conf, data, env-production, log, extensions, web (and maybe toolkit or collectors if you have installed them)
no file at the iTop directory level
You may need to remove
templates/if present (since 2.7.0)
Copy new version core files by launching this command, still in your iTop directory :
cp -r ./web/* .
Check permissions (your webserver user must have access)
Change iTop configuration file to make it writable :
chmod 644 conf/production/config-itop.php
Launch a Setup (using in your browser :
On step 2, keep “upgrade” radio selected.
Check that the database backup is selected
Click next on all following steps
Installing extensions or additional modules
The way to install a new extension, or an additional module (i.e. a module which was not selected during the previous installation) is quite similar to an upgrade:
Make sure that the iTop configuration file (
conf/production) is not read-only,
Point your web browser to
http(s)://location_of_itop/setupand follow the on-screen instructions.