no way to compare when less than two revisions

Differences

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

@@ 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}}

Asipto - SIP and VoIP Knowledge Base Site

User Tools

Site Tools

Differences

Page Tools