Installation on Linux

Installation on Linux with the Debian package

The easiest way to install istSOS on a Debian distribution is to use the istSOS deb packages.

Download the debian file from the repository

Please go to https://sourceforge.net/projects/istsos/files to get the latest release.

Install the debian file

Open a terminal and move to the folder containing the downloaded deb file.

cd ~/Downloads
sudo dpkg -i python-istsos_2.x.x.deb;sudo apt-get -f -y install

This command will install all the required dependencies, with the exception of PostgreSQL and PostGIS. In fact it could reside on other servers.

Note

If everything has gone well, you should see the administration page at this address: http://localhost/istsos/admin/

Installation on Linux from source

The dependencies need to be installed manually or using apt-get command. Please refer also to specific software installation procedures.

Install Apache2 and mod_wsgi

sudo apt-get install apache2 libapache2-mod-wsgi

Install psycopg2

sudo apt-get install python-psycopg2

Download istSOS and unpack it

Please go to https://sourceforge.net/projects/istsos/files , and chose the latest istSOS-2.x.x.tar.gz file. Save the file in the Downloads folder in your home directory, then unpack it executing these commands:

cd ~/Downloads
sudo tar -zxvf istSOS-2.x.x.tar.gz -C /usr/local/

Set executing permission and owner for the services and logs folders

sudo chmod 755 -R /usr/local/istsos
sudo chown -R www-data:www-data /usr/local/istsos/services
sudo chown -R www-data:www-data /usr/local/istsos/logs

Configure Apache and WSGI

Open /etc/apache2/sites-enabled/000-default, and add the following configuration:

 <VirtualHost *:80>

     ServerAdmin webmaster@localhost
     DocumentRoot /var/www/html

     ErrorLog ${APACHE_LOG_DIR}/error.log
     CustomLog ${APACHE_LOG_DIR}/access.log combined

     WSGIScriptAlias /istsos /usr/local/istsos/application.py
     Alias /istsos/admin /usr/local/istsos/interface/admin
     Alias /istsos/modules /usr/local/istsos/interface/modules

 </VirtualHost>

Note

If you are using Apache/2.4.6 or above (like in Ubuntu 13.10 or above) you could meet the “403 Forbidden” message.

 <VirtualHost *:80>

     ServerAdmin webmaster@localhost
     DocumentRoot /var/www/html

     ErrorLog ${APACHE_LOG_DIR}/error.log
     CustomLog ${APACHE_LOG_DIR}/access.log combined

     WSGIScriptAlias /istsos /usr/local/istsos/application.py
     Alias /istsos/admin /usr/local/istsos/interface/admin
     Alias /istsos/modules /usr/local/istsos/interface/modules

     <LocationMatch /istsos>
         Options +Indexes +FollowSymLinks +MultiViews
         AllowOverride all
         Require all granted
     </LocationMatch>

 </VirtualHost>

Restart the Apache web server

sudo service apache2 restart

Note

If everything has gone well, you should see the administration page at this address: http://localhost/istsos/admin/