Žilinská univerzita > Fakulta riadenia a informatiky > Katedra informačných sietí

Installing SIREMIS 3.2 the Kamailio web management interface, on debian (lenny) - how to

By day 14.12.2011 is Siremis v3.2.0 out. Siremis is the web management interface for Kamailio SIP Server. This is a major release, which is compatible with Kamailio v3.2.x. As we are using latest Kamailio 3.2 server we will do install and test latest Siremis GUI (however version 2.1 of siremis works with Kamailio 3.2). I follows official guide released on asipto web page.

Prerequisities

  • Installed Kamailio (OpenSER) 3.2 server.
  • Web server (e.g., Apache2) with mod_rewrite enabled
  • PHP5 with MySQL and GD support
  • siremis database with granted user access

The apache server have to have enabled mod_rewrite!!! Without mod_rewrite there is unable login, because you are redirected on a broken web link!!!

Installing apache web server with php5

apt-get install apache2 apache2-doc php5 php5-mysql php5-gd

Enable mod_rewrite for your apache. Enabling rewrite mode for my Apache 2 means add symlink from /etc/apache2/mods-available into /etc/apache2/mods-enabled. Alternativelly we enable rewrite mode with

 a2enmod rewrite

Without this we are not able to use siremis web after installation.

Download and install siremis 3.2.0

Go to your preferred donwload folder or your home folder and using wget download latest siremis from the http://siremis.asipto.com/pub/downloads/siremis/ site.

wget http://siremis.asipto.com/pub/downloads/siremis/siremis-3.2.0.tgz

Go to the www folder

cd /var/www

and extract siremis files here

tar xvfx /home/palo/siremis/siremis-3.2.0.tgz

new folder siremis-3.2.0 appear here.

Web server setup

First time Siremis web access setup

cd /etc/apache2/sites-available/

edit the apache default file

vim default 

and add lines with alias pointing to your siremis files located in /var/www/siremis-3.2.0/siremis

 Alias /siremis "/var/www/siremis-3.2.0/siremis"
    <Directory "/var/www/siremis-3.2.0/siremis">
        Options Indexes FollowSymLinks MultiViews
        DirectoryIndex index.php index.html
        AllowOverride All
        Order allow,deny
        Allow from all
        <Files "\.xml$">
                Order deny,allow
                Deny from all
        </Files>
        <Files ~ "\.inc$">
            Order allow,deny
            Deny from all
        </Files>
    </Directory>

 

Alternatively, move to your web root with siremis file

cd /var/www/siremis-3.2.0/

and run

pstest:/var/www/siremis-3.2.0# make apache-conf
# siremis apache conf snippet ...

        Alias /siremis "/var/www/siremis-3.2.0/siremis"
        <Directory "/var/www/siremis-3.2.0/siremis">
                Options Indexes FollowSymLinks MultiViews
                AllowOverride All
                Order allow,deny
                Allow from all
                <FilesMatch "\.xml$">
                        Order deny,allow
                        Deny from all
                </FilesMatch>
                <FilesMatch "\.inc$">
                        Order deny,allow
                        Deny from all
                </FilesMatch>
        </Directory>
 

Then copy and paste config to your default apacha config at

vim /etc/apache2/sites-available/default

Finally do not forget restart apache2 service

/etc/init.d/apache2 restart

Updating existing siremis file

If you have installed previous version of siremis (like 2.1), just modify existing apache config pointing to your new siremis install location. Do not forget drop previous siremis database.

 

Siremis local configuration

Go to the folder

cd /var/www/siremis-3.2.0/

and run make prepare

make prepare   
updating htaccess file...
updating app.inc file...
creating folders...
done

Make sure that following directories have write access for web server user:

  • siremis/log
  • siremis/session
  • siremis/files
  • siremis/themes/default/template/cpl

using for example

chown www-data:www-data -R *

Do not forget to restart the web server after doing the changes in its configuration file.

Creating siremis database

The installation of the siremis version 3.2 suppose that you have an user with granted privilege access.

mysql -p
mysql> GRANT ALL PRIVILEGES ON siremis.* TO siremis@localhost IDENTIFIED BY 'siremisrw';
Query OK, 0 rows affected (0.09 sec)

Siremis install

To install siremis we will use siremis Web wizard, so open preffered browser and point to

http://<your_IP>/siremis

URL is redirecting to the siremis installation wizard pages and we just need to follow steps described in http://kb.asipto.com/siremis:install32x:main. The initial web page should be loaded. Then follow installation steps. The most critical step is three, where we have to provide correct information required for database connection (either siremis and kamailio). The siremis database is for internal siremis use, the kamailio database is used by the Kamailio SIP server as persistant storage, for example for SIP localization.

Check in Import Default Data > box Because there is default admin account with defautl password.

That should be all!

We should be able login into siremis and work with siremis.

 Final notes

Do not forget to remove the install directory at siremis/install

Groups: