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 ====== | ||
+ | < | ||
+ | Author: | ||
+ | Elena-Ramona Modroiu | ||
+ | </ | ||
+ | |||
+ | ===== Requirements ===== | ||
+ | |||
+ | * [[http:// | ||
+ | * one option to install it is to use GIT repository, tutorial available at: | ||
+ | * [[http:// | ||
+ | * Web server (e.g., Apache) with mod_rewrite enabled | ||
+ | * on Debian Ubuntu, you can do: | ||
+ | < | ||
+ | apt-get install apache2 | ||
+ | a2enmod rewrite | ||
+ | </ | ||
+ | * PHP5 with MySQL and GD support | ||
+ | * on Debian Ubuntu, you can do: | ||
+ | < | ||
+ | apt-get install php5 php5-mysql php5-gd | ||
+ | </ | ||
+ | |||
+ | ===== Download ===== | ||
+ | |||
+ | Latest version of SIREMIS 3.2.x is available at: | ||
+ | |||
+ | * http:// | ||
+ | * 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 | ||
+ | cd siremis-x.y.z | ||
+ | </ | ||
+ | |||
+ | 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: | ||
+ | |||
+ | < | ||
+ | make apache-conf | ||
+ | </ | ||
+ | |||
+ | and you get the config snippet printed in the terminal -- it should look like (of course, x.y.x is replaced by version number): | ||
+ | |||
+ | < | ||
+ | siremis-x.y.z# | ||
+ | # siremis apache conf snippet ... | ||
+ | |||
+ | Alias /siremis "/ | ||
+ | < | ||
+ | Options Indexes FollowSymLinks MultiViews | ||
+ | AllowOverride All | ||
+ | Order allow,deny | ||
+ | Allow from all | ||
+ | < | ||
+ | Order deny,allow | ||
+ | Deny from all | ||
+ | </ | ||
+ | < | ||
+ | Order deny,allow | ||
+ | Deny from all | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | You can copy& | ||
+ | |||
+ | For Apache2 on Debian/ | ||
+ | |||
+ | < | ||
+ | / | ||
+ | </ | ||
+ | |||
+ | After restarting the web server, SIREMIS will be available under: | ||
+ | |||
+ | * http:// | ||
+ | |||
+ | 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': | ||
+ | |||
+ | < | ||
+ | siremis-x.y.z# | ||
+ | updating htaccess file... | ||
+ | updating app.inc file... | ||
+ | done | ||
+ | </ | ||
+ | |||
+ | Make sure that following directories have write access for web server user: | ||
+ | * siremis/log | ||
+ | * siremis/ | ||
+ | * siremis/ | ||
+ | * siremis/ | ||
+ | |||
+ | On Debian/ | ||
+ | |||
+ | < | ||
+ | siremis-x.y.z# | ||
+ | </ | ||
+ | |||
+ | 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: | ||
+ | |||
+ | < | ||
+ | GRANT ALL PRIVILEGES ON siremis.* TO siremis@localhost IDENTIFIED BY ' | ||
+ | </ | ||
+ | |||
+ | 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, | ||
+ | |||
+ | Also, you have to create Kamailio database with kamdbctl tool, if you don't have it already: | ||
+ | |||
+ | < | ||
+ | kamdbctl create | ||
+ | </ | ||
+ | |||
+ | 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:// | ||
+ | |||
+ | 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:// | ||
+ | |||
+ | ==== Step 1 ==== | ||
+ | |||
+ | First step shows the status of required items. You have to update local configuration until all the items are checked ok. | ||
+ | |||
+ | {{ http:// | ||
+ | |||
+ | ==== 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 ' | ||
+ | * Import Default Data - this imports initial data into database ' | ||
+ | * 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:// | ||
+ | |||
+ | ==== Step 3 ==== | ||
+ | |||
+ | This page presents a status report of installation, | ||
+ | |||
+ | {{ http:// | ||
+ | |||
+ | ==== Step 4 ==== | ||
+ | |||
+ | This is the end of installation, | ||
+ | |||
+ | {{ http:// | ||
+ | |||
+ | ==== Login Page ==== | ||
+ | |||
+ | After first login, do not forget to update the password for user admin. | ||
+ | |||
+ | {{ http:// | ||
+ | |||
+ | |||
+ | ===== Post Installation ===== | ||
+ | |||
+ | * remove the install directory: siremis/ | ||
+ | |||
+ | If you want to run again installation wizard: | ||
+ | * restore directory: siremis/ | ||
+ | * remove file: siremis/ | ||
+ | |||
+ | ===== 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, | ||
+ | * 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/ | ||
+ | * ... | ||
+ | |||
+ | ===== Siremis Components ===== | ||
+ | |||
+ | These are special Siremis components that need further configuration in order to work: | ||
+ | |||
+ | * [[siremis: | ||
+ | * [[siremis: | ||
+ | * [[siremis: | ||
+ | * [[siremis: | ||
+ | * [[siremis: | ||
+ | * [[siremis: | ||
+ | |||
+ | ===== 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, | ||
+ | |||
+ | {{tag> |