2. General Installation

Windows Installation

Simply follow the assistant that appears when using the install program executable. This carries everything needed to have Integria installed when the assistant finishes.

After starting the installation, the first step is to select the installation language:

Next, we'll progress along the install wizard: To ensure that everything works correctly, we recommend the default installation with Apache, MySQL y PHP for Apache.

Starting point for the Apache installation.

We leave all values as default.

Last step of the Apache installation.

End of the Integria install process.

Once this is done, simply open a browser and navigate to the following URL:

http://servername/integria

After accepting the license agreement enter the Enterprise license number. Integria IMS is successfully installed and ready to run!

In order to access Integria, use the default credentials:

User: admin
Password: integria

Source Installation

Prior necessary software installations

A 'TAR' tool is a minimum requirement in order to decompress the “tarball” installation package. Don't forget to install Subversion, and of course comply with all the install requirements mentioned above.

Source download

Download the “tarball” for the latest version of Integria IMS, by one of two ways: the first is to download the '.tar.gz' format file of the latest version on Sourceforge; the second is to download the development version using the Subversion client (svn), using the command line:

svn co https://integria.svn.sourceforge.net/svnroot/integria integria

It is convenient that this command be executed in the web publishing directory directly (/srv/www/htdocs/ para Suse o /var/www/ para Ubuntu/Debian) because the uncompressed version will be downloaded into said folder, and we can continue the installation from there.

Installation

Once we have the installation “tarball” placed, for example, in /tmp, we make a root user for ourselves:

su -

And move on to the web publishing directory (/srv/www/htdocs/ para Suse o /var/www/ para Ubuntu/Debian) to decompress the package:

cd /var/www/
tar xvzf /tmp/IntegriaIMS-xxx.tar.gz

Change the permissions so that the directory is owned by the web server user: For example, on Debian systems:

chown -R www-data /var/www/integria

Now access the server's IP address via web in order to proceeed with Integria IMS' installation. This part of the installation is useful for creating Integria's database and configuring access credentials (user, password and DB name) for the DBs established by the user. :

http://ip_servidor/integria/install.php
http://ip_servidor/integria/trunk/install.php (si se ha optado por descargar 
usando svn)

Follow the installation steps as prompted:

Press next, accept the license agreement and press next again:

On this screen all necessary dependencies will be checked to verify their correct installation:

Configure our MySQL access credentials, so the installer can create a new Integria database:

You've now completed the installation process:

Once all steps have been completed, you have successfully completed Integria IMS's installation, and can now access the system. Remember that the credentials (user and password) that are set by default are admin and integria.

http://ip_servidor/integria/index.php

Appliance CD install

This CD contains a modified version of CentOS, with Integria IMS pre-installed along with all its dependencies, preconfigured and ready to install alongside the operating system on a device (virtual or physical). Due to the extent of this documentation (there are many screencaps), we've dedicated a chapter to the CD install of Integria IMS.

VM install using VMWare

