TOC

Comment installer et configurer OrientDB sur Ubuntu 14.04

introduction

OrientDB est une base de données NoSQL multimodèle prenant en charge les bases de données graphiques et documentaires. C'est une application Java et peut être exécuté sur n'importe quel système d'exploitation. C’est également une plainte ACID intégrant la prise en charge de la réplication multi-maîtres.

Dans cet article, vous apprendrez à installer et à configurer la dernière version de OrientDB Community Edition sur un serveur Ubuntu 14.04.

Conditions préalables

Pour suivre ce tutoriel, vous aurez besoin des éléments suivants:

[[step-1 -—- Installing-oracle-java]] == Étape 1 - Installation d'Oracle Java

OrientDB est une application Java nécessitant Java version 1.6 ou supérieure. Comme il est beaucoup plus rapide que Java 6 et 7, Java 8 est vivement recommandé. Et c’est la version de Java que nous installerons à cette étape.

Pour installer Java JRE, ajoutez les archives de packages personnels (PPA) suivantes: 

sudo add-apt-repository ppa:webupd8team/java

Mettre à jour la base de données de paquets: 

sudo apt-get update

Ensuite, installez Oracle Java. L'installer à l'aide de ce paquet particulier l'installe, mais en fait également le JRE Java par défaut. A l'invite, acceptez le contrat de licence: 

sudo apt-get install oracle-java8-set-default

Après l’avoir installé, vérifiez que c’est bien le JRE Java par défaut: 

java -version

La sortie attendue est la suivante (la version exacte peut varier): 

outputjava version "1.8.0_60"
Java(TM) SE Runtime Environment (build 1.8.0_60-b27)
Java HotSpot(TM) 64-Bit Server VM (build 25.60-b23, mixed mode)

[[step-2 -—- téléchargement-et-installation-orientdb]] == Étape 2 - Téléchargement et installation d'OrientDB

Dans cette étape, nous allons télécharger et installer la dernière version de OrientDB Community. Au moment de cette publication, OrientDB Community 2.1.3 est la dernière version. Si une nouvelle version a été publiée, changez le numéro de version pour qu'il corresponde à: 

wget https://orientdb.com/download.php?file=orientdb-community-2.1.3.tar.gz

L'archive tar téléchargée contient des fichiers binaires précompilés dont vous avez besoin pour exécuter OrientDB sur votre système. Il vous suffit donc de les désarchiver dans un répertoire approprié. Le/opt étant l'emplacement traditionnel des programmes tiers sous Linux, décompressons-le ici: 

sudo tar -xf download.php?file=orientdb-community-2.1.3.tar.gz -C /opt

Les fichiers sont extraits dans un répertoire nomméorientdb-community-2.1.3. Pour faciliter le travail, renommons-le: 

sudo mv /opt/orientdb-community-2.1.3 /opt/orientdb

[[step-3 -—- starting-the-server]] == Étape 3 - Démarrage du serveur

Maintenant que le fichier binaire est en place, vous pouvez démarrer le serveur et vous connecter à la console. Avant cela, accédez au répertoire d'installation: 

cd /opt/orientdb

Puis démarrez le serveur: 

sudo bin/server.sh

En plus de générer un tas de résultats, en démarrant le serveur pour la première fois, vous serez invité à spécifier un mot de passe pour le compte utilisateurroot. Ceci est un compte interne OrientDB qui sera utilisé pour accéder au serveur. Par exemple, il s’agit de la combinaison nom d’utilisateur / mot de passe qui sera utilisée pour accéder à OrientDB Studio, l’interface Web de gestion d’OrientDB. Si vous ne spécifiez pas de mot de passe, celui-ci sera généré automatiquement. Cependant, il vaut mieux en spécifier un vous-même, faites-le lorsque vous y êtes invité.

Une partie de la sortie générée à partir du démarrage du serveur vous indique les ports sur lesquels le serveur et OrientDB Studio écoutent: 

