Update#

When working with i-doit, you should always use the newest version. Minor releases always contain numerous bug fixes, while major releases add new features and improve already existing functionalities. Minor updates are released approximately every four weeks and major updates every six months. The update can be performed via the web interface of i-doit, as long as an internet connection is available (and where applicable, via HTTP-proxy). Alternatively the update can be prepared via console and then be continued in the web interface.

Update via the Web Interface#

The update can be accessed either through Administration → Systemtools → i-doit Update, the quicklaunch widget in the dashboard or through the URL http://i-doit-host/i-doit/?load=update.

Upon launching an interface appears in which the current status of the system is examined. We can see in our screenshot that the PHP-extension mcrypt has not been found. If such a status message is displayed, it is very important to adjust the system appropriately. For this you should look at our system requirements and system settings. After adjusting the environment, everything should be checked with a green mark or marked with an "OK".

In the next step, all available update packages are displayed. In our example i-doit version 1.6.1 is installed and can therefore only be updated to the same version. By clicking Check for a new version you can check whether a newer package is available. For this purpose, you require an internet connection.

When clicking "Check for a new version", the system checks for a higher version.

The update-package will be downloaded and extracted with a click on Download.

Now a new version is available for updating. The update can be started by clicking "Next". To see all notable changes for this package you can find a list under see changelog.

Usually, the boxes are checked like shown in the screenshot, so that both the system database and all associated mandator databases are selected for the update by default. If there is no reason not to update particular mandator databases, all selections should be kept.

Now at the very latest, a backup should be performed. As soon as there is a backup you can start the update by clicking the button Yes, I did a backup! - Start the update.

Each change may have effects on files and databases. If something goes wrong (typically because of missing writing permissions) a red "ERROR" appears. If a green "DONE" is displayed for each change, you can go on to the next step by clicking Next.

Depending on the update, existing data will be changed. The "Migration" step executes these changes and reports whether these changes were successful or not.

Following the so called "Property Migration", everything should be marked green again.

Now the update is completed. More detailed information about the update can be found in the linked log-file. You can return to i-doit by clicking Run i-doit v.. It is recommended to clear both the browser and the i-doit-cache under Administration → Systemtools → Cache / Database.

Update Prepared via the Console#

The update can be prepared, but not executed via the console. For the preparation, the latest update package has to be downloaded from the i-doit customer portal.

The update package can be stored on the server (for example, via WinSCP). Move the package to the main folder of i-doit afterwards, if you didn't already put it there. This can be carried out by using the following command:

1

mv idoit-1.2.3-update.zip /var/www/html/i-doit/

Then the package needs to be extracted and all existing files need to be overwritten.

1
2

cd /var/www/html/i-doit
unzip idoit-1.2.3-update.zip # enter "A" to override all files

Now the file permissions are being adjusted in order to give the Webserver both reading access as well as writing access to i-doit.

1
2
3
4
5

cd /var/www/html/i-doit/
sudo chown www-data:www-data -R .
sudo find . -type d -name \* -exec chmod 775 {} \;
sudo find . -type f -exec chmod 664 {} \;
sudo chmod 774 controller *.sh setup/*.sh

Now you can have a look at our instructions for the update via the web interface and skip the steps regarding the download of the newest package.