Ce qui va suivre est valable pour Cassandra 0.6.1 qui est sorti dernièrement.
Vous pouvez vous procurer la dernière version à l'adresse suivante : http://cassandra.apache.org/
L'installation de Cassandra dépendra de votre distribution. Je ne sais pas si Cassandra marche avec openjdk & openjre (je parle en particulier pour les gens sous debian). Une autre chose qui sera sûrement utile de faire sera la modification des options par défaut de lancement de cassandra (en particulier pour la heap size).
Essayons de faire une installation pas à pas
1) Installation
Prérequis :
Linux, jre, jdk (pour le développement futur), Cassandra 0.6.0
Commencez par décompresser Cassandra 0.6.0 dans le dossier qui vous plaira.(Par défaut je l'avais fait dans : /home/victork/apache0.6/
Essayez de le lancer en vous positionnant dans le répertoire où vous avez décompressé apache et faites : bin/casssandra -f
SI tout marche bien passez à l'étape 2
SI vous avez des problèmes, il y a plusieurs solutions (cela n'a rien d'exhaustif) :
_Si vous êtes sous Ubuntu, voici un guide d'installation en anglais :
http://dustyreagan.com/installing-cassandra-on-ubuntu-linux/
_Si vous êtes sur debian, essayez d'installer jre et jdk par sun.
_Modifier le script de lancement pour changer la heap size.
_ Si rien ne fonctionne, les moteurs de recherche sont plutôt pratiques...
2) Première configuration
Il faut procéder à la configuration de votre base de données. Nous procéderons dans un premier temps par une configuration rapide avec les options basiques.
Dans un premier temps vous pouvez ne pas être intéressé par cette partie, en particulier si vous souhaitez directement tester. Dans ce cas passer directement à l'étape 3
Ouvrez avec un editeur de texte quelconque le fichier dans le repertoire de Cassandra : ./conf/storage-conf.xml
C'est ce fichier qui contient la description de vos/votre base de données.
Comme vous pouvez le constater ce n'est qu'un fichier XML au format classique. Ce qui va nous intéresser pour l'instant est ce qui est contenu dans ./conf/storage/storage-conf.xml
On peut remarquez les balises < ClusterName >
Cherchez ensuite la balise < Keyspaces >
Normalement, si vous n'avez touché à rien, il existe déjà : < Keyspace Name="Keyspace1" >. Il y est par défaut. Vous pouvez le supprimer mais dans un premier temps je ne vous le conseille pas. Nous allons l'utiliser plus tard.
Plus tard sont définis les ColumnFamily avec leur type suivant si elles vont contenir des Column ou des SuperColumn (ColumnType="Super"). D'autres options sont également mises, mais passons pour cette première approche. Autre fait intéressant : l'élément "CompareWith=" qui dit comment Cassandra va gérer l'organisation des Columns à l'intérieur d'une clef. Pour les SuperColumn on a même : "CompareSubcolumnsWith=" qui régit l'organisation des Column à l'intérieur d'une SuperColumn.
3) Premiers tests
Il est maintenant temps de tester si Cassandra fonctionne bien.
Dans un terminal, placer vous dans le répertoire Cassandra et tapez
bin/cassandra -f
Cela aura pour conséquence de lancer le serveur
Dans un autre terminal, toujours dans le répertoire Cassandra tapez :
bin/cassandra-cli --host locahhost --port 9160
Vous allez vous connecter à votre serveur lancé.
dans votre terminal vous devriez avoir :
Connected to: "Nom de votre Cluster" on localhost/9160
Welcome to cassandra CLI.
Type 'help' or '?' for help. Type 'quit' or 'exit' to quit.
cassandra>
Si tout s'affiche correctement, c'est que tout s'est bien passé.
Vous pouvez taper ? pour voir quelques exemples d'actions à faire comme :
describe keyspace Keyspace1
Qui vous donnera une description de l'ensemble des ColumnFamily contenues dans votre Keyspace.
Vous avez maintenant un serveur Cassandra prêt à fonctionner !
Aucun commentaire:
Enregistrer un commentaire