orientdb-docs icon indicating copy to clipboard operation
orientdb-docs copied to clipboard

Rexster documentation

Open timseries opened this issue 9 years ago • 4 comments

Hi, thanks for making your graph db available for free. I just finished setting-up Rexster with OrientDB and wanted to point out a few confusing points: https://github.com/orientechnologies/orientdb-docs/wiki/Rexster

  1. "After unzipping the archive, you should copy orient-client.jar and orient-enterprise.jar in $REXSTER_HOME/ext. ". I actually found that I needed to copy ALL of the jar files to $REXSTER_HOME/ext. Also, $REXSTER_HOME is never clearly defined (i.e. as of Rexster 2.7, there is no "ext" directory in the main rexster repository folder).
  2. In the Synopsis, the graph configuration is incorrect: <graph-file>url-to-your-db</graph-file>

it should really be:

<graph-location>url-to-your-db</graph-location>

  1. The database URL is confusing. I've seen several examples citing /tmp/* as the base directory where these database files exist, however this is not true in my 2.0.6 installation. I had to poke around for a while.
  2. In the same snippet,

<graph-type>orientgraph</graph-type>

no longer works for the newest Rexster.

  1. In "Run" "Note: only Rexster 0.5-SNAPSHOT and further releases work with OrientDB GraphEd" is confusing. What is GraphEd?

Also, "you created a Blueprints enabled graph called orientGraph using the class com.tinkerpop.blueprints.pgm.impls.orientdb.OrientGraph". I didn't have to know about this interface in order to create a graph using the Studio and interface to it....

  1. "Be sure that the OrientDB server is running and you have properly configured the location and the access credentials of your graph." Should be
  2. There should be a huge warning somewhere that running Rexster Server to connect to OrientDB using plocal can cause the database file to become corrupted irrevocably. Unfortunately this happened to me several times.

Apologies if any of these are documented elsewhere. I know the orientdb documentation has seen a dramatic overhaul recently and looks very sharp!

timseries avatar May 06 '15 01:05 timseries

Hey @timseries, thank you for this feedback. WDYT about updating that page by yourself to be more understandable by new users ?

lvca avatar May 06 '15 13:05 lvca

I'd be happy to.

timseries avatar May 06 '15 16:05 timseries

Your account is authorized to change docs: https://github.com/orientechnologies/orientdb-docs/wiki ;-)

lvca avatar May 06 '15 20:05 lvca

The corresponding page in the new OrientDB documentation is http://orientdb.com/docs/master/Rexster.html

This page appears outdated. Gremlin Server is now the replacement for Rexster - http://tinkerpop.apache.org/docs/current/reference/#gremlin-server

Adding the enhancement label

santo-it avatar Dec 30 '16 20:12 santo-it