Output2015-10-12 11:27:45:095 INFO  Databases directory: /opt/orientdb/databases [OServer]
2015-10-12 11:27:45:263 INFO  Listening binary connections on 0.0.0.0:2424 (protocol v.32, socket=default) [OServerNetworkListener]
2015-10-12 11:27:45:285 INFO  Listening http connections on 0.0.0.0:2480 (protocol v.10, socket=default) [OServerNetworkListener]

...

2015-10-12 11:27:45:954 INFO  OrientDB Server v2.1.3 (build UNKNOWN@r; 2015-10-04 10:56:30+0000) is active. [OServer]

Comme OrientDB s’exécute maintenant dans la fenêtre de votre terminal, dans une deuxième fenêtre du même Droplet, vérifiez que le serveur est à l’écoute sur les ports 2424 (pour les connexions binaires) et 2480 (pour les connexions HTTP). Pour confirmer l’écoute des connexions binaires, exécutez: 

sudo netstat -plunt | grep 2424

La sortie devrait ressembler à 

Outputtcp6       0      0 :::2424                 :::*                    LISTEN      1617/java

Pour confirmer l’écoute des connexions HTTP, exécutez: 

sudo netstat -plunt | grep 2480

La sortie attendue est la suivante: 

Outputtcp6       0      0 :::2480                 :::*                    LISTEN      1617/java

[[step-4 -—- connection-to-the-console]] == Étape 4 - Connexion à la console

Maintenant que le serveur est en cours d'exécution, vous pouvez vous y connecter à l'aide de la console, c'est-à-dire de l'interface de ligne de commande: 

sudo /opt/orientdb/bin/console.sh

Vous verrez ce qui suit: 

OutputOrientDB console v.2.1.3 (build UNKNOWN@r; 2015-10-04 10:56:30+0000) www.orientdb.com
Type 'help' to display all the supported commands.
Installing extensions for GREMLIN language v.2.6.0

orientdb>

Maintenant, connectez-vous à l'instance du serveur. Le mot de passe requis est celui que vous avez spécifié lors du premier démarrage du serveur précédemment: 

connect remote:127.0.0.1 root root-password

Si connecté, la sortie devrait être: 

OutputConnecting to remote Server instance [remote:127.0.0.1] with user 'root'...OK
orientdb {server=remote:127.0.0.1/}>

Tapezexit pour quitter: 

exit

Vous venez donc d’installer OrientDB, de le démarrer manuellement et de vous y connecter. C’est tout bon. Cependant, cela signifie également que vous devez le démarrer manuellement chaque fois que vous redémarrez le serveur. Ce n'est pas bon. Dans les étapes suivantes, nous allons configurer et configurer OrientDB pour s’exécuter comme tout autre démon sur le serveur.

TapezCTRL-C dans la fenêtre du terminal avec OrientDB toujours en cours d'exécution pour l'arrêter.

[[step-5 -—- configuring-orientdb]] == Étape 5 - Configuration d'OrientDB

À ce stade, OrientDB est installé sur votre système, mais il ne s’agit que de plusieurs scripts sur le serveur. Dans cette étape, nous allons modifier le fichier de configuration et le configurer pour qu'il s'exécute en tant que démon sur le système. Cela implique de modifier le script/opt/orientdb/bin/orientdb.sh et le fichier de configuration/opt/orientdb/config/orientdb-server-config.xml.

Commençons par modifier le script/opt/orientdb/bin/orientdb.sh pour indiquer à OrientDB l'utilisateur sous lequel il doit être exécuté et le pointer vers le répertoire d'installation.

Donc, créez d’abord l’utilisateur système sous lequel vous voulez que OrientDB s’exécute. La commande créera également le groupeorientdb: 

sudo useradd -r orientdb -s /bin/false

Attribuez la propriété du répertoire OrientDB et des fichiers à l'utilisateur et au groupe OrientDB nouvellement créés: 

