From i-doit documentation
Jump to: navigation, search

Frequently asked questions

This page details frequently asked questions (FAQ) and their corresponding frequently-given responses.

For further Questions feel free to ask in our Forum.


General Questions

What is i-doit?

i-doit is an IT documentation system based on ITIL guidelines. It documents IT systems and their changes, defines emergency plans, displays vital information, and helps to ensure a stable and effcient operation of IT networks. i-doit allows a rich amount of technical information to be filed for each element from a wall outlet to a mainframe in a structured way. Every employee can access this information easily (and in a selective way) through a Web browser. Due to its modular architecture, it is possible to deploy functionality add-ons or even develop extensions.

For further Information see http://www.i-doit.org.

How do I get the install files?

There are 2 possibilities. The first one is to simply download the already released files on our homepage [1]. The second one is to use a SVN client and connect to our SVN repository. There you can get our most recent version, although it won't be tested yet. So if you want to use i-doit or just test it choose the first one, if you are a developer choose the latter one.

How do I install i-doit?

See section Install.

How do I update i-doit?

See section Update.

I get a white page after installing!

The white page problem often occurs when the php/apache process is requested to write into the i-doit temp and cache directories. So you need to give him these rights:

cd /var/www/i-doit-directory
chmod +x idoit-rights.sh
./idoit-rights unset

idoit-rights usage:

-- i-doit v0.9.3 - http://www.i-doit.org --
--               -----                   --
--           Rights Manager              --
--               -----                   --
--  Note: You have to type in your root  --
--        password on first action       --
[*] usage: idoit-rights.sh set   - sets write permissions to the i-doit directory.
                                   this is usefull for updating with the automatic update procedure
                                   in http://your-ip/i-doit-path/updates/.
           idoit-rights.sh unset - removes these permissions and sets write permissions
                                   to the i-doit temp directories.

[*] Exiting..

The script idoit-rights.sh needs the tool "sudo" and is pre-configured for using the apache-user "www-data" by default. If your apache runs as another user you'll have to open the script and change the corresponding variables (APACHE_USER and APACHE_GROUP).

Beside this, a white page can also occur when theres a php syntax error anywhere and error_reporting is disabled. So you should always take a look at your apache/php error logs.

Where is your SVN repository?

Connect to http://dev.synetics.de/svn/idoit/trunk/ and use 'anon' as the username and leave the password field empty. That's it!
If you need help with the installation see our help page (Install), but generally it should be enough to just download the i-doit source, setting the rights with ./idoit-rights.sh unset on unix systems and going to its www-location to install the databases.

Are there known bugs?

Check out KnownBugs

How do I create new users using my database?

This manual is for mostly developers when there is a problem creating new users inside of i-doit. In any other case you can create new users in i-doit under 'Contacts'.

First connect yourself with the mandator database and see the structure of the table 'isys_person_intern':

| isys_person_intern__id          | int(10) unsigned |      | PRI | NULL    | auto_increment |
| isys_person_intern__title       | varchar(255)     | YES  |     | NULL    |                |
| isys_person_intern__description | text             | YES  |     | NULL    |                |
| isys_person_intern__user_pass   | varchar(255)     | YES  |     | NULL    |                |
| isys_person_intern__property    | int(10) unsigned | YES  |     | 0       |                |
| isys_person_intern__status      | int(10) unsigned | YES  |     | 1       |                |

The content of this table:

|                      1 | guest                     | NULL                            | 084e0343a0486ff05530df6c705c8bb4 |                            0 |                          1 |
|                     11 | reader                    | Reader                          | 1de9b0a30075ae8c303eb420c103c320 |                            0 |                          1 |
|                     12 | editor                    | Editor                          | 5aee9dbd2a188839105073571bee1b1f |                            0 |                          1 |
|                     13 | author                    | Author                          | 02bd92faa38aaa6cc0ea75e59937a1ef |                            0 |                          1 |
|                     14 | archivar                  | Archivar                        | 4baf8329be21a4ad4f4401295cc130a9 |                            0 |                          1 |
|                     15 | admin                     | Admin                           | 21232f297a57a5a743894a0e4a801fc3 |                            0 |                          1 |

To add new users create a new dataset in this table. 'isys_person_intern__title' defines the username and 'isys_person_intern__user_pass' is the password (as a MD5-Hash -> http://dev.mysql.com/doc/refman/5.0/en/security-guidelines.html):

INSERT INTO `isys_person_intern` (
`isys_person_intern__title` ,
`isys_person_intern__user_pass` ,
`isys_person_intern__last_name` ,
`isys_person_intern__first_name` ,
`isys_person_intern__status` ,
'username', MD5( 'password' ) , 'LastName', 'FirstName', '2', '0'

Now you have to connect this new user with a rights group in the table 'isys_group_2_isys_person_intern' in any case you want to login with that user:

INSERT INTO `isys_group_2_isys_person_intern` (
`isys_group_2_isys_person_intern__isys_person_intern__id` ,
`isys_group_2_isys_person_intern__isys_group__id` ,
`isys_group_2_isys_person_intern__status` ,
'21', '15', '2', '0'

Note that this is only an example, you have to look up the IDs for 'isys_person_intern__id' and 'isys_group__id' from your own database. In this case '15' would be the ID for the admin group.

Then you can log in with 'username' and 'password'. You can change the password in i-doit once you are logged in.

What are the minimum system requirements?

See SystemRequirements for that.

Personal tools