=========================== Installer CKAN from source =========================== Cette section décrit comment installer CKAN utilisé par |site_name| à partir des sources sur un serveur Ubuntu 20.04. -------------------------------------- 1. Installer les paquets nécessaires -------------------------------------- Avant de configurer le dossier de ckan, il faut installer les librairies suivantes:: sudo apt-get install python3-dev postgresql libpq-dev python3-pip python3-venv git-core solr-jetty openjdk-8-jdk redis-server ------------------------------------------------- 2. Installer CKAN dans un Python virtual environment ------------------------------------------------- .. tip:: If you're installing CKAN for development and want it to be installed in your home directory, you can symlink the directories used in this documentation to your home directory. This way, you can copy-paste the example commands from this documentation without having to modify them, and still have CKAN installed in your home directory: .. parsed-literal:: mkdir -p ~/ckan/lib sudo ln -s ~/ckan/lib |virtualenv_parent_dir| mkdir -p ~/ckan/etc sudo ln -s ~/ckan/etc |config_parent_dir| a. Créer un environnement virtuel Python `virtual environment `_ (virtualenv) pour ckan et l'activer: .. parsed-literal:: sudo mkdir -p |virtualenv| sudo chown \`whoami\` |virtualenv| python3 -m venv |virtualenv| |activate| .. important:: La dernière commande ci-dessus active votre virtualenv. Le virtualenv doit rester actif pour le reste du processus d'installation et de déploiement, ou les commandes échoueront. Vous pouvez savoir si le virtualenv est actif car son nom apparaît devant l'invite de votre shell, comme ceci:: (default) $ _ Par exemple, si vous vous déconnectez et vous reconnectez, ou si vous fermez votre fenêtre de terminal et l'ouvrez à nouveau, votre virtualenv ne sera plus activé. et que vous l'ouvrez à nouveau, votre virtualenv ne sera plus activé. Vous pouvez toujours réactiver le virtualenv à l'aide de cette commande:: . /usr/lib/ckan/default/bin/activate b. Installez la version recommandée de setuptools: .. parsed-literal:: sudo apt install python3-testresources pip install setuptools==44.1.0 pip install --upgrade pip c. Installer CKAN dans votre virtualenv: .. parsed-literal:: cd /usr/lib/ckan/default/ pip install -e 'git+https://github.com/ckan/ckan.git@ckan-2.9.5#egg=ckan[requirements]' .. warning:: Il faut obligatoire installer le ckan 2.9.5 parsce que parmis les extensions installes, y'en a qui sont uniquement compatible avec cette version de ckan d. Installer la version customise |site_name| .. parsed-literal:: cd /usr/lib/ckan/default/src/ckan sudo rm -rf ckan git clone https://gitlab.com/opendatacomore/ckan_2.9.5.git mv ckan_2.9.5 ckan cd ckan git branch develop git checkout develop git pull origin develop .. _postgres-setup: ------------------------------ 3. Configurer une base de données PostgreSQL ------------------------------ .. include:: postgres.rst ----------------------------------- 4. Creer un ficher de configuration ----------------------------------- a. Créer un dossier contenant les fichiers de configuration: .. parsed-literal:: sudo mkdir -p /etc/ckan/default sudo chown -R \`whoami\` /etc/ckan/ b. Créer le fichier de configuration CKAN .. parsed-literal:: . /usr/lib/ckan/default/bin/activate ckan generate config /etc/ckan/default/ckan.ini c. Editer le fichier ckan.ini, en modifiant les options suivantes: .. note:: Les paramètres ci-dessous correspondent à la configuration minimale requise pour exécuter le CKAN. .. parsed-literal:: ## Database Settings ## This should refer to the database we created in :ref:`postgres-setup` above ## Replace ``pass`` with the ``CKAN database`` password that you created sqlalchemy.url = postgresql://ckan_default:pass@localhost/ckan_default ## Replace ``pass`` with the ``CKAN database`` password that you created ckan.datastore.write_url = postgresql://ckan_default:pass@localhost/datastore_default ## Replace ``pass`` with the ``DataStore database`` password that you created ckan.datastore.read_url = postgresql://datastore_default:pass@localhost/datastore_default ## Site Settings ckan.site_url = http://127.0.0.1:5000 ## Storage Settings ckan.storage_path = /var/lib/ckan/default ------------------------------------------------------- 6. Configuration de Solr ------------------------------------------------------- .. include:: solr.rst ------------------------------------------------------- 7. Créer des tables de base de données ------------------------------------------------------- .. important:: Cette partie est reservee aux administrateurs de |site_name|. a. Avant de pouvoir exécuter CKAN pour la première fois, vous devez exécuter db init pour initialiser votre base de données: .. parsed-literal:: ckan -c /etc/ckan/default/ckan.ini db init b. Vous devriez voir "Initialising DB: SUCCESS". ---------------------- --------. Lien à ``who.ini`` ---------------------- .. parsed-literal:: ln -s /usr/lib/ckan/default/src/ckan/who.ini /etc/ckan/default/who.ini ----------------------------------------- 9. Créer un compte administrateur système ----------------------------------------- Vous devez créer votre premier utilisateur système de |site_name| à partir de la ligne de commande. Par exemple, pour créer un utilisateur appelé `admin` et en faire un sysadmin : .. parsed-literal:: ckan -c /etc/ckan/default/ckan.ini sysadmin add $USERNAME email=$EMAIL name=$NAME ----------------------------------------- 10. Démarrer le serveur de développement de ckan ----------------------------------------- #. Ouvrir un autre terminal et utilisez le serveur de développement Paste pour servir CKAN depuis la ligne de commande: .. parsed-literal:: . /usr/lib/ckan/default/bin/activate ckan -c /etc/ckan/default/ckan.ini run #. Ouvrez http://127.0.0.1:5000/ dans un navigateur Web et vous devriez voir la page d'accueil du CKAN. .. important:: Maintenant que vous avez installé CKAN.