i-doit Virtual Eval Appliance#
synetics provides a fully functional appliance of i-doit. It can be downloaded as a virtual machine.
Thanks to the virtual appliance the features of i-doit can be evaluated as fast as possible. You neither need knowledge of the LAMP Stack nor do you have to install the software. Instead you can start immediately with a basic framework.
For testing only
The appliance is intended for testing only and should not be used in production.
Download#
The appliance is available for download free of charge during the evaluation process. In order to request a valid trial license the form "On Premise" on the i-doit website needs to be used.
Start#
The download comes as a normal ZIP file which has to be extracted after downloading. It contains an OVF file, which can be imported into popular virtualization environments.
When importing, settings may be requested (name, CPU cores, memory). The presets can be taken over without problems. If they are changed, however, it is also probable that the settings of MariaDB and PHP have to be adjusted too. It's also important to meet the system requirements.
Operating System
The installed operating system is Debian GNU/Linux 11 "buster" as 64-bit version. If the virtualizer doesn't recognize this automatically, it is essential to enter this information manually. Otherwise it is possible that problems arise when starting and executing the VM.
Start of i-doit#
During the first start, the VM tries to obtain an IP address via DHCP and shows it on the console. When you activate the IP address in the browser, the i-doit Web GUI starts to load.
You can configure the IP address via the console (see below).
Credentials#
| Tool | Username | Password |
|---|---|---|
| i-doit Web GUI | admin | admin |
| i-doit Web GUI | controller | controller |
| i-doit Admin-Center | admin | idoit |
| SSH | idoitadm | idoit |
| MySQL (i-doit) | idoit | idoit |
| MySQL (Systemuser) | root | idoit |
Additionally, there are some pre-defined persons and person groups in i-doit.
Configuration#
The configuration of the appliance can be carried out via the console. After logging in via SSH a menu appears:
| Shortcut | Menu item | Function |
|---|---|---|
| 1 | Configure networking | Set network connection; the network configuration is set to DHCP by default. |
| 2 | Proxy configuration | Set HTTP proxy for the system |
| 3 | E-Mail configuration | E-mail settings |
| 4 | Timezone | Set the time zone |
| 5 | Keyboard layout | Keyboard layout; de is set as default |
| 6 | Change idoitadm user password | Change the password of the User idoitadm |
| 7 | i-doit scripting configuration | Change settings for CLI, cronjobs, backup and restore |
| 8 | Reboot system | Reboot system |
| 9 | Shutdown system | System shutdown |
| 0 | Launch shell | Open the shell for further action |
| A | Logout | Log out the user idoitadm off the system |
Scripts and Cronjobs#
The appliance is equipped with various scripts and cronjobs.
| Script | Purpose |
|---|---|
| idoit | i-doit CLI |
| idoit-backup | Run backup manually |
| idoit-restore | Restore |
| idoit-jobs | Run cronjobs manually |
The scripts are located at /usr/local/bin/.
Pre-configured cronjobs, which optimize the system regularly, exist at /etc/cron.d/i-doit.
Every night the files of i-doit are saved locally. The storage period is one week.
Directories#
The following overview shows you the purpose of the directories:
| Directory | Purpose |
|---|---|
| /var/www/html/ | Installation directory of i-doit |
| /etc/apache2/ | Configuration of the Apache web server |
| /etc/php/7.0/ | Configuration of PHP |
| /etc/mysql/ | Configuration of MariaDB |
| /var/log/apache2/ | Logs of the Apache web server |
| /var/backups/i-doit | Backups |
Follow-up#
The appliance provides a "naked" installation of i-doit. This means that neither demo files nor additional add-ons are included.
When logging in the first time, i-doit requests a valid license which needs to be activated in order to have all features available.
Further information for first steps with i-doit are also described in the knowledge base under Basics.
Troubleshooting#
Connection refused
If the following error message is shown when running i-doit
1 | |
then the MySQL service probably didn't start. In most cases this is related to changes in the virtual hardware of the appliance without adjusting the configurations. The settings need to be either reset to the default values following a restart of the machine or the configuration at /etc/mysql/mariadb.conf.d/99-i-doit.cnf needs to be adjusted so that the hardware suffices and the MySQL service can be started again using systemctl start mysql.
VM doesn't start
If the VM doesn't start, insufficient or incompatible settings of the virtualizer could be the reason. Common virtualizers often supply helpful hints. For example, it is important to specify the correct operating system in the correct version: Debian GNU/Linux 64-bit.
Unsupported hardware family
If the applied VMware environment is not up to date, the error message line 25 unsupported hardware family 'vmx-10'is displayed during import. To enable the import you have to edit the file i-doit Eval Appliance 1.2.x i-doit 1.x.x.ovf . In the line
1 | |
you have to select a lower version. The value vmx-9 is suitable for ESXi 5.1:
1 | |
After saving, you have to update the hash value (SHA1) of the modified file in the file i-doit Eval Appliance 1.x.x i-doit 1.x.x.mf You can use the sha1sum command under GNU/Linux:
1 | |
VSphere < 6.5.0
Our virtual appliance is encrypted with a SHA265 hash for security reasons.
Unfortunately, vSphere only supports this at version 6.5.0.
Here you can find the official entry from VMware.
It also describes how you can work with virtual machines that use a SHA265 hash in versions prior to vSphere version 6.5.0.