# Upgrading CKAN from 2.6 to the latest 2.9

## Setup this instance in your local machine: https://github.com/datopian/dx-helm-lincolnshire-prod

#### Steps:

1. Copy okfn docker-ckan repo
`git clone https://github.com/okfn/docker-ckan.git`
2. copy datopian lincolnshire-prod repo
`git clone https://github.com/datopian/dx-helm-lincolnshire-prod.git`
3. Copy lincolnshire-prod Dockerfile to okfn docker-ckan Dockerfile
`cp dx-helm-lincolnshire-prod/ckan/Dockerfile docker-ckan/ckan/Dockerfile`

4. update docker-ckan folder .env with lincolnshire-prod folder .env variables

5. Start the Docker Container

cd docker-ckan
docker-compose up --build

6. Access Application on `localhost:5000`

## Analysis of which extensions are 2.9 compatible

| Extensions | On Ckan 2.6 | Compatible | On Ckan 2.9
| -------- | -------- | -------- | -------- |
| ckanext-pages | pip install -e git+https://github.com/ckan/ckanext-pages.git@v0.2.1#egg=ckanext-pages | No |pip install -e git+https://github.com/ckan/ckanext-pages.git@v0.3.3#egg=ckanext-pages
|ckanext-sentry |pip install -e git+https://github.com/okfn/ckanext-sentry.git#egg=ckanext-sentry | Yes | pip install -e git+https://github.com/okfn/ckanext-sentry.git#egg=ckanext-sentry
|ckanext-s3filestore | pip install -e git+https://github.com/datopian/ckanext-s3filestore.git@v0.1.0#egg=ckanext-s3filestore && \ pip install --no-cache-dir -r https://raw.githubusercontent.com/datopian/ckanext-s3filestore/v0.0.9/requirements.txt | No | pip install -r https://raw.githubusercontent.com/datopian/ckanext-s3filestore/ckan-2.9/requirements.txt && \ pip install -e git+https://github.com/datopian/ckanext-s3filestore.git@ckan-2.9-image-upload-fix#egg=ckanext-s3filestore
|ckanext-viderum | pip install --no-cache-dir git+https://github.com/ViderumGlobal/ckanext-viderum.git@v0.0.1#egg=ckanext-viderum | Yes | pip install --no-cache-dir git+https://github.com/ViderumGlobal/ckanext-viderum.git@v0.0.1#egg=ckanext-viderum
|ckanext-disqus| pip install --no-cache-dir git+https://github.com/ckan/ckanext-disqus#egg=ckanext-disqus | No | None
|ckanext-showcase|pip install e git+https://github.com/datopian/ckanext-showcase.git@v1.0.1nt#egg=ckanext-showcase| No |pip install -e git+https://github.com/ckan/ckanext-showcase.git@v1.5.1#egg=ckanext-showcase
|ckanext-spatial|pip install --no-cache-dir git+https://github.com/datopian/ckanext-spatial.git#egg=ckanext-spatial && \ pip install --no-cache-dir -r https://raw.githubusercontent.com/datopian/ckanext-spatial/master/pip-requirements.txt | No | pip install -e git+https://github.com/ckan/ckanext-spatial.git@v1.0.0#egg=ckanext-spatial && \ pip install --no-cache-dir -r ${SRC_DIR}/ckanext-spatial/pip-requirements.txt
|ckanext-lincolnshire |pip install -e git+https://github.com/datopian/ckanext-lincolnshire.git@v0.2.5#egg=ckanext-lincolnshire | Yes| pip install -e git+https://github.com/datopian/ckanext-lincolnshire.git@v0.2.5#egg=ckanext-lincolnshire
|ckanext-basiccharts | pip install --no-cache-dir git+https://github.com/ckan/ckanext-basiccharts.git#egg=ckanext-basiccharts | Yes | pip install --no-cache-dir git+https://github.com/ckan/ckanext-basiccharts.git#egg=ckanext-basiccharts
|ckanext-viewhelpers | pip install --no-cache-dir git+https://github.com/ckan/ckanext-viewhelpers.git#egg=ckanext-viewhelpers | Yes | pip install --no-cache-dir git+https://github.com/ckan/ckanext-viewhelpers.git#egg=ckanext-viewhelpers
|ckanext-dashboard| pip install --no-cache-dir git+https://github.com/ckan/ckanext-dashboard.git#egg=ckanext-dashboard | Yes | pip install --no-cache-dir git+https://github.com/ckan/ckanext-dashboard.git#egg=ckanext-dashboard
|ckanext-mapviews|pip install --no-cache-dir git+https://github.com/datopian/ckanext-mapviews.git@configurable-map#egg=ckanext-mapviews | No| pip install --no-cache-dir git+https://github.com/datopian/ckanext-mapviews.git@ckan2.9-python3-compatible#egg=ckanext-mapviews
|ckanext-pdfview| pip install --no-cache-dir git+https://github.com/ckan/ckanext-pdfview#egg=ckanext-pdfview |Yes |pip install --no-cache-dir git+https://github.com/ckan/ckanext-pdfview#egg=ckanext-pdfview
|ckanext-report| pip install -e git+http://github.com/datopian/ckanext-report.git#egg=ckanext-report | Yes| pip install -e git+http://github.com/datopian/ckanext-report.git#egg=ckanext-report
|ckanext-archiver| pip install --no-cache-dir git+https://github.com/datopian/ckanext-archiver.git@v1.0.0#egg=ckanext-archiver | Yes| pip install --no-cache-dir git+https://github.com/datopian/ckanext-archiver.git@v1.0.0#egg=ckanext-archiver
|ckanext-hierarchy|pip install --no-cache-dir git+https://github.com/ViderumGlobal/ckanext-hierarchy.git@v0.0.1#egg=ckanext-hierarchy| No| pip install --no-cache-dir git+https://github.com/ViderumGlobal/ckanext-hierarchy.git@v0.1-1#egg=ckanext-hierarchy
|ckanext-googleanalytics|pip install --no-cache-dir -e git+https://github.com/ckan/ckanext-googleanalytics.git@05c153dc777e071ab48c42cb1817cd1ffa613060#egg=ckanext-googleanalytics && \ pip install --no-cache-dir -r https://raw.githubusercontent.com/ckan/ckanext-googleanalytics/05c153dc777e071ab48c42cb1817cd1ffa613060/requirements.txt |No|pip install --no-cache-dir -e git+https://github.com/ckan/ckanext-googleanalytics.git@v2.1.1#egg=ckanext-googleanalytics && \ pip install --no-cache-dir -r https://raw.githubusercontent.com/ckan/ckanext-googleanalytics/v2.1.1/requirements.txt

