Installation

Go back to Integria IMS Documentation Index

Integria IMS is an application that needs a MySQL database to work. It supports MySQL or Percona DB. It needs PHP 7.x. version Since it is a full WEB application, you may install it on a server and access it from any workstation with a modern browser that supports HTML5 such as Chrome, Firefox, Edge or Safari.

The minimum working resolution 1280 by 720 pixels. Our officially supported platform is CentOS Linux version 7.x (with PHP 7.3 packages from the Remi Collet repository).

It can be installed in a shared database, although depending on its use, performance can be affected by the capacity of said database, particularly if you want to keep data with a lot of history, e.g.: tickets from a couple years.

From any CentOS 7 system connected to the Internet (AWS®, Google Cloud®, Azure®, DigitalOcean®, a VPS provider or virtual or physical machines) you may perform an automatic installation of Integria IMS just by executing the following command as root (super user):

curl -Ls https://pfms.me/deploy-integria | sh

For EL 8 (RHEL 8, Rocky Linux 8, AlmaLinux 8):

curl -Ls https://pfms.me/deploy-integria-el8 | sh

Once installed, follow the instructions on the screen and log into the administration console for the first time. Continue reading later, in the section “Connecting to Integria IMS for the first time” at the end of the chapter.

This ISO image can be burned to a physical DVD or to a USB. It can be used indifferently on a dedicated physical system or on a virtual machine.

The CD installation itself uses the Redhat (Anaconda) installation system which allows graphical or text installation. The CD includes all the necessary software and an Internet connection is not necessary.

This screen appears at startup.

Click ENTER to install Integria IMS.

Choose a language and click continue:

Set your system date/time as well as a keyboard configuration.

Finally, choose the disk where you are going to install your system and click Begin installation .

While installing you will have the opportunity to create the root account (super user) of the system, in case you need it in the future:

Click Root password to set it.

Once installed, it will display a screen similar to this one:

From a web browser point to that URL and enter Integria IMS Console. Keep reading later, in section “Connecting to Integria IMS for the first time” at the end of the chapter.

If you are unfamiliar with Linux you should probably go for the above installation options. This documentation refers to CentOS 7, the officially supported version.

yum install -y yum-utils
yum install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
yum install -y https://rpms.remirepo.net/enterprise/remi-release-7.rpm
yum install -y https://repo.percona.com/yum/percona-release-latest.noarch.rpm
yum-config-manager --enable remi-php73

yum install -y Percona-Server-server-57
yum install -y wget httpd php php-mcrypt php-cli php-mysqli \
php-gd php-imap php-common php-mbstring php-curl \
php-ldap php-zip curl php-intl sudo vim

Set php.ini:

sed -i -e "s/^max_input_time.*/max_input_time = -1/g" /etc/php.ini
sed -i -e "s/^max_execution_time.*/max_execution_time = 0/g" /etc/php.ini
sed -i -e "s/^upload_max_filesize.*/upload_max_filesize = 800M/g" /etc/php.ini
sed -i -e "s/^memory_limit.*/memory_limit = 500M/g" /etc/php.ini
sed -i -e "s/^post_max_size.*/post_max_size = 500M/g" /etc/php.ini

systemctl start mysqld
systemctl enable mysqld
service httpd start
systemctl enable httpd

Edit the file /etc/my.cnf and enter the following line within the section [mysqld] :

sql_mode = ""
bind-address=127.0.0.1

service firewalld stop
systemctl disable firewalld
setenforce 0
sed -i -e "s/^SELINUX=.*/SELINUX=disabled/g" /etc/selinux/config

yum install -f http://firefly.artica.es/KkGqio0L4jV0nfnThj6774eg1rZJQd1Y/IntegriaIMS_enterprise-latest.noarch.rpm
chmod -R g+w /var/www/html/integria/

curl -sL https://rpm.nodesource.com/setup_12.x | sh
yum install -y nodejs
npm i -g pm2
cd /var/www/html/integria/extras/chat_server
npm update
pm2 start server.js

Set the Percona DB root password:

mysqladmin password <your-password>

Take note of this password, you will need it later.

Using a web browser, point to the IP address of the machine where you installed Integria IMS and follow the instructions of the graphical installer. This step is skipped if you have installed Integria using ISO or cloud installation. For example, if your IP address is 192.168.70.91 enter this URL in your browser:

http://192.168.70.91/integria/

You should see a screen like this one:

Click Next, accept the license, click Next again:

On this screen, you should see all the checks in green:

Click NEXT:

On this screen you will need to enter the password that you used for the Percona DB root user in one of the previous steps. Click Next:

After completing this step, you are ready to use Integria IMS. Congratulations .

A screen will appear to accept the license:

And then a screen to log in (loginscreen):

The first time it will warn you that the newly installed system uses some demo data to guide you on first use.

We recommend that if you are testing Integria IMS you take a walk through the different options to see screens with real data and reports before deleting the existing data.

The system incorporates an option: configuration to restart or reset data and leave the system almost empty. To do this, go to settings (gear icon):

And then click on the database data management tab (the recycle symbol)

Click the option below to reset all data (Reset all data):

Go back to Integria IMS Documentation Index