siremis:install32x:main
no way to compare when less than two revisions

Differences

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


siremis:install32x:main [2012/06/07 12:24] (current) – created - external edit 127.0.0.1
Line 1: Line 1:
 +====== Siremis v3.2.x - Installation ======
  
 +<code>
 +Author:
 +    Elena-Ramona Modroiu
 +</code>
 +
 +===== Requirements =====
 +
 +  * [[http://www.kamailio.org|Kamailio (OpenSER) 3.2.x]] installed
 +    * one option to install it is to use GIT repository, tutorial available at:
 +      * [[http://www.kamailio.org/wiki/install/3.2.x/git]]
 +  * Web server (e.g., Apache) with mod_rewrite enabled
 +    * on Debian Ubuntu, you can do:
 +<code>
 +apt-get install apache2
 +a2enmod rewrite
 +</code>
 +  * PHP5 with MySQL and GD support
 +    * on Debian Ubuntu, you can do:
 +<code>
 +apt-get install php5 php5-mysql php5-gd
 +</code>
 +
 +===== Download =====
 +
 +Latest version of SIREMIS 3.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):
 +
 +<code>
 +cd /var/www
 +tar xvfz siremis-x.y.z.tgz
 +cd siremis-x.y.z
 +</code>
 +
 +You have to replace x.y.z with version number for Siremis (for example, fo Siremis v3.2.0, replace x.y.z with 3.2.0).
 +
 +===== Web Server Setup =====
 +
 +If you want to setup an alias for Apache 2.x, you can run:
 +
 +<code>
 +make apache-conf
 +</code>
 +
 +and you get the config snippet printed in the terminal -- it should look like (of course, x.y.x is replaced by version number):
 +
 +<code>
 +siremis-x.y.z# make apache-conf
 +# siremis apache conf snippet ...
 +
 + Alias /siremis "/var/www/siremis-x.y.x/siremis"
 + <Directory "/var/www/siremis-x.y.x/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 what was printed in the terminal into Apache conf file, inside VirtualHost settings.
 +
 +For Apache2 on Debian/Ubuntu, the config file is:
 +
 +<code>
 +/etc/apache2/sites-available/default
 +</code>
 +
 +After restarting the web server, SIREMIS will be 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-x.y.z# 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
 +
 +On Debian/Ubuntu you can do:
 +
 +<code>
 +siremis-x.y.z# make chown
 +</code>
 +
 +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>
 +
 +You can run above SQL statement via **mysql** command line tool, connecting to MySQL server as user **root**.
 +
 +This MySQL 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, 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 ====
 +
 +After first login, do not forget to update the password for user admin.
 +
 +{{ http://kb.asipto.com/images/siremis-3.2/siremis-3.2-login.png }}
 +
 +
 +===== 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
 +
 +===== Start Using Siremis =====
 +
 +  * once you are logged in, the management of Kamailio is done from the **SER Menu** pannel, the link to access it is in upper right corner
 +  * first to do is to add your SIP server domain, under **Server Services => Domain List**. If you have a single domain Kamailio installation, with no checks of domain part inside the SIP server, you can simply introduce **127.0.0.1** as your domain
 +  * then you can start the management of records used by Kamailio SIP Server
 +    * add subscribers via **Subscriber Services => Subscriber List**
 +    * manage records for routing services (dispatcher/load balancing, least cost routing, ...) from **Routing Services => ...**
 +    * ...
 +
 +===== Siremis Components =====
 +
 +These are special Siremis components that need further configuration in order to work:
 +
 +  * [[siremis:install32x:accounting|Install Accounting Services]]
 +  * [[siremis:install32x:mi-commands|Install MI Commands Panel]]
 +  * [[siremis:install32x:xmlrpc-commands|Install XMLRPC Commands Panel]]
 +  * [[siremis:install32x:charts|Install Charts Services]]
 +  * [[siremis:install32x:new-views|Adding New Views To Siremis]]
 +  * [[siremis:install32x:public-registration|Enable Public Registration]]
 +
 +===== 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}}

100%


Copyright 2010-2020 Asipto.com