orientdbAan de slag met orientdb


Opmerkingen

Deze sectie geeft een overzicht van wat orientdb is en waarom een ontwikkelaar het misschien wil gebruiken.

Het moet ook alle grote onderwerpen binnen orientdb vermelden en een link naar de gerelateerde onderwerpen. Aangezien de documentatie voor orientdb nieuw is, moet u mogelijk eerste versies van die gerelateerde onderwerpen maken.

Installatie of instellingen

OrientDB is beschikbaar in twee edities:

  • Community-editie is uitgebracht als een open source-project onder de Apache 2-licentie . Deze licentie staat onbeperkt gratis gebruik toe voor zowel open source als commerciële projecten.

  • Enterprise Edition is commerciële software gebouwd bovenop de Community-editie. Enterprise is ontwikkeld door hetzelfde team dat de OrientDB-engine heeft ontwikkeld. Het dient als een uitbreiding van de Community-editie en biedt Enterprise-functies, zoals:

    • Non-stop back-up en herstel
    • Geplande VOLLEDIGE en incrementele back-ups
    • Vraagprofiel
    • Gedistribueerde clusterconfiguratie
    • Statistieken opnemen
    • Live monitoring met configureerbare waarschuwingen

De Community-editie is beschikbaar als een binair pakket om te downloaden of als broncode op GitHub. De Enterprise Edition-licentie is inbegrepen bij ondersteuningsaankopen .

voorwaarden

Beide edities van OrientDB worden uitgevoerd op elk besturingssysteem dat de Java Virtual machine (JVM) implementeert. Voorbeelden hiervan zijn:

  • Linux, alle distributies, inclusief ARM (Raspberry Pi, etc.)
  • Mac OS X
  • Microsoft Windows, vanaf 95 / NT en hoger
  • solaris
  • HP-UX
  • IBM AIX

OrientDB vereist Java , versie 1.7 of hoger.

Opmerking : in OSGi-containers gebruikt OrientDB een ConcurrentLinkedHashMap implementatie die wordt aangeboden door concurrentlinkedhashmap om de op LRU gebaseerde cache te maken. Deze bibliotheek gebruikt actief het sun.misc-pakket dat meestal niet als systeempakket wordt weergegeven. Om deze beperking te omzeilen, moet u eigenschap org.osgi.framework.system.packages.extra met waarde sun.misc aan uw lijst met framework-eigenschappen.

Het kan zo simpel zijn als een argument doorgeven aan de VM die het platform start:

$ java -Dorg.osgi.framework.system.packages.extra=sun.misc

Gebruik Docker

Als Docker op uw computer is geïnstalleerd, is dit de eenvoudigste manier om OrientDB uit te voeren. Vanaf de opdrachtregel:

$ docker run -d –-name orientdb -p 2424:2424 -p 2480:2480
   -e ORIENTDB_ROOT_PASSWORD=root orientdb:latest
 

Waar in plaats van "root", typ het wachtwoord van de root dat u wilt gebruiken.

Binaire installatie

OrientDB biedt een vooraf gecompileerd binair pakket om de database op uw systeem te installeren. Afhankelijk van uw besturingssysteem is dit een geteerd of gecomprimeerd pakket dat alle relevante bestanden bevat die u nodig hebt om OrientDB uit te voeren. Ga voor desktopinstallaties naar OrientDB Downloads en selecteer het pakket dat het beste bij uw systeem past.

Op serverinstallaties kunt u het hulpprogramma wget :

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

Of u nu uw webbrowser of wget , pak het gedownloade bestand uit of pak het uit in een map die handig is voor uw gebruik (bijvoorbeeld /opt/orientdb/ op Linux). Hiermee maakt u een map met de naam orientdb-community-2.2.0 met relevante bestanden en scripts, die u nodig hebt om OrientDB op uw systeem uit te voeren.

Installatie van broncode

Naast het downloaden van de binaire pakketten, kunt u ook OrientDB compileren vanuit de broncode van de Community-editie, beschikbaar op GitHub. Voor dit proces moet u Git en Apache Maven op uw systeem installeren.

Om OrientDB vanuit broncode te compileren, kloon je de Community Edition-repository en voer je Maven ( mvn ) uit in de nieuw gecreëerde map:

$ git clone https://github.com/orientechnologies/orientdb
$ git checkout develop
$ cd orientdb
$ mvn clean install

Het is mogelijk om tests over te slaan:

$ mvn clean install -DskipTests

