Skip to content

Latest commit

 

History

History
177 lines (108 loc) · 5.07 KB

install-from-package.rst

File metadata and controls

177 lines (108 loc) · 5.07 KB
Raw

Installing CKAN from package

This section describes how to install CKAN from package. This is the quickest and easiest way to install CKAN, but it requires Ubuntu 14.04 64-bit or Ubuntu 12.04 64-bit. If you're not using Ubuntu 14.04 64-bit or Ubuntu 12.04 64-bit, or if you're installing CKAN for development, you should follow install-from-source instead.

At the end of the installation process you will end up with two running web applications, CKAN itself and the DataPusher, a separate service for automatically importing data to CKAN's /maintaining/datastore.

1. Install the CKAN package

On your Ubuntu 14.04 or 12.04 system, open a terminal and run these commands to install CKAN:

  1. Update Ubuntu's package index:

    sudo apt-get update

  2. Install the Ubuntu packages that CKAN requires (and 'git', to enable you to install CKAN extensions):

    sudo apt-get install -y nginx apache2 libapache2-mod-wsgi libpq5 redis-server git-core

  3. Download the CKAN package:

    Note

    If wget is not present, you can install it via:

    sudo apt-get install wget

  4. Install the CKAN package:

    • On Ubuntu 14.04:

      sudo dpkg -i

    • On Ubuntu 12.04:

      sudo dpkg -i

    Note

    If you get the following error it means that for some reason the Apache WSGI module was not enabled:

    Syntax error on line 1 of /etc/apache2/sites-enabled/ckan_default: Invalid command 'WSGISocketPrefix', perhaps misspelled or defined by a module not included in the server configuration Action 'configtest' failed. The Apache error log may have more information. ...fail!

    You can enable it by running these commands in a terminal:

    sudo a2enmod wsgi
sudo service apache2 restart

2. Install and configure PostgreSQL

Tip

You can install and CKAN on different servers. Just change the sqlalchemy.url setting in your file to reference your server.

Install , running this command in a terminal:

sudo apt-get install -y postgresql

Edit the sqlalchemy.url option in your config_file () file and set the correct password, database and database user.

3. Install and configure Solr

Tip

You can install and CKAN on different servers. Just change the solr_url setting in your file to reference your server.

Install , running this command in a terminal:

sudo apt-get install -y solr-jetty

The install will whirr away, then towards the end you'll see this:

* Not starting jetty - edit /etc/default/jetty and change NO_START to be 0 (or comment it out).

4. Update the configuration and initialize the database

  1. Edit the config_file () to set up the following options:

    site_id

    Each CKAN site should have a unique site_id, for example:

    ckan.site_id = default
    site_url

    Provide the site's URL. For example:

    ckan.site_url = http://demo.ckan.org

  2. Initialize your CKAN database by running this command in a terminal:

    sudo ckan db init
  3. Optionally, setup the DataStore and DataPusher by following the instructions in /maintaining/datastore.
  4. Also optionally, you can enable file uploads by following the instructions in /maintaining/filestore.

5. Restart Apache and Nginx

Restart Apache and Nginx by running this command in a terminal:

sudo service apache2 restart
sudo service nginx restart

6. You're done!

Open http://localhost in your web browser. You should see the CKAN front page, which will look something like this:

You can now move on to /maintaining/getting-started to begin using and customizing your CKAN site.

Note

The default authorization settings on a new install are deliberately restrictive. Regular users won't be able to create datasets or organizations. You should check the /maintaining/authorization documentation, configure CKAN accordingly and grant other users the relevant permissions using the sysadmin account <create-admin-user>.