This shows you the differences between two versions of the page.
— | siremis:install20:main [2010/11/01 14:48] (current) – created - external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== Siremis v2.0 - Installation ====== | ||
+ | < | ||
+ | Author: | ||
+ | Elena-Ramona Modroiu | ||
+ | </ | ||
+ | |||
+ | ===== Requirements ===== | ||
+ | |||
+ | * [[http:// | ||
+ | * 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:// | ||
+ | * 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' | ||
+ | |||
+ | < | ||
+ | siremis-2.0# | ||
+ | # 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& | ||
+ | |||
+ | This will make SIREMIS available under http:// | ||
+ | |||
+ | ===== Local Configuration ===== | ||
+ | |||
+ | Next step is to create .htaccess and Siremis configuration files, you have to run 'make prepare': | ||
+ | |||
+ | < | ||
+ | siremis-2.0# | ||
+ | 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/ | ||
+ | |||
+ | |||
+ | 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 ' | ||
+ | </ | ||
+ | |||
+ | This 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 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:// | ||
+ | |||
+ | 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 ==== | ||
+ | |||
+ | 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:// | ||
+ | |||
+ | |||
+ | ===== Post Installation ===== | ||
+ | |||
+ | * remove the install directory: siremis/ | ||
+ | |||
+ | If you want to run again installation wizard: | ||
+ | * restore directory: siremis/ | ||
+ | * remove file: siremis/ | ||
+ | |||
+ | ===== Siremis Components ===== | ||
+ | |||
+ | These are special Siremis components that need further configuration in order to work: | ||
+ | |||
+ | * [[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> |