De develop branch bevat code voor de volgende versie van OrientDB. Stabiele versies zijn getagd op master branch. Voor elke onderhouden versie heeft OrientDB zijn eigen hotfix branch. Op het moment dat deze notities worden geschreven, is de stand van de takken:

  • ontwikkelen: werk in uitvoering voor volgende 3.0.x-release (3.0.x-SNAPSHOT)
  • 2.2.x: hotfix voor de volgende stabiele release van 2.2.x (2.2.x-SNAPSHOT)
  • 2.1.x: hotfix voor de volgende stabiele 2.1.x-release (2.1.x-SNAPSHOT)
  • 2.0.x: hotfix voor de volgende stabiele 2.0.x-release (2.0.x-SNAPSHOT)
  • laatste tag op master is 2.2.0

Het buildproces installeert alle potten in de lokale maven-repository en maakt archieven onder de distribution in de target . Op het moment van schrijven gaf bouwen uit tak 2.1.x:

$ls -l distribution/target/
total 199920
    1088 26 Jan 09:57 archive-tmp
     102 26 Jan 09:57 databases
     102 26 Jan 09:57 orientdb-community-3.0.0-SNAPSHOT.dir
48814386 26 Jan 09:57 orientdb-community-3.0.0-SNAPSHOT.tar.gz
53542231 26 Jan 09:58 orientdb-community-3.0.0-SNAPSHOT.zip
$

De directory orientdb-community-3.0.0-SNAPSHOT.dir bevat de OrientDB-distributie ongecomprimeerd. Bekijk Contribute to OrientDB als je erbij wilt zijn.

Elk distributiepakket bevat een voorbeelddatabase genaamd GratefulDeadConcerts . Het is mogelijk om de database te genereren:

$ cd distribution/
$ mvn  prepare-package
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building OrientDB Community Distribution ...
...
Importing GRAPHML database from ../graphdb/src/test/resources/graph-example-2.xml with options ()...
Done: imported 809 vertices and 8049 edges
Imported in 1141ms. Vertexes: 809

De database wordt gemaakt in de doelmap

$ ls target/databases/
GratefulDeadConcerts/
Machtigingen bijwerken

Voor Linux, Mac OS X en op UNIX gebaseerd besturingssysteem, moet u de machtigingen voor sommige bestanden wijzigen nadat u vanaf de bron hebt gecompileerd.

$ chmod 755 bin/*.sh
$ chmod -R 777 config

Met deze opdrachten worden de uitvoermachtigingen voor bestanden in de config/ directory en shellscripts in bin/ bijgewerkt, zodat u de scripts of programma's kunt uitvoeren die u hebt gecompileerd.

Taken na installatie

Voor desktopgebruikers die het binaire bestand installeren, is OrientDB nu geïnstalleerd en kan het worden uitgevoerd via shellscripts in de bin map van het pakket van de installatie. Voor servers zijn er enkele aanvullende stappen die u moet nemen om de databaseserver voor OrientDB als een service te beheren. De procedure hiervoor varieert, afhankelijk van uw besturingssysteem.

  • Installeren als service op Unix, Linux en Mac OS X
  • Installeren als service op Microsoft Windows

upgrading

Wanneer het tijd is om te upgraden naar een nieuwere versie van OrientDB, variëren de methoden afhankelijk van hoe u ervoor koos om het in de eerste plaats te installeren. Als u hebt geïnstalleerd vanaf binaire downloads, herhaalt u het bovenstaande downloadproces en werkt u symbolische koppelingen of snelkoppelingen bij om naar de nieuwe map te wijzen.

Voor systemen waarbij OrientDB vanuit de bron is gebouwd, haalt u de nieuwste broncode op en compileert u vanuit de bron.

$ git pull origin master
$ mvn clean install

Houd er rekening mee dat wanneer je vanuit de bron bouwt, je met Git van branch kunt wisselen om verschillende versies van OrientDB te bouwen. Bijvoorbeeld,

$ git checkout 2.2.x
$ mvn clean install

bouwt de 2.2.x branch, in plaats van master .

Een enkele uitvoerbare pot bouwen met OrientDB

OrientDB voor interne componenten zoals motoren, operators en fabrieken maakt gebruik van Java SPI Service Provider Interface . Dat betekent dat de potten van OrientDB worden verzonden met bestanden in META-INF/services die de implementatie van componenten bevatten. Houd er rekening mee dat wanneer u een enkele uitvoerbare pot bouwt, u de inhoud van bestanden met dezelfde naam in verschillende orientdb - *. Jar moet samenvoegen. Als u de Maven Shade-plug-in gebruikt , kunt u daarvoor Service Resource Transformer gebruiken.

Andere bronnen

Raadpleeg de onderstaande handleidingen voor meer informatie over het installeren van OrientDB in specifieke omgevingen: