CouchDB : le guide authentique

Vous pouvez installer le paquet CouchDB en exécutant :

sudo aptitude install couchdb

Une fois l'installation terminée, vous devriez conserver une copie de l'exécutable de CouchDB sur votre machine. Assurez-vous de lire jusqu'au bout la documentation spécifique aux différents systèmes Debian que vous trouverez sous /usr/share/couchdb.

CouchDB est déjà préinstallé sur tous les systèmes Ubuntu à partir de la version 9.10 (« Karmic »).

Vous pouvez installer le paquet CouchDB en exécutant :

sudo aptitude install couchdb

Une fois l'installation terminée, vous devriez conserver une copie de l'exécutable de CouchDB sur votre machine. Assurez-vous de lire jusqu'au bout la documentation spécifique aux différents systèmes Ubuntu que vous trouverez en suivant /usr/share/couchdb.

Activez l'ebuild de développement CouchDB en exécutant :

sudo echo dev-db/couchdb >> /etc/portage/package.keywords

Vérifiez l'ebuild CouchDB en exécutant :

emerge -pv couchdb

Préparez et installez l'ebuild CouchDB en exécutant :

sudo emerge couchdb

Une fois l'installation terminée, vous devriez conserver une copie de l'exécutable de CouchDB sur votre machine.

Rendez-vous sur Appendix D, installation depuis la sourceAppendix D, installation depuis la source si votre système ne dispose pas du paquet CouchDB.

La façon la plus simple de démarrer avec CouchDB sur Mac OS X est de télécharger CouchDBXCouchDBX. Cette application non officielle n'installe rien sur votre système et peut être lancée avec un simple double-clic. Notez cependant que pour une utilisation plus complète, il est recommandé d'effectuer une installation traditionnelle avec un programme du type HomebrewHomebrew.

Homebrew a été ajouté récemment aux outils de gestion des programmes de Mac OS X. Ses mots d'ordre sont : aucune configuration, les meilleures optimisations, et une bière en arrière-plan. Téléchargez Homebrew en cliquant à l'adresse http://github.com/mxcl/homebrew. Lisez les quelques instructions, puis exécutez dans l'invite de commandes :

brew install couchdb

Attendez la fin, puis démarrez CouchDB, en exécutant :

couchdb

Pour voir toutes les options disponibles au démarrage, exécutez :

couchdb -h

Ceci vous explique comment faire fonctionner CouchDB en arrière-plan, ainsi que d'autres options utiles.

Pour vérifier que CouchDB est bien en cours d'exécution, ouvrez votre navigateur et rendez-vous à http://127.0.0.1:5984/_utils/index.htmlhttp://127.0.0.1:5984/_utils/index.html.

MacPorts est l'outil de gestion de paquetages d'origine de Mac OS X. Même s'il ne fait pas officiellement partie du système d'exploitation, il peut être utilisé pour simplifier le processus d'installation du programme FLOSS sur votre machine. Avant d'installer CouchDB grâce à MacPorts, vous devez télécharger ce dernier ICIICI.

Assurez-vous que la version de MacPorts est à jour en exécutant :

sudo port selfupdate

Vous pouvez installer CouchDB grâce à MacPorts en exécutant :

sudo port install couchdb

Cette commande installera toutes les dépendances nécessaires à CouchDB. Si une de celles-ci est déjà installée, MacPorts ne cherchera pas à la mettre à jour. Pour vous assurer que tous les outils sont à jour, vous devez exécuter la commande :

sudo port upgrade couchdb

Mac OS X dispose d'un environnement logiciel de gestion de services nommé launchd qui peut être utilisé pour démarrer, arrêter, ou gérer les processus d'arrière-plan. Vous pouvez l'utiliser pour lancer automatiquement CouchDB quand le système démarre. Si vous souhaitez ajouter CouchDB à votre configuration de démarrage, vous devez exécuter :

sudo launchctl load -w /opt/local/Library/LaunchDaemons/org.apache.couchdb.plist

Après avoir exécuté cette commande, CouchDB devrait être disponible en cliquant à l'adresse suivante : http://127.0.0.1:5984/_utils/index.html.

CouchDB sera aussi démarré ou arrêté en même temps que le système d'exploitation.

Pour préparer et installer CouchDB, vous aurez besoin d'installer une série d'autres logiciels dont CouchDB dépend. Sans ces derniers installés correctement sur votre système, CouchDB refusera de démarrer. Vous aurez besoin de télécharger et d'installer :

• Erlang OTP (>= R12B) ;
• ICU ;
• OpenSSL ;
• Mozilla SpiderMonkey ;
• libcurl ;
• GNU Make ;
• GNU Compiler Collection.

Nous vous recommandons d'installer Erlang OTP R12B-5, voire une version supérieure si possible.

Chacun de ces progiciels devrait offrir des instructions pour une installation personnalisée, soit sur le site internet, soit directement dans l'archive téléchargée. Si vous êtes chanceux, vous devriez pouvoir utiliser un gestionnaire pour installer toutes ces dépendances d'un seul coup.

Vous pouvez installer tous les prérequis en exécutant :

apt-get install build-essential erlang libicu-dev libmozjs-dev libcur14-openssl-dev

Si vous obtenez une erreur pour l'un de ces paquetages, assurez-vous d'avoir téléchargé la dernière version en date. Il est possible qu'une version plus récente soit disponible et le nom de l'archive serait donc différent. Par exemple, vous pouvez chercher une nouvelle version de l'archive ICU en exécutant :

apt-cache search libicu

Choisissez et installez la version la plus récente disponible dans la liste.

Vous aurez besoin d'installer le métapaquet Xcode Tools en exécutant :

open /Applications/Installers/Xcode\ Tools/XcodeTools.mpkg

S'il n'est pas disponible sur votre système, vous devrez l'installer depuis votre CD d'installation de Mac OS X. Sinon, vous pouvez aussi télécharger une copie.

Vous pourrez alors installer les autres prérequis utilisant MacPorts en exécutant :

port install icu erlang spidermonkey curl

Consultez le chapitre II Installation sur Mac OS X pour plus de détails.

Maintenant que toutes les dépendances sont installées, il vous faut télécharger une copie de la ource CouchDB. Vous devriez obtenir une archive à extraire. Ouvrez une fenêtre terminal et changez le chemin et placez-vous dans le répertoire de votre archive récemment téléchargée.

Configurez la source en exécutant :

./configure

Vous êtes sur le point d'installer CouchDB sous : /usr/local, qui est l'emplacement par défaut pour un logiciel installé par l'utilisateur. Cette commande accepte une multitude d'options, et vous pouvez tout paramétrer, depuis le dossier d'installation au dossier principal, ou bien même celui d'installation d'Erlang ou SpiderMonkey.

Pour voir ce qui est disponible, vous pouvez exécuter :

./configure --help

Généralement vous pouvez ignorer cette étape si vous n'avez pas obtenu d'erreur lors de son premier démarrage. Vous aurez seulement besoin de passer des options supplémentaires si votre démarrage semble un peu bizarre ou si le script a des problèmes pour trouver une des dépendances installées auparavant.

Si tout se passe bien, vous devriez voir apparaître le message suivant :

You have configured Apache CouchDB, time to relax.

« Vous avez configuré Apache CouchDB, vous pouvez vous détendre. » Ouf !

Préparez et installez la source en exécutant :

make && sudo make install

Si vous avez modifié le dossier d'installation dans un endroit temporaire, peut-être ne voudriez pas utiliser la commande sudo dans ce cas. Si vous avez des problèmes en exécutant make, essayez d'exécuter gmake si elle est disponible sur votre machine. Vous trouverez plus d'options en lisant le fichier INSTALL.

Il est déconseillé de lancer un serveur CouchDB en tant que superutilisateur. Si le serveur CouchDB est compromis par un intrus pendant qu'il tourne en administrateur, l'intrus pourra prendre le contrôle de votre machine en tant que superutilisateur. Et nous ne voulons pas ça !

Nous vous recommandons fortement de créer un utilisateur spécifique pour CouchDB. Cet utilisateur devra avoir le moins d'autorisations possible, tout en lui laissant la possibilité d'accéder à l'utilisation des logiciels et au serveur CouchDB, de lire les fichiers de configuration et de pouvoir gérer les données et les fichiers journaux.

Vous pouvez utiliser n'importe quel outil disponible sur votre ordinateur pour créer cet utilisateur couchdb.

Sur de nombreux systèmes du type Unix, vous pouvez exécuter :

adduser --system --home /usr/local/var/lib/couchdb --no-create-home --shell /bin/bash --group --gecos "CouchDB" couchdb

Mac OS X offre l'option standard « Comptes » via l'application des Préférences du Système, auquel cas vous pouvez utiliser l'application Workgroup Manager, disponible sur le Server Admin Tools.

Vous devez vous assurer que l'utilisateurcouchdb dispose d'un shell de connexion fonctionnel. Vous pouvez le tester en vous connectant à un terminal en tant que l'utilisateur couchdb. Vous devez également vous assurer d'être bien sous le répertoire /usr/local/var/lib/couchdb, répertoire contenant la base de données de CouchDB.

Vous pouvez changer le propriétaire des répertoires CouchDB en exécutant :

chown -R couchdb:couchdb /usr/local/etc/couchdb
chown -R couchdb:couchdb /usr/local/var/lib/couchdb
chown -R couchdb:couchdb /usr/local/var/log/couchdb
chown -R couchdb:couchdb /usr/local/var/run/couchdb

Vous pouvez changer les permissions pour les répertoires CouchDB en exécutant :

chmod -R 0770 /usr/local/etc/couchdb
chmod -R 0770 /usr/local/var/lib/couchdb
chmod -R 0770 /usr/local/var/log/couchdb
chmod -R 0770 /usr/local/var/run/couchdb

Ce n'est pas tout concernant la sécurité de CouchDB. Si vous déployez CouchDB sur le Web, ou tout autre endroit où des personnes malveillantes pourraient avoir accès à votre serveur, il vous faudra chercher les mesures de sécurité recommandées pour votre système d'exploitation et prendre toutes les précautions nécessaires supplémentaires. Gardez à l'esprit que la meilleure façon de sécuriser son système informatique est de le déconnecter du réseau.

Vous pouvez démarrer le serveur CouchDB en exécutant :

sudo -i -u couchdb couchdb -b

Ceci utilise la commande sudo pour exécuter la commande couchdb en tant qu'utilisateurcouchdb.

À la fin du démarrage de CouchDB, le message suivant s'affichera :

Apache CouchDB has started, time to relax.

« Apache CouchDB a démarré, vous pouvez vous détendre. » Ouf !

Pour vérifier que tout fonctionne correctement, rendez-vous via votre navigateur internet à l'adresse suivante :

http://127.0.0.1:5984/_utils/index.html

Il s'agit de Futon, la console d'administration en ligne de CouchDB. Nous avons présenté les bases de Futon dans les chapitres précédents. Une fois que la console a chargé, sélectionnez et lancez la CouchDB Test Suite depuis le menu situé à droite. Cela vous permettra de vous assurer que tout fonctionne correctement, et cela vous évitera un sérieux mal de tête si quelque chose ne tourne pas rond.

Une fois que CouchDB s'est exécuté correctement, vous voudrez probablement le lancer en tant que démon. Un démon est une application qui fonctionne en permanence en arrière-plan, en attente de requêtes. C'est de cette façon que la plupart des serveurs de bases de données de production fonctionnent, et vous pouvez paramétrer CouchDB pour fonctionner ainsi.

Quand vous lancez CouchDB en tant que démon il couvre l'historique d'un certain nombre de fichiers que vous voudrez nettoyer de temps en temps. Laisser cet historique remplir votre disque dur est un bon moyen d'endommager votre serveur. Certains systèmes d'exploitation sont fournis avec des logiciels qui s'en occupent à votre place, vous devrez chercher les meilleures options et faire le nécessaire pour vous éviter ce genre de problème. CouchDB est fourni avec une configuration logrotate, ce qui pourra vous être utile.

IV-G-1. Systèmes du type SysV/BSD▲

sudo /usr/local/etc/[init.d|rc.d]/couchdb start

sudo /usr/local/etc/[init.d|rc.d]/couchdb stop

sudo /usr/local/etc/[init.d|rc.d]/couchdb status

sudo update-rc.d couchdb defaults

Vous pouvez utiliser le système launchd pour contrôler le démon de CouchDB.

Vous pouvez charger la configuration du système launchd en exécutant :

sudo launchctl load /usr/local/Library/LaunchDaemons/org.apache.couchdb.plist

Vous pouvez désactiver cette configuration en exécutant :

sudo launchctl unload /usr/local/Library/LaunchDaemons/org.apache.couchdb.plist

Vous pouvez démarrer le démon de CouchDB en exécutant :

sudo launchctl start org.apache.couchdb

Vous pouvez arrêter le démon de CouchDB en exécutant :

sudo launchctl stop org.apache.couchdb

Le système launchd peut contrôler automatiquement le démon de CouchDB, en le lançant ou l'arrêtant en arrière-plan. Pour cela vous devrez copier le fichier plist dans le répertoire /Library/LaunchDaemons de votre système.

Veuillez consulter la documentation de launchd pour plus d'informations.

Un programme reste un programme, vous pourrez faire face à un problème de temps en temps. Mais pas de panique ! CouchDB possède une grande communauté d'individus en mesure de répondre à vos questions et à vous aider lors de vos débuts. Vous trouverez ci-dessous quelques ressources qui pourront sûrement vous être utiles :

• si vous rencontrez un message d'erreur bizarre, jetez un œil à la page Wiki des Messages d'Erreur ;
• pour tout souci d'ordre général, essayez les Étapes pour résoudre un problème ;
• pour toute autre question d'ordre général, consultez la liste de diffusion sur le site internet de CouchDB.

N'oubliez pas d'utiliser votre moteur de recherche favori pour tenter de diagnostiquer vous-même les problèmes. Si vous fouillez un peu, vous trouverez probablement quelque chose. Il est fort possible que d'autres personnes aient eu exactement le même souci que vous, et que la solution ait déjà été postée quelque part sur la toile. Bonne chance ! Et n'oubliez pas, détendez-vous !

JSON dispose d'un certain nombre de types de données de base qui sont à votre disposition. Nous allons tous vous les présenter.

V-A-1. Nombres▲

V-A-2. Chaînes de caractères▲

"Auteur": "Rusty"

"poem": "Puis-je te comparer à du\n\tplancton salé."

V-A-3. Booléens▲

"Draft": true

"Draft": false

V-A-4. Tableaux▲

"Tags": ["plankton", "baseball", "decisions"]

"Context": ["dog", [1, true], {"Location": "puddle"}]

V-A-5. Objets▲

{"Subject": "I like Plankton", "Author": "Rusty"}

V-A-6. Valeurs nulles▲

"Surname": null