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.

sudo dpkg -i python-istsos_2.4.0-RC1.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. Go to the Database configuration for instruction on how to configure the database.

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.

Download istSOS and unpack it

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

sudo tar -zxvf istSOS-2.4.0-RC1.tar.gz -C /usr/local/

Set executing permissions and the 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

Install Python3, Apache2 and mod_wsgi

sudo apt install python3 python3-pip apache2 libapache2-mod-wsgi-py3

Install Python3 dependencies

sudo pip3 install -r /usr/local/istsos/requirements.txt

Configure Apache and WSGI

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

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
 <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>

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/

Go to the Database configuration for instruction on how to configure the database.