Apart from distributing the CentOS ISO, you can get a virtual image which already has the Integria IMS ISO installed available on SourceForge. This image has been tested on VMWare, ESX, VMWare Workstation, Virtualbox and Hyper-V (in order for it to work on Hyper-V it's necessary to export the .vmdx file to .vdh using the MVDC.exe executable file, available after installing the Microsoft Virtual Machine Converter). For the installation you only need to execute the .ovf file for Virtualbox and VMWare Workstation. For ESX and Hyper-V we will have to “Import VM” and select the image. The credentials for this machine image are:

User: root

password: integria

Console User: admin

Password: integria

MySQL user: root

Password: integria

Installing on a WEB hosting environment

The default installation for Integria is supposed to have the root account in order to create the Integria database and perform the automated installation. In this section we detail how to perform a manual install, which involves, for example, being performed on a WEB hosting environment (where root credentials for MySQL are unavailable).

  • NOTE: Some hosting environments don't have the IMAP PHP module compiled, which is necessary for instance management via email.

In the first place, you'll need to obtain the “tarball” and decompress it onto a temporary directory, for example:

tar xzf integria_xxxx.tar.gz

This'll create a new directory named “trunk” on the current directory. It moves over to your web publishing directory on a new directory, for example “Integria”:

mv trunk /srv/www/htdocs/integria

Your hosting environment must have a complete installation of PHP 5.x (this includes some addons such as gettext, json, MySQL, LDAP, mbstring and zlib). Graphviz is also necessary for “tree” style graphs. It's necessary to create the database with the mechanism that your hosting provides. After that you'll have a database host, username, password, and name. Import these two files (in this order)into your new database:

integria_db.sql
integria_dbdata.sql

This could be done using the CLI command line in MySQL:

mysql -u user -p -D databasename -h hostname
<It will ask your password>
mysql> use pandora;
mysql> source integria_db.sql;
mysql> source integria_dbdata.sql;

After that, you'll need to edit the file “include / config.inc.php”, adding these lines along with the values set in your configuration:

$config["dbname"] = "integria";         // MySQL DataBase name
$config["dbuser"] = "integria";
$config["dbpass"] = "integria"; // DB Password
$config["dbhost"] = "localhost"; // DB Host
$config["homedir"] = " /srv/www/htdocs/integria/";      // Config homedir
$config["base_url"] = "http://mydomain.net/integria";    // Public URL

Save the file or change the name to “include / config.php” y dele permisos de sólo lectura a la aplicación web (normalmente apache o http). Delete install.php and proceed to entering Integria

http://youraddress/integria

Package installation

First, we'll need to obtain the Integria installation packages, which can be downloaded from Sourceforge. You'll have to download the appropriate package format for your OS distribution, whether that be .deb for Debian/Ubuntu or .rpm for Suse/Red Hat Enterprise Linux/Fedora/CentOS.

Installing Intregria IMS using the .DEB package

Installing Integria by using the .deb package is easy: you'll simply need to run (as root user) the following command:

dpkg -i IntegriaIMS_xxx.deb

If you don't have an internet connection available and some dependencies were left unfinished, it will be necessary to download the dependencies, after installing the package. If you do have an internet connection and there is still an unsolved dependency, execute:

apt-get -f install

This command will attempt to download any missing necessary packages to install Integria on our system. Once all necessary dependencies have been installed, you can install the Integria package. After the package has been installed a message like this should appear on your command line:

Please, now, point your browser to http://your_ip_address/integria/install.php and follow all the steps described on it

From here on, follow the same steps you saw during the web source installation, where you configure our MySQL credentials to create Integria IMS' database.

Integria IMS .RPM package installation

For CentOS, Redhat, SUSE, OpenSUSE and any distributions that use .rpm packages. Once the package is downloaded, perform Integria's installation as root user:

rpm -i IntegriaIMS-xxx.noarch.rpm

Just like with the .deb package installation, dependencies that are not met must be solved when attempting to install the package. When the package installation on the command line finishes, you'll be warned that this process must continue on a browser. Follow the same steps as the web installation to create the database on which Integria IMS will rely.

Enterprise edition installation

Once we have the compressed file with Integria's Enterprise part, for example: IntegriaIMS enterprise_xxx.targ.gz, we have to proceed in a similar way to source installing. For this, we decompress the “tarball”:

su -
cd /tmp
tar xvzf IntegriaIMS_enterprise_xxx.tar.gz

Once decompressed, it'll create a folder named Enterprise, which we'll move into the Integria folder located in the publishing directory. For Debian/Ubuntu:

mv /tmp/enterprise /var/www/integria/

For Suse:

mv /tmp/enterprise /srv/www/htdocs/integria/

Afterward we'll need to change the permissions on the enterprise directory, so that said directory is owned by the web server user. For Debian/Ubuntu:

chown -R www-data /var/www/integria/enterprise

For Suse:

chown -R wwwrun /srv/www/htdocs/integria/enterprise

The last step will be to open a browser and type:

http://ip_servidor/integria/

Accept the license and with this we'd have Integria IMS already installed in its enterprise edition.

Maintenance script installation

Integria sends all email and performs certain “automatic” tasks in a programmed way. To do this it's necessary to automate a process for it to be executed every 5 minutes. If this isn't done, some important Integria tasks (such as sending emails) won't work. If the package has been installed from a .DEB or .RPM package, this script is already on your system and you may skip this section. If you've installed it from tarball or sources, you'll have to do this manually.

On Unix this can be done by adding a task to Cron, as follows: On Unix systems As root user, create a new file named /etc/cron.d/integria

# Execute Integria CRON each 5 minutes.
5,10,15,20,25,30,35,40,45,50,55,59 * * * *     root  php5 
/srv/www/htdocs/integria/include/integria_cron.php

If you've installed Integria on another directory, for example, on Ubuntu, the route is completely different, for example:

# Execute Integria CRON each 5 minutes.
5,10,15,20,25,30,35,40,45,50,55,59 * * * *     root  php5 
/var/www/integria/include/integria_cron.php

Before continuing please check that it works by, as a root user, executing the following command from the command line, for example:

php5 /srv/www/htdocs/integria/include/integria_cron.php

The script shouldn't return anything. On your system your PHP interpreter may not be called 'php5' and may be simply 'php'. Check this if you run into any problems and substitute 'php5' for 'php' on all the commands indicated previously.

On Windows systems

If you use Windows XP or 2000, you'll have to search the command SCHTASKS from Windows 2003 or newer, to be able to program a call to a command every 5 minutes. You can download it from Microsoft here:

http://www.microsoft.com/resources/documentation/windows/xp/all/proddocs/en-us/schtasks.mspx?mfr=true

An entry should be added to the task manager like so:

schtasks /create /SC minute /MO 5 /TN Integria /TR "\"C:\Program Files 
(x86)\IntegriaIMS\php\php-cgi.exe\" \"C:\Program Files 
(x86)\IntegriaIMS\Apache\htdocs\integria\include\integria_cron.php\"" 
/RU system

If you use Wamp it would be:

SCHTASKS /create /SC minute /MO 5 /TN Integria /TR 
"C:\wamp\bin\php\php5.3.5\php-cgi.exe 
c:\wamp\www\integria\include\integria_cron.php" /RU system

(Directories can change depending on their WAMP version) This uses the task manager to execute the integria_cron.php PHP file every five minutes.


Integria Documentation