WIKI ITSM-NG

ITSM-NG installation

Prerequisites

To allow the installation of ITSM-NG, it is necessary to have a Linux or Windows server with the following services installed and configured :

Note on PHP : version 8.X is recommended as PHP 7.X is no longer supported by PHP.

See https://www.php.net/supported-versions.php for more information.

Here is the list of required PHP extensions for ITSM-NG :

The following PHP extensions are optional :

Download

Download the version of your choice at the following link : https://github.com/itsmng/itsm-ng/releases

However, we recommend using the latest version available.

Note : Dev and nightly versions will be available shortly for those wishing to test the latest features of ITSM-NG.

Pre installation

First step, connect to MySQL and create a database for ITSM-NG.

CREATE DATABASE itsmng;

Then, create a user and configure the appropriate rights.

CREATE USER 'itsmng'@'localhost' IDENTIFIED BY 'itsmng';
GRANT ALL PRIVILEGES ON itsmng.* TO itsmng@localhost;
FLUSH PRIVILEGES;

Next, uncompress the ITSM-NG release.

There are two ways to install ITSM-NG :

Web installation

Go to http://localhost/itsm-ng and follow the next steps.

Choose default language

Select the default language and click on OK.

Accept license

Accept the license and click on Continue.

Update or install

Click on Install to run the installation steps.

Note : please read the Update documentation to update from an old ITSM-NG version or to migrate GLPI to ITSM-NG.

Testing required librairies

Before configuration, a verification of the required libraries is carried out. If everything is OK, click on Continue otherwise install the missing libraries and click on Try again.

MySQL connection

Set the MySQL configuration and click on Continue.

MySQL database

Select the database and click on Continue.

Note : to create a new database from the interface, the MySQL user entered in the previous step must have the rights to create one.

MySQL database

After the database initialization, click on Continue.

MySQL database

Now, you can connect to ITSM-NG with the default user itsm/itsm.

Enjoy ITSM-NG 😃

Command line installation

Go to the ITSM-NG release folder.

Before installation, run the next command to check system requirements :

php bin/console itsmng:system:check_requirements

Result :

Requirement Status Messages
Testing PHP Parser OK
Sessions test OK
Allocated memory test OK
mysqli extension test OK
ctype extension test OK
fileinfo extension test OK
json extension test OK
mbstring extension test OK
iconv extension test OK
zlib extension test OK
curl extension test OK
gd extension test OK
simplexml extension test OK
intl extension test OK
ldap extension test WARNING ldap extension is not present
apcu extension test WARNING apcu extension is not present
Zend OPcache extension test OK
xmlrpc extension test WARNING xmlrpc extension is not present
exif extension test OK
sodium extension test OK
Testing DB engine version OK
Testing DB timezone data WARNING Access to timezone database (mysql) is not allowed.
Checking write permissions for log files OK
Checking write permissions for cache files OK
Checking write permissions for setting files OK
Checking write permissions for automatic actions files OK
Checking write permissions for document files OK
Checking write permissions for dump files OK
Checking write permissions for graphic files OK
Checking write permissions for lock files OK
Checking write permissions for pictures files OK
Checking write permissions for plugins document files OK
Checking write permissions for rss files OK
Checking write permissions for session files OK
Checking write permissions for temporary files OK
Checking write permissions for upload files OK

OK => Library installed

WARNING => Library not installed but optional

ERROR => Required library not installed

If no ERROR status, run the next command :

php bin/console itsmng:database:install -H DB_HOST -u DB_USER -p DB_PASSWORD -d DB_NAME

Result :

+---------------+------------+
| Database host | DB_HOST    |
| Database name | DB_NAME    |
| Database user | DB_USER    |
+---------------+------------+
Do you want to continue ? [Yes/no] yes
Installation done.

After the installation, you need to update the permission on the folder files :

sudo chown -R www-data: files

Now, you can connect to ITSM-NG at http://localhost/itsm-ng with the default user itsm/itsm.

Enjoy ITSM-NG 😃