Info |
---|
Note: As of now, we have this info included also in each Release Notes for each version we push out - see for example Open Data Node v0.11.0#Installationmanual . This will continue so but the one, master and always up-tyo-date copy of that information will be later on only in this page (just simplified content will be copied into Release Notes from here on each subsequent release). |
Installation
TODO: Initial steps needed to install ODN from .DEB packages, including all steps admin needs to do before ODN user (DAta Publisher role) can actually get in and do anything
Upgrading
Install and Upgrade Manual
Supported distribution is Debian Wheezy (7.x).
Configuration of system
Configure FQDN on Debian
- if FQDN is defined, the host has to be visible from external network, (e.g. if FQDN is odn.example.com then the host must be visible both through http and https protocols via http://odn.example.com and https://odn.example.com)
- if FQDN is not defined, the host has to be visible from external network, (e.g. if hostname is example then the host must be visible both through http and https via http://example and https://example)
Steps to configure FQDN
- to get ip address of host
IP_ADDRESS=`/sbin/ifconfig eth0 | grep 'inet addr:' | cut -d: -f2 | awk '{ print $1}'`
- to set FQDN - where host is accessible via my-computer.my-domain.ext
echo "$IP_ADDRESS my-computer.my-domain.ext my-computer " >> /etc/hosts
- to verify if host is set properly
hostname -A
Configuration of java for tomcat
tomcat 7 uses by default java 6 so it is necessary to change default java for tomcat. Edit /etc/default/tomcat7, update environment variable JAVA_HOME. JAVA_HOME=/usr/lib/jvm/java-7-openjdk-amd64
Installation on clean system
To install packages from COMSODE Debian repository, please follow these steps:
Add ODN packages repository into apt-sources-list:
echo "deb http://packages.comsode.eu/debian/ wheezy main" > /etc/apt/sources.list.d/odn.list
Add ODN public key:
wget -O - http://packages.comsode.eu/key/odn.gpg.key | apt-key add -
Update apt sources:
aptitude update
install ODN box (odn-simple package):
aptitude install odn-simple
The following user input is required during the installation process:- ldap password: whatever password can be used
- Virtuoso password: dba
Note 1: If you want to reduce packages that are not necessary, then call aptitude install --without-recommends odn-simple
Note 2: In case of fresh clean Debian Wheezy installation the steps described above should work, no other commands are required. However in some cases some python dependency problems has been detected (when the Debian environment was created as a result of virtualization). In such cases the following steps are required to resolve the dependency problems:
apt-get purge python\*
apt-get install python2.7-minimal -V
apt-get install libapache2-mod-wsgi -V
apt-get install lsb-release -V
apt-get install python-pkg-resources -V
apt-get install python-pip -V
apt-get install python-setuptools -V
aptitude install odn-simple -V
Upgrade from a previous version
Note: Upgrade from ODN prior to 1.0.0 is not correctly supported due to change of CKAN version and also infrastructure changes.
If you already installed ODN using steps described in previous section, follow these steps
- it is strongly recommended to backup databases
- to update to newest version, simply run:
aptitude update
aptitude upgrade
User is required to confirm replacement of configuration files from previous installation, it should be confirmed by pressing 'Y' each time user input is requiredTODO: General steps to update ODN using .DEB packages + subsection for each release which requires some specific steps. Will be supplied mainly by developers.