### Guidelines installing ckanext-spatial on ckan 2.9 on An Alpine base image.

Ckanext-spatial requires a python library called **pyproj** which is located in the requirements.txt file of the extension.
ckanext-spatial and pyproj requires certain packages and extensions.
**On An Alpine Base Image**:

* Before Installing ckanext-spatial extension, install the following dependency package.

RUN apk add proj \ 
    proj-dev \
    proj-util \ 
    gcc \
    libc-dev \ 
    geos-dev \
    geos

* Install the Ckanext-spatial extension

pip install -e git+https://github.com/ckan/ckanext-spatial.git@v1.0.0#egg=ckanext-spatial && \
pip install --no-cache-dir -r ${SRC_DIR}/ckanext-spatial/pip-requirements.txt

* After Installing ckanext-spatial extension, install ckanext-harvest extension and pyOpenSSL.

pip install -e git+https://github.com/ckan/ckanext-harvest.git@v1.3.3#egg=ckanext-harvest && \
pip install --no-cache-dir -r ${SRC_DIR}/ckanext-harvest/pip-requirements.txt && \
pip install --upgrade pyOpenSSL

**NB:** The following extensions functionality have been tested with ckan 2.9.x
Showcase, dashboard_preview, lincolnshire, pages, viewhelpers, spatial pdf_view, basicchart, mapview, report