Open Data Node v1.0.3

ATTENTION PLEASE

Draft of release - preparation

Scope

Fixes of bugs in OpenDataNode components (UnifiedViews, Midpoint, debian installation/configuration)

Time frame

01 Jun 2015 - 12 Jun 2015

Details

Main fixed bugs

Release

Open Data Node v1.0.3 was released 12 Jun 2015 . It consist of following versions of components:

ODN/UV Core v2.0.2 ???
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.2 (CKAN v2.3.0) ???
- using extension ODN-THEME v1.0.2 ???
- 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.3 ???
ODN-CAS v1.0.1 ???
ODN-BOX v1.0.2 ???

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:
1. 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)
2. 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)

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:
1. install ODN box:
```
aptitude install odn-simple
```
2. 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 call
aptitude 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
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 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

Page tree