Guía de instalación de la plataforma de datos abiertos CKAN

[TOC]

Requerimientos
==============

Para realizar la siguiente instalación se requieren los siguientes recursos:

- Una instalación fresca de Ubuntu Server 14.04
- Una interfaz de red con conexión a Internet

Pasos de instalación
====================

Software de CKAN
----------------

Instale los paquetes requeridos:

    sudo apt-get install python-dev postgresql libpq-dev python-pip python-virtualenv git-core solr-jetty openjdk-6-jdk

Instale CKAN en un entorno virtual de Python:

    sudo mkdir -p /usr/lib/ckan/default
    sudo chown `whoami` /usr/lib/ckan/default
    virtualenv --no-site-packages /usr/lib/ckan/default
    . /usr/lib/ckan/default/bin/activate

Instale el código fuente (última versión estable) de CKAN en el entorno virtual:

    pip install -e 'git+https://github.com/ckan/ckan.git@ckan-2.5.2#egg=ckan'

Instale los módulos de Python requeridos por CKAN:

    pip install -r /usr/lib/ckan/default/src/ckan/requirements.txt

Configuración de la base de datos
---------------------------------

Cree el usuario por defecto de CKAN:

    sudo -u postgres createuser -S -D -R -P ckan_default

Cree la base de datos de CKAN:

    sudo -u postgres createdb -O ckan_default ckan_default -E utf-8

Configuración de CKAN
---------------------

Cree el directorio para mantener la configuración de CKAN:
    
    sudo mkdir -p /etc/ckan/default
    mkdir -p ~/ckan/etc
    sudo chown -R `whoami` /etc/ckan/
    chown -R `whoami` ~/ckan/etc

Inicialice el archivo de configuración de CKAN:

    paster make-config ckan /etc/ckan/default/development.ini

Edite las siguientes líneas en el archivo /etc/ckan/default/development.ini:

    ...
    sqlalchemy.url = postgresql://ckan_default:pass@localhost/ckan_default
    ...
    ckan.site_id = default
    ...
    ckan.site_url = http://ckan.solvosoft.com
    ...

Configuración Solr
------------------

Edite el archivo de configuración de Jetty (/etc/default/jetty) y cambie las siguientes variables:

    NO_START=0            # (línea 4)
    JETTY_HOST=127.0.0.1  # (línea 16)
    JETTY_PORT=8983       # (línea 19)

Inicie el servicio de Jetty:

    sudo service jetty start

Reemplace el archivo de esquema de Solr con un enlace simbólico desde el código fuente de CKAN:

    sudo mv /etc/solr/conf/schema.xml /etc/solr/conf/schema.xml.bak
    sudo ln -s /usr/lib/ckan/default/src/ckan/ckan/config/solr/schema.xml /etc/solr/conf/schema.xml

Reinicie el servicio

    sudo service jetty restart

Edite nuevamente el archivo /etc/ckan/default/development.ini, con la siguiente línea:

    solr_url=http://127.0.0.1:8983/solr

Inicialización de la base de datos
----------------------------------

Dispare la creación de la base de archivos con los parámetros que están en el archivo de configuración de CKAN:

    cd /usr/lib/ckan/default/src/ckan
    paster db init -c /etc/ckan/default/development.ini

Configuración final
-------------------

Referencie el archivo who.ini para que se encuentre en el mismo directorio que el archivo de configuración:

    ln -s /usr/lib/ckan/default/src/ckan/who.ini /etc/ckan/default/who.ini

Ahora puedes acceder al servidor Paster para servir el servicio de CKAN desde la línea de comandos:

    cd /usr/lib/ckan/default/src/ckan
    paster serve /etc/ckan/default/development.ini

Prueba de ejecución
-------------------

Abra desde su navegador favorito la URL: http://127.0.0.1:5000/

En el navegador debería poder revisar la pantalla inicial del servidor de CKAN.


[image:6 align:right]
    Pantalla inicial del servicio CKAN