sudo chown -R orientdb:orientdb /opt/orientdb

Apportons maintenant quelques modifications au scriptorientdb.sh. Nous commençons par l'ouvrir en utilisant: 

sudo nano /opt/orientdb/bin/orientdb.sh

Tout d’abord, nous devons le diriger vers le répertoire d’installation approprié, puis lui indiquer sous quel utilisateur il doit être exécuté. Recherchez donc les deux lignes suivantes en haut du fichier: 

/opt/orientdb/bin/orientdb.sh# You have to SET the OrientDB installation directory here
ORIENTDB_DIR="YOUR_ORIENTDB_INSTALLATION_PATH"
ORIENTDB_USER="USER_YOU_WANT_ORIENTDB_RUN_WITH"

Et changez les en: 

/opt/orientdb/bin/orientdb.sh# You have to SET the OrientDB installation directory here
ORIENTDB_DIR="/opt/orientdb"
ORIENTDB_USER="orientdb"

Maintenant, permettons à l'utilisateur système d'exécuter le script à l'aide desudo.

Plus bas, sous la fonctionstart du script, recherchez la ligne suivante et commentez-la en ajoutant le caractère# devant elle. Il doit apparaître comme indiqué: 

/opt/orientdb/bin/orientdb.sh#su -c "cd \"$ORIENTDB_DIR/bin\"; /usr/bin/nohup ./server.sh 1>../log/orientdb.log 2>../log/orientdb.err &" - $ORIENTDB_USER

Copiez et collez la ligne suivante juste après celle que vous venez de commenter: 

/opt/orientdb/bin/orientdb.shsudo -u $ORIENTDB_USER sh -c "cd \"$ORIENTDB_DIR/bin\"; /usr/bin/nohup ./server.sh 1>../log/orientdb.log 2>../log/orientdb.err &"

Sous la fonctionstop, recherchez la ligne suivante et commentez-la également. Il doit apparaître comme indiqué. 

/opt/orientdb/bin/orientdb.sh#su -c "cd \"$ORIENTDB_DIR/bin\"; /usr/bin/nohup ./shutdown.sh 1>>../log/orientdb.log 2>>../log/orientdb.err &" - $ORIENTDB_USER

Copiez et collez la ligne suivante juste après celle que vous venez de commenter: 

/opt/orientdb/bin/orientdb.shsudo -u $ORIENTDB_USER sh -c "cd \"$ORIENTDB_DIR/bin\"; /usr/bin/nohup ./shutdown.sh 1>>../log/orientdb.log 2>>../log/orientdb.err &"

Enregistrez et fermez le fichier.

Ensuite, ouvrez le fichier de configuration: 

sudo nano /opt/orientdb/config/orientdb-server-config.xml

Nous allons modifier la balisestorages et, éventuellement, ajouter un autre utilisateur à la baliseusers. Faites donc défiler jusqu'à l'élémentstorages et modifiez-le pour qu'il se lise comme suit. Lesusername etpassword sont vos identifiants de connexion, c'est-à-dire ceux que vous avez utilisés pour vous connecter à votre serveur: 

/opt/orientdb/config/orientdb-server-config.xml

Si vous faites défiler jusqu'à la baliseusers, vous devriez voir le nom d'utilisateur et le mot de passe de l'utilisateur root que vous avez spécifié lorsque vous démarrez le serveur OrientDB pour la première fois à l'étape 3. Aussi répertorié sera un compte invité. Vous n'avez pas besoin d'ajouter d'autres utilisateurs, mais si vous le souhaitez, vous pouvez ajouter le nom d'utilisateur et le mot de passe que vous avez utilisés pour vous connecter à votre serveur DigitalOcean. Voici un exemple de comment ajouter un utilisateur dans la baliseusers: 

/opt/orientdb/config/orientdb-server-config.xml

Enregistrez et fermez le fichier.

