Upgrading iTop
Release notes
Why upgrading? What features are brought by new versions:
Migrations Notes
Before upgrading your instance of iTop to a new version, read the corresponding migration notes to determine the impact of the upgrade:
How to upgrade
Before you upgrade, check that the extensions (if any) that you installed on your previous version of iTop are compatible with the new version. The extensions are located in the “extensions” folder in the iTop installation folder. Information about the compatibility of each extension can be found in its documentation. Unless otherwise specified, extensions are supposed to be forward compatible.
The upgrade process is simple:
-
Extract the content of the “web” directory of the iTop archive into a new directory on your web server,
-
Copy the extensions from the previous “extensions” folder to the “extensions” folder of the new location. If needed upgrade the extensions to a version compatible with the new iTop.
-
Point your web browser to the location where you extracted the files and follow the on-screen instructions,
-
At step 2, select “Upgrade an existing instance”. If you specify the path to the previous installation, the setup program will do two things:
-
copy all your parameters to the new installation
-
if any extension is found in the “extensions” folder, the setup will offer to copy them to the new location for you
-
Finally, if you used the file cron.params in the
webservices directory to store the settings for
cron.php, copy this file to the new
webservices folder.
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 (
config-itop.phpinconf/production) is not read-only, -
Point your web browser to
http(s)://location_of_itop/setupand follow the on-screen instructions.