Scope
Fixes of bugs in OpenDataNode components (UnifiedViews, Midpoint, debian installation/configuration)
Time frame
-
Details
Main fixed bugs in ODN v1.0.3 listed in Open Data Node github
Release
Open Data Node v1.0.3 was released . It consist of following versions of components:
- UnifiedViews Core v2.0.3
- UnifiedViews Plugins v2.0.1
- compatible with ODN/UV Plugin-DevEnv v2.0.1 and also ODN/UV Plugin-DevEnv v2.0.0
- ODN-UV-PLUGINS v1.0.3
- ODN-SOLR v1.0.0 (SOLR 4.10.2)
- ODN-CKAN v1.0.3 (CKAN v2.3.0)
- using extension ODN-PIPELINE v1.0.0
- using extension ODN-IC2PC-SYNC v1.0.3
- using extension ODN-CAS v1.0.3
- using extension ODN-DATASTORE-API v1.0.0
- ODN-MIDPOINT v3.3
- ODN-CAS v1.0.3
- ODN-BOX v1.0.3
- using extension ODN-THEME v1.0.3
Debian packages are available at: https://packages.comsode.eu/debian/
Installation manual for ODN using Debian package (odn-simple): https://github.com/OpenDataNode/odn-box/blob/ODN_v1.0.3/readme.md
List of issues included in the release is available: https://github.com/OpenDataNode/open-data-node/milestones/ODN%20v1.0.3
Installation manual
Upgrade from ODN prior to 1.0.0 is not correctly supported due to change of CKAN version and also infrastructure changes.
Supported distribution is Debian Wheezy (7.x).
To install (or upgrade to newer version of ODN) packages from COMSODE Debian repository, please follow these steps:
Configure Debian as follows:
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 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)
How to set FQDN
# get ip address of host IP_ADDRESS=`/sbin/ifconfig eth0 | grep 'inet addr:' | cut -d: -f2 | awk '{ print $1}'` # set FQDN - where host is accessible via my-computer.my-domain.ext echo "$IP_ADDRESS my-computer.my-domain.ext my-computer " >> /etc/hosts # verify hostname -A
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
Use either option a for new installation of ODN or option b for upgrade to newer version of ODN:
install ODN box:
aptitude install odn-simple
upgrade ODN box:
aptitude upgrade
The following user input is required during the installation process (in case of ODN upgrade, previously provided values are used = no user input is required):
- ldap password: whatever password can be used
- Virtuoso password: dba
In case of ODN 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 required
If you want to reduce packages that are not necessary, then callaptitude install --without-recommends odn-simple
Post-install steps (in case of ODN upgrade no post-install steps are needed)
By default, some users are created during aptitude installation (see bellow). It is necessary to enable casadmin user to work as SSO user.
- Go to midpoint login page (
https://<hostname>/midpoint/login
) - Login as midpoint administrator (administrator/5ecr3t)
- go to menu Users->ListUsers
- select user
casadmin
- select action Reconcile from dropdown actions button
URLs of components
After successful installation the following URLs are assigned:
- ODN/PublicCatalog
- http://<hostname>/
- https://<hostname>/
- ODN/InternalCatalog: https://<hostname>/internalcatalog
- ODN/UnifiedViews: https://<hostname>/unifiedviews
- ODN/midPoint: https://<hostname>/midpoint/login
- ODN/cas: https://<hostname>/cas
Only public catalog is accessible also via http protocol, other services are accessible only via https due to the fact that there is transfer sensitive information.
Default users
After successful installation the following users are created (can be used immediately): TODO correction needed
Component | Username | Password | Role in component | ODN role | Note |
---|---|---|---|---|---|
ODN | casadmin | Passw0rd | user used in other components, logged in via ODN/CAS | ||
ODN/midpoint | administrator | 5ecr3t | ODN user Administrator | ||
ODN/PublicCatalog | admin | admin | CKAN sysadmin | ||
ODN/InternalCatalog | see ODN | see ODN | CKAN editor, Data Publisher | ||
Unified Views | see ODN | see ODN | Administrator, User | ||
Host | uploader | uploader | Publisher
| upload dumps to /var/www/dump - DPU: uv-l-filesUpload can upload dumps. Dumps are accessible via https://host/dump/dump.zip upload graphs to /var/cache/virtuoso/upload - DPU: uv-l-filesToVirtuoso can upload graphs from the path to virtuoso |
You are strongly advised to change them right after installation. (TODO: add short description about how to change passwords)
Known issues
N/A
Troubleshooting
Java 7 support
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
Python dependency update (in case of ODN upgrade no Python dependency update is needed)
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