siremis:install20:main

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

siremis:install20:main [2010/11/01 14:48] (current)
Line 1: Line 1:
 +====== Siremis v2.0 - Installation ======
  
 +<​code>​
 +Author:
 +    Elena-Ramona Modroiu
 +</​code>​
 +
 +===== Requirements =====
 +
 +  * [[http://​www.kamailio.org|Kamailio (OpenSER) 3.1.0]] installed.
 +  * Web server (e.g., Apache) with mod_rewrite enabled
 +  * PHP5 with MySQL and GD support
 +
 +===== Download =====
 +
 +Latest version of SIREMIS 2.x is available at:
 +
 +  * http://​siremis.asipto.com/​pub/​downloads/​siremis/​
 +  * it includes everything, so you do not need to download something extra
 +
 +Untar the archive on the local file system (e.g., in your web server root folder):
 +
 +  * cd /var/www
 +  * tar xvfz siremis-x.y.z.tgz
 +
 +===== Web Server Setup =====
 +
 +If you want to setup an alias for Apache 2.x, you can run 'make apache-conf'​ and you get the config snippet printed:
 +
 +<​code>​
 +siremis-2.0#​ make apache-conf
 +# siremis apache conf snippet ...
 +
 + Alias /siremis "/​var/​www/​siremis-2.0/​siremis"​
 + <​Directory "/​var/​www/​siremis-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>​
 +</​code>​
 +
 +You can copy&​paste it to Apache conf file (e.g., for Apache2 on Debian/​Ubuntu:​ /​etc/​apache2/​sites-available/​default).
 +
 +This will make SIREMIS available under http://​yourwebserver.com/​siremis/​. If you want to use a different alias, edit Makefile and change the value of URLBASE
 +
 +===== Local Configuration =====
 +
 +Next step is to create .htaccess and Siremis configuration files, you have to run 'make prepare':​
 +
 +<​code>​
 +siremis-2.0#​ make prepare
 +updating htaccess file...
 +updating app.inc file...
 +done
 +</​code>​
 +
 +Make sure that following directories have write access for web server user:
 +  * siremis/log
 +  * siremis/​session
 +  * siremis/​files
 +  * siremis/​themes/​default/​template/​cpl
 +
 +
 +Do not forget to restart the web server after doing the changes in its configuration file.
 +
 +===== Database Configuration =====
 +
 +Database server to be used is MySQL.
 +
 +You have to create a MySQL user that has access to Siremis database, for example:
 +
 +<​code>​
 +GRANT ALL PRIVILEGES ON siremis.* TO siremis@localhost IDENTIFIED BY '​siremisrw';​
 +</​code>​
 +
 +This user will be needed later during the installation,​ of course, you can use an existing MySQL user that has enough privileges.
 +
 +Also, you have to create Kamailio database with kamdbctl tool, if you don't have it already:
 +
 +<​code>​
 +kamdbctl create
 +</​code>​
 +
 +You don't need to do anything else to setup the database of Siremis 2.0, the rest of the process is down via web installation wizard.
 +
 +===== Web Installation Wizard =====
 +
 +Once you have done the steps above, access the web page:
 +  * http://​yourwebserver.com/​siremis/​
 +
 +When you do it first time, you are redirected to an installation wizard. Follow the steps.
 +
 +==== First Page ====
 +
 +You get a page to start the setup process.
 +
 +{{ http://​kb.asipto.com/​images/​siremis-2.0/​siremis20-install01.png?​700 }}
 +
 +==== Step 1 ====
 +
 +First step shows the status of required items. You have to update local configuration until all the items are checked ok.
 +
 +{{ http://​kb.asipto.com/​images/​siremis-2.0/​siremis20-install02.png?​700 }}
 +
 +==== Step 2 ====
 +
 +In the second step you have to introduce the details to access Kamailio and Siremis database.
 +
 +When you install Siremis first time, you probably have to check:
 +
 +  * Create Siremis Database - this create database '​siremis'​
 +  * Import Default Data - this imports initial data into database '​siremis'​
 +  * Update SIP Database - this updates the structure of Kamailio database for accounting and charts modules
 +  * Replace DB Config - this updates Siremis configuration file with the details to access databases
 +
 +{{ http://​kb.asipto.com/​images/​siremis-2.0/​siremis20-install03.png?​700 }}
 +
 +==== Step 3 ====
 +
 +This page presents a status report of installation,​ showing whether the required directories have writable access and summary of database access details.
 +
 +{{ http://​kb.asipto.com/​images/​siremis-2.0/​siremis20-install04.png?​700 }}
 +
 +==== Step 4 ====
 +
 +This is the end of installation,​ presenting the username and password to login to Siremis. This page is automatically redirected to login page after a short period of time.
 +
 +{{ http://​kb.asipto.com/​images/​siremis-2.0/​siremis20-install05.png?​700 }}
 +
 +==== Login Page ====
 +
 +The login page has a protection for blocking login bots, asking to enter a code printed in an image.
 +
 +After first login, do not forget to update the password for user admin.
 +
 +{{ http://​kb.asipto.com/​images/​siremis-2.0/​siremis20-install06.png?​700 }}
 +
 +
 +===== Post Installation =====
 +
 +  * remove the install directory: siremis/​install
 +
 +If you want to run again installation wizard:
 +  * restore directory: siremis/​install
 +  * remove file: siremis/​install.lock
 +
 +===== Siremis Components =====
 +
 +These are special Siremis components that need further configuration in order to work:
 +
 +  * [[siremis:​install20:​accounting|Install Accounting Services]]
 +  * [[siremis:​install20:​mi-commands|Install MI Commands Panel]]
 +  * [[siremis:​install20:​charts|Install Charts Services]]
 +
 +===== Security Considerations =====
 +
 +Siremis is an administration tool, it is recommended to:
 +
 +  * run it in a private network
 +  * run it over HTTPS
 +  * add extra protection at HTTP server or firewall layers (e.g., HTTP auth, IP restrictions,​ etc)
 +
 +{{tag>​siremis kamailio}}


Copyright 2010-2019 Asipto.com