Enfin, modifiez les autorisations du fichier pour empêcher les utilisateurs non autorisés de le lire: 

sudo chmod 640 /opt/orientdb/config/orientdb-server-config.xml

[[step-6 -—- Installing-the-startup-script]] == Étape 6 - Installation du script de démarrage

Maintenant que les scripts ont été configurés, vous pouvez maintenant les copier dans leurs répertoires système respectifs. Pour le script responsable de l'exécution de la console, copiez-le dans le répertoire/usr/bin: 

sudo cp /opt/orientdb/bin/console.sh /usr/bin/orientdb

Copiez ensuite le script responsable du démarrage et de l'arrêt du service ou du démon dans le répertoire/etc/init.d: 

sudo cp /opt/orientdb/bin/orientdb.sh /etc/init.d/orientdb

Accédez au répertoire/etc/init.d: 

cd /etc/init.d

Ensuite, mettez à jour le répertoirerc.d afin que le système soit conscient du nouveau script et le lancera au démarrage comme les autres démons système. 

sudo update-rc.d orientdb defaults

Vous devriez obtenir le résultat suivant: 

Outputupdate-rc.d: warning: /etc/init.d/orientdb missing LSB information
update-rc.d: see 
 Adding system startup for /etc/init.d/orientdb ...
   /etc/rc0.d/K20orientdb -> ../init.d/orientdb
   /etc/rc1.d/K20orientdb -> ../init.d/orientdb
   /etc/rc6.d/K20orientdb -> ../init.d/orientdb
   /etc/rc2.d/S20orientdb -> ../init.d/orientdb
   /etc/rc3.d/S20orientdb -> ../init.d/orientdb
   /etc/rc4.d/S20orientdb -> ../init.d/orientdb
   /etc/rc5.d/S20orientdb -> ../init.d/orientdb

[[step-7 -—- starting-orientdb]] == Étape 7 - Démarrage d'OrientDB

Avec tout en place, vous pouvez maintenant démarrer le service: 

sudo service orientdb start

Vérifiez que cela a vraiment commencé: 

sudo service orientdb status

Vous pouvez également utiliser les commandesnetstat de l'étape 3 pour vérifier que le serveur écoute sur les ports. Si le serveur ne démarre pas, recherchez des indices dans le fichier journal des erreurs du répertoire/opt/orientdb/log.

[[step-8 -—- connection-to-orientdb-studio]] == Étape 8 - Connexion à OrientDB Studio

OrientDB Studio est l'interface Web permettant de gérer OrientDB. Par défaut, il écoute sur le port 2480. Pour vous y connecter, ouvrez votre navigateur et tapez ce qui suit dans la barre d'adresse: 

http://server-ip-address:2480

Si la page se charge, vous devriez voir l'écran de connexion. Vous devriez pouvoir vous connecter en tant queroot et avec le mot de passe que vous avez défini précédemment.

Si la page ne se charge pas, c'est probablement parce qu'elle est bloquée par le pare-feu. Vous devrez donc ajouter une règle au pare-feu pour autoriser le trafic OrientDB sur le port 2480. Pour ce faire, ouvrez le fichier de règles de pare-feu IPTables pour le trafic IPv4: 

sudo /etc/iptables/rules.v4

Dans la chaîneINPUT, ajoutez la règle suivante: 

/etc/iptables/rules.v4-A INPUT -p tcp --dport 2480 -j ACCEPT

Redémarrez iptables: 

sudo service iptables-persistent reload

Cela devrait le faire pour la connexion à OrientDB Studio.

Conclusion

Toutes nos félicitations! Vous venez d’installer l’édition Community de OrientDB sur votre serveur. Pour en savoir plus, consultez les articlesHow To Back Up Your OrientDB Databases on Ubuntu 14.04 etHow To Import and Export an OrientDB Database on Ubuntu 14.04.

Plus d'informations et les liens de documentation officiels d'OrientDB peuvent être trouvés surorientdb.com.

Related