Einführung
OrientDB ist eine NoSQL-Datenbank mit mehreren Modellen und Unterstützung für Grafik- und Dokumentendatenbanken. Es ist eine Java-Anwendung und kann auf jedem Betriebssystem ausgeführt werden. Es ist auch eine vollständige ACID-Beschwerde mit Unterstützung für die Multi-Master-Replikation.
In diesem Artikel erfahren Sie, wie Sie die neueste Community Edition von OrientDB auf einem Ubuntu 14.04-Server installieren und konfigurieren.
Voraussetzungen
Um diesem Tutorial zu folgen, benötigen Sie Folgendes:
-
Ubuntu 14.04 Droplet
-
Nicht-Root-Benutzer mit Sudo-Berechtigungen (Initial Server Setup with Ubuntu 14.04 erklärt, wie dies eingerichtet wird.)
[[Schritt-1 -—- Installation von Oracle-Java]] == Schritt 1 - Installation von Oracle Java
OrientDB ist eine Java-Anwendung, für die Java Version 1.6 oder höher erforderlich ist. Java 8 wird dringend empfohlen, da es viel schneller als Java 6 und 7 ist. Und das ist die Java-Version, die wir in diesem Schritt installieren.
Fügen Sie zum Installieren von Java JRE die folgenden Personal Package Archives (PPA) hinzu:
sudo add-apt-repository ppa:webupd8team/java
Aktualisieren Sie die Paketdatenbank:
sudo apt-get update
Dann installieren Sie Oracle Java. Wenn Sie es mit diesem speziellen Paket installieren, wird es nicht nur installiert, sondern auch zur Standard-Java-JRE. Akzeptieren Sie die Lizenzvereinbarung, wenn Sie dazu aufgefordert werden:
sudo apt-get install oracle-java8-set-default
Stellen Sie nach der Installation sicher, dass es sich nun um die Standard-Java-JRE handelt:
java -version
Die erwartete Ausgabe lautet wie folgt (die genaue Version kann variieren):
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)
[[Schritt-2 - Herunterladen und Installieren von orientdb]] == Schritt 2 - Herunterladen und Installieren von OrientDB
In diesem Schritt laden wir die neueste Community-Edition von OrientDB herunter und installieren sie. Zum Zeitpunkt dieser Veröffentlichung ist OrientDB Community 2.1.3 die neueste Version. Wenn eine neuere Version veröffentlicht wurde, ändern Sie die Versionsnummer entsprechend:
wget https://orientdb.com/download.php?file=orientdb-community-2.1.3.tar.gz
Der heruntergeladene Tarball enthält vorkompilierte Binärdateien, die Sie zum Ausführen von OrientDB auf Ihrem System benötigen. Sie müssen ihn also nur in ein geeignetes Verzeichnis entpacken. Da/opt
der traditionelle Speicherort für Programme von Drittanbietern unter Linux ist, entpacken wir es dort:
sudo tar -xf download.php?file=orientdb-community-2.1.3.tar.gz -C /opt
Die Dateien werden in ein Verzeichnis mit dem Namenorientdb-community-2.1.3
extrahiert. Um die Arbeit zu erleichtern, benennen wir sie um:
sudo mv /opt/orientdb-community-2.1.3 /opt/orientdb
[[Schritt 3 - Starten des Servers]] == Schritt 3 - Starten des Servers
Nachdem die Binärdatei installiert ist, können Sie den Server starten und eine Verbindung zur Konsole herstellen. Navigieren Sie zuvor zum Installationsverzeichnis:
cd /opt/orientdb
Dann starte den Server:
sudo bin/server.sh
Abgesehen davon, dass Sie eine Reihe von Ausgaben generieren, werden Sie beim ersten Starten des Servers aufgefordert, ein Kennwort für das Benutzerkonto vonrootanzugeben. Dies ist ein internes OrientDB-Konto, mit dem auf den Server zugegriffen wird. Dies ist beispielsweise die Kombination aus Benutzername und Kennwort, die für den Zugriff auf OrientDB Studio verwendet wird, die webbasierte Oberfläche zur Verwaltung von OrientDB. Wenn Sie kein Passwort angeben, wird automatisch eines generiert. Es ist jedoch am besten, wenn Sie selbst eine angeben, wenn Sie dazu aufgefordert werden.
Ein Teil der Ausgabe, die beim Starten des Servers generiert wird, gibt an, welche Ports der Server und OrientDB Studio abhören:
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]
Da OrientDB jetzt in Ihrem Terminalfenster ausgeführt wird, überprüfen Sie in einem zweiten Terminalfenster für dasselbe Droplet, ob der Server die Ports 2424 (für binäre Verbindungen) und 2480 (für HTTP-Verbindungen) überwacht. Führen Sie Folgendes aus, um zu bestätigen, dass es auf Binärverbindungen wartet:
sudo netstat -plunt | grep 2424
Die Ausgabe sollte ungefähr so aussehen
Outputtcp6 0 0 :::2424 :::* LISTEN 1617/java
Führen Sie die folgenden Schritte aus, um zu bestätigen, dass HTTP-Verbindungen abgehört werden:
sudo netstat -plunt | grep 2480
Die erwartete Ausgabe lautet wie folgt:
Outputtcp6 0 0 :::2480 :::* LISTEN 1617/java
[[Schritt 4 - Verbindung zur Konsole herstellen]] == Schritt 4 - Verbindung zur Konsole herstellen
Nachdem der Server ausgeführt wird, können Sie über die Konsole, dh die Befehlszeilenschnittstelle, eine Verbindung herstellen:
sudo /opt/orientdb/bin/console.sh
Sie werden folgendes sehen:
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>
Stellen Sie nun eine Verbindung zur Serverinstanz her. Das erforderliche Kennwort ist dasjenige, das Sie angegeben haben, als Sie den Server zuvor zum ersten Mal gestartet haben:
connect remote:127.0.0.1 root root-password
Wenn verbunden, sollte der Ausgang sein:
OutputConnecting to remote Server instance [remote:127.0.0.1] with user 'root'...OK
orientdb {server=remote:127.0.0.1/}>
Geben Sieexit
ein, um das Programm zu beenden:
exit
Sie haben OrientDB also gerade installiert, manuell gestartet und eine Verbindung hergestellt. Das ist alles gut. Es bedeutet jedoch auch, dass Sie es jedes Mal manuell starten, wenn Sie den Server neu starten. Das ist nicht gut. In den nächsten Schritten konfigurieren und konfigurieren wir OrientDB so, dass es wie jeder andere Dämon auf dem Server ausgeführt wird.
Geben SieCTRL-C
in das Terminalfenster ein, während OrientDB noch ausgeführt wird, um es zu stoppen.
[[Schritt-5 - Konfigurieren von Orientdb]] == Schritt 5 - Konfigurieren von OrientDB
Zu diesem Zeitpunkt ist OrientDB auf Ihrem System installiert, es handelt sich jedoch nur um eine Reihe von Skripten auf dem Server. In diesem Schritt ändern wir die Konfigurationsdatei und konfigurieren sie so, dass sie als Daemon auf dem System ausgeführt wird. Dazu müssen Sie das Skript/opt/orientdb/bin/orientdb.sh
und die Konfigurationsdatei/opt/orientdb/config/orientdb-server-config.xml
ändern.
Beginnen wir damit, das Skript/opt/orientdb/bin/orientdb.sh
zu ändern, um OrientDB den Benutzer mitzuteilen, unter dem es ausgeführt werden soll, und um es auf das Installationsverzeichnis zu verweisen.
Erstellen Sie zunächst den Systembenutzer, unter dem OrientDB ausgeführt werden soll. Der Befehl erstellt auch die Gruppeorientdb:
sudo useradd -r orientdb -s /bin/false
Geben Sie dem neu erstellten OrientDB-Benutzer und der neu erstellten OrientDB-Gruppe den Besitz des OrientDB-Verzeichnisses und der Dateien:
sudo chown -R orientdb:orientdb /opt/orientdb
Nehmen wir nun einige Änderungen am Skriptorientdb.sh
vor. Wir öffnen es zunächst mit:
sudo nano /opt/orientdb/bin/orientdb.sh
Zuerst müssen wir es auf das richtige Installationsverzeichnis verweisen und ihm dann mitteilen, unter welchem Benutzer es ausgeführt werden soll. Suchen Sie daher oben in der Datei nach den folgenden zwei Zeilen:
/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"
Und ändern Sie sie in:
/opt/orientdb/bin/orientdb.sh# You have to SET the OrientDB installation directory here
ORIENTDB_DIR="/opt/orientdb"
ORIENTDB_USER="orientdb"
Lassen Sie uns nun dem Systembenutzer ermöglichen, das Skript mitsudo
auszuführen.
Suchen Sie weiter unten unter der Funktionstart des Skripts nach der folgenden Zeile und kommentieren Sie sie aus, indem Sie das Zeichen#
davor hinzufügen. Es muss wie folgt aussehen:
/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
Kopieren Sie die folgende Zeile und fügen Sie sie direkt nach der gerade auskommentierten ein:
/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 &"
Suchen Sie unter der Funktionstop nach der folgenden Zeile und kommentieren Sie sie ebenfalls aus. Es muss wie abgebildet aussehen.
/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
Kopieren Sie die folgende Zeile und fügen Sie sie direkt nach der gerade auskommentierten ein:
/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 &"
Speichern und schließen Sie die Datei.
Öffnen Sie als Nächstes die Konfigurationsdatei:
sudo nano /opt/orientdb/config/orientdb-server-config.xml
Wir werden dasstorages-Tag ändern und optional einen weiteren Benutzer zumusers-Tag hinzufügen. Scrollen Sie also zumstorages-Element und ändern Sie es so, dass es wie folgt lautet. Dieusername undpassword sind Ihre Anmeldeinformationen, dh diejenigen, mit denen Sie sich bei Ihrem Server angemeldet haben:
/opt/orientdb/config/orientdb-server-config.xml
Wenn Sie zum Tagusers scrollen, sollten Sie den Benutzernamen und das Kennwort des Root-Benutzers sehen, den Sie beim ersten Start des OrientDB-Servers in Schritt 3 angegeben haben. Ebenfalls aufgeführt wird ein Gastkonto. Sie müssen keine weiteren Benutzer hinzufügen, aber wenn Sie möchten, können Sie den Benutzernamen und das Kennwort hinzufügen, mit denen Sie sich bei Ihrem DigitalOcean-Server angemeldet haben. Im Folgenden finden Sie ein Beispiel für das Hinzufügen eines Benutzers zum Tagusers:
/opt/orientdb/config/orientdb-server-config.xml
Speichern und schließen Sie die Datei.
Ändern Sie abschließend die Berechtigungen der Datei, um zu verhindern, dass nicht autorisierte Benutzer sie lesen:
sudo chmod 640 /opt/orientdb/config/orientdb-server-config.xml
[[Schritt 6 - Installieren des Startskripts]] == Schritt 6 - Installieren des Startskripts
Nachdem die Skripte konfiguriert wurden, können Sie sie in die entsprechenden Systemverzeichnisse kopieren. Kopieren Sie das für die Ausführung der Konsole verantwortliche Skript in das Verzeichnis/usr/bin
:
sudo cp /opt/orientdb/bin/console.sh /usr/bin/orientdb
Kopieren Sie dann das Skript zum Starten und Stoppen des Dienstes oder Dämons in das Verzeichnis/etc/init.d
:
sudo cp /opt/orientdb/bin/orientdb.sh /etc/init.d/orientdb
Wechseln Sie in das Verzeichnis/etc/init.d
:
cd /etc/init.d
Aktualisieren Sie dann das Verzeichnisrc.d
, sodass das System das neue Skript kennt und es beim Booten genau wie die anderen Systemdämonen startet.
sudo update-rc.d orientdb defaults
Sie sollten die folgende Ausgabe erhalten:
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
[[Schritt-7 -—- Starten-Orientdb]] == Schritt 7 - Starten von OrientDB
Wenn alles eingerichtet ist, können Sie den Dienst jetzt starten:
sudo service orientdb start
Stellen Sie sicher, dass es wirklich begonnen hat:
sudo service orientdb status
Sie können auch die Befehlenetstat
aus Schritt 3 verwenden, um zu überprüfen, ob der Server die Ports überwacht. Wenn der Server nicht gestartet wird, suchen Sie in der Fehlerprotokolldatei im Verzeichnis/opt/orientdb/log
nach Hinweisen.
[[Schritt-8 -—- Verbindung zu orientdb-studio herstellen]] == Schritt 8 - Verbindung zu OrientDB Studio herstellen
OrientDB Studio ist das Webinterface zur Verwaltung von OrientDB. Standardmäßig überwacht es Port 2480. Um eine Verbindung herzustellen, öffnen Sie Ihren Browser und geben Sie Folgendes in die Adressleiste ein:
http://server-ip-address:2480
Wenn die Seite geladen wird, sollte der Anmeldebildschirm angezeigt werden. Sie sollten sich alsroot
und das zuvor festgelegte Passwort anmelden können.
Wenn die Seite nicht geladen wird, liegt dies wahrscheinlich daran, dass sie von der Firewall blockiert wird. Daher müssen Sie der Firewall eine Regel hinzufügen, um OrientDB-Datenverkehr auf Port 2480 zuzulassen. Öffnen Sie dazu die IPTables-Firewall-Regeldatei für IPv4-Datenverkehr:
sudo /etc/iptables/rules.v4
Fügen Sie innerhalb derINPUT-Kette die folgende Regel hinzu:
/etc/iptables/rules.v4-A INPUT -p tcp --dport 2480 -j ACCEPT
Iptables neu starten:
sudo service iptables-persistent reload
Das sollte es für die Verbindung mit dem OrientDB Studio tun.
Fazit
Herzliche Glückwünsche! Sie haben gerade die Community Edition von OrientDB auf Ihrem Server installiert. Weitere Informationen finden Sie in den ArtikelnHow To Back Up Your OrientDB Databases on Ubuntu 14.04 undHow To Import and Export an OrientDB Database on Ubuntu 14.04.
Weitere Informationen und offizielle Links zur OrientDB-Dokumentation finden Sie unterorientdb.com.