Scope
UnifiedViews 2.0 with improved DPUs, upgrade of CKAN to v2.3, SSO support with management of users in midPoint.
Time frame
-
Details
Release is planed to support standard scenarios for publication of data including:
- data available for consumers as dumps, SPARQL endpoint, REST API
- processing of tabular and RDF data
- single sign on
- user management
First version that have integrated all components defined in architecture of Open Data Node and is ready for installation by end users (data publishers and aggregators or application developers).
Version 1.0.0 was not released due to integration issues and SSO misconfiguration. Version 1.0.1 is identical in features implemented.
User stories for Data Consumer
User stories for Data Publisher
- sto_1v2: Login into ODN
- sto_42: Pipeline debugging
- sto_60: Retrieving data via REST API
- sto_51v2: Logout from ODN
- sto_71v2: Instant manual synchronization with external catalog
- sto_86: Default set of DPU templates
User stories for ODN Administrator
- sto_1v2: Login into ODN
- sto_31: New user and its role
- sto_51v2: Logout from ODN
- sto_70: GUI language management
Release
Open Data Node v1.0.1 was released . It consist of following versions of components:
- ODN/UV Core v2.0.1
- for new features comparing to ODN v0.11.0 see also ODN/UV Core v2.0.0
- ODN/UV Plugins v2.0.1
- compatible with ODN/UV Plugin-DevEnv v2.0.1 and also ODN/UV Plugin-DevEnv v2.0.0
- ODN-SOLR v1.0.0 (SOLR 4.10.2)
- ODN-CKAN v1.0.1 (CKAN v2.3.0)
- using extension ODN-THEME v1.0.1
- using extension ODN-PIPELINE v1.0.0
- using extension ODN-IC2PC-SYNC v1.0.0
- using extension ODN-CAS v1.0.0
- using extension ODN-DATASTORE-API v1.0.0
- ODN-MIDPOINT v3.2
- ODN-CAS v1.0.1
- ODN-BOX v1.0.1
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.1/readme.md
List of issues included in the release is available: https://github.com/OpenDataNode/open-data-node/milestones/ODN%20v1.0.0
Installation manual
Upgrade from ODN v0.11.0 is not correctly supported due to change of CKAN version and also infrastructure changes.
Supported distribution is Debian Wheezy (7.x). To install packages from COMSODE Debian repository, please follow these steps:
Configure debian box properly, mainly hostname shall be defined as box visible from external network
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:
aptitude install odn-simple
System requires the following user input during the installation process:
- ldap password: whatever password can be used
- Virtuoso password: dba
If you want to reduce packages that are not necessary, then call
aptitude install --without-recommends odn-simple
Post-install steps
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 |
---|---|---|---|---|
ODN/PublicCatalog | admin | admin | CKAN sysadmin | |
ODN/cas | casadmin | Passw0rd | ||
ODN/InternalCatalog | see ODN/CAS | see ODN/CAS | CKAN editor | |
Unified Views | see ODN/CAS | see ODN/CAS | Administrator, User | |
ODN/midpoint | administrator | 5ecr3t | ODN user Administrator |
You are strongly advised to change them right after installation. (TODO: add short description about how to change passwords)
Known issues
- L-Catalog DPU is included in the installation accidentally, it shall be removed manually from UnifiedViews
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 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