i-doit possesses a command line tool called controller.
Since version 1.10 the controller is marked as outdated and will be removed in one of the next releases. The console is the alternative choice.
In order to avoid errors it is important to execute the controller with the same user who uses the web server. In the example this is
www-data. It's also important to change to the main folder of i-doit prior to executing the controller:
This script has to be executed in a slightly different manner in Windows operating systems since they cannot handle the bash script of the controller:
Client and Credentials
To use the controller, an authentication for i-doit is needed. For this a username (
-u), password (
-p) and the unique ID of the client to be used (
-i) are required.
The user "controller"
Personswith the desired credentials in the
Persons → Logincategory. This user should receive administrator rights. This can be achieved by an assignment to the predefined
Person group Admin.
In order to find out which unique ID belongs to a specific client, the following command can be used:
The ID is generally 1 for i-doit installations with just one client.
The controller is capable of performing various actions. These in turn are represented by the handler. To call up a specific handler the parameter
-m is required.
List of Handlers
|Handler||pro version||open version||Add-on||Description|
Synchronize the distinguished name (DN) of users from a LDAP/AD (see
|yes||yes||–||Archive logbook entries|
|yes||yes||–||Clean up the authorization system|
|yes||yes||–||Clean up objects|
|yes||–||–||Import data from a|
|–||–||Create a new revision of a document|
|yes||yes||–||Import h-inventory XMLor|
|yes||yes||–||Export configuration for ISC DHCPD|
|yes||yes||–||Import files from|
|yes||yes||–||Activate a discovery job at|
|yes||yes||–||Import data from a|
|–||–||Send e-mails with planned maintenance works|
|yes||yes||–||Export Nagios configuration|
|yes||yes||–||Send notifications per e-mail|
|yes||yes||–||Import data from OCS Inventory NG|
|yes||yes||–||Recreate object relations|
|yes||–||–||Export a report as file|
Search in i-doit or create/renew search index
|yes||yes||–||Import data from Syslog in i-doit logbook|
|yes||yes||–||List, activate and deactivate tenants|
|yes||yes||–||Search for updates in i-doit|
|yes||yes||–||Send Workflow notifications per e-mail|
Configuration of Handlers
Set Additional Parameters
Some handlers require further options which can be given directly to the controller via specific parameters. To see which parameters these are, click on the links in the handler list.
Adjust the Configuration File
For some handlers a respective configuration file exists. Examples can be found beneath the main folder of i-doit in
src/handler/config/examples/. In order for a configuration file to be in effect, it has to be available in the