1
0
Fork 0

updated README

This commit is contained in:
Frank Celler 2012-12-05 10:58:04 +01:00
parent 0b8725e2bb
commit 26027346de
4 changed files with 108 additions and 106 deletions

View File

@ -1,6 +1,21 @@
v1.1.0 (XXXX-XX-XX)
v1.1.0 (2012-12-05)
-------------------
* WARNING:
arangod now performs a database version check at startup. It will look for a file
named "VERSION" in its database directory. If the file is not present, arangod will
perform an automatic upgrade of the database directory. This should be the normal
case when upgrading from ArangoDB 1.0 to ArangoDB 1.1.
If the VERSION file is present but is from an older version of ArangoDB, arangod
will refuse to start and ask the user to run a manual upgrade first. A manual upgrade
can be performed by starting arangod with the option `--upgrade`.
This upgrade procedure shall ensure that users have full control over when they
perform any updates/upgrades of their data, and can plan backups accordingly. The
procedure also guarantees that the server is not run without any required system
collections or with in incompatible data state.
* fixed issue #311: fixed segfault on unload
* fixed issue #309: renamed stub "import" button from web interface
@ -49,21 +64,6 @@ v1.1.0 (XXXX-XX-XX)
* added UPGRADING help text
* WARNING:
arangod now performs a database version check at startup. It will look for a file
named "VERSION" in its database directory. If the file is not present, arangod will
perform an automatic upgrade of the database directory. This should be the normal
case when upgrading from ArangoDB 1.0 to ArangoDB 1.1.
If the VERSION file is present but is from an older version of ArangoDB, arangod
will refuse to start and ask the user to run a manual upgrade first. A manual upgrade
can be performed by starting arangod with the option `--upgrade`.
This upgrade procedure shall ensure that users have full control over when they
perform any updates/upgrades of their data, and can plan backups accordingly. The
procedure also guarantees that the server is not run without any required system
collections or with in incompatible data state.
* fixed issue #284: fixed Javascript errors when adding edges/vertices without own
attributes

84
README
View File

@ -33,65 +33,57 @@ For more in-depth information
* or give it a try.
Compilation
For the Impatient
Please check the Installation_Manual for installation and compilation
instructions.
For Mac OSX execute
Mac OS X Hints
brew install arangodb
On Mac OS X you can install ArangoDB using the packagemanager Homebrew:
For Linux use the distribution dependend package manager, see Installation
Manual for details.
For Windows users: we are working hard on a Windows version. A first version
will become available soon.
If the package manager has not already started the ArangoDB server, use
* brew install arangodb (use --HEAD in order to build ArangoDB from current
master)
This will install ArangoDB and all dependencies. Note that the server will be
installed as
/usr/local/sbin/arangod
The ArangoDB shell will be install as
/usr/local/bin/arangosh
First Steps
Start the server:
> /usr/sbin/arangod
unix> /path/to/sbin/arangod
2012-03-30T12:54:19Z [11794] INFO ArangoDB (version 1.x.y) is ready for
business
2012-03-30T12:54:19Z [11794] INFO Have Fun!
Start the shell in another windows:
/path/to/sbin is OS dependent. It will normally by either /usr/sbin or /user/
local/sbin. Point your browser to
> /usr/bin/arangosh
_
__ _ _ __ __ _ _ __ __ _ ___ ___| |__
/ _` | '__/ _` | '_ \ / _` |/ _ \/ __| '_ \
| (_| | | | (_| | | | | (_| | (_) \__ \ | | |
\__,_|_| \__,_|_| |_|\__, |\___/|___/_| |_|
|___/
http://localhost:8529/
Welcome to arangosh 1.x.y. Copyright (c) 2012 triAGENS GmbH.
Using Google V8 3.9.4.0 JavaScript engine.
Using READLINE 6.1.
and select the tab Shell. You can now use the Arango shell from within your
browser. Alternative, it is available as command-line tool arangosh.
Connected to Arango DB 127.0.0.1:8529 Version 1.x.y
arangosh> db._create("hallo");
arangosh> db.hallo.save({ world: "earth" });
arangosh> db._create("examples")
[ArangoCollection 106097, "examples]
Congratulations! You have created your first collection called hallo and your
first document. To verify your achievements
arangosh> db.examples.save({ Hallo: "World" });
{"error":false,"_id":"106097/2333739","_rev":2333739}
arangosh> db.examples.all();
[{ _id : "82883/1524675", _rev : 1524675, Hallo : "World" }]
arangosh> db.hallo.toArray();
Caveat
More Information
Please check the Installation_Manual for installation and compilation
instructions.
The User_Manual has an introductory chapter showing the basic operations of
ArangoDB.
Or you can use the online_tutorial to play with ArangoDB without installing it
locally.
Stay in Contact
Please note that there will be bugs and we'd really appreciate it if you report
them:
https://github.com/triAGENS/ArangoDB/issues
You can use the Google group for improvements, feature requests, comments
http://www.arangodb.org/connect
Please note that this is an early version of ArangoDB. There will be bugs and
we'd really appreciate it if you report them:
https://github.com/triAGENS/ArangoDB/issues

View File

@ -1,4 +1,6 @@
# ArangoDB
ArangoDB
========
[![Build Status](https://secure.travis-ci.org/triAGENS/ArangoDB.png)](http://travis-ci.org/triAGENS/ArangoDB)
ArangoDB is a universal open-source database with flexible data model for documents, graphs, and key-values. Build high performance application using a convenient sql-like query language or JavaScript/Ruby extensions.
@ -20,64 +22,66 @@ For more in-depth information
* read more on the [design goals of ArangoDB](http://www.arangodb.org/2012/03/07/avocadodbs-design-objectives)
* [watch the video](http://vimeo.com/36411892) - Martin Schoenert, architect of ArangoDB, gives an introduction of what the ArangoDB project is about.
* or give it a try.
* or give it a [try](http://www.arangodb.org/try).
## Compilation
Please check the
[Installation Manual](http://www.arangodb.org/manuals/1.0.0/InstallManual.html)
for installation and compilation instructions.
For the Impatient
-----------------
### Mac OS X Hints
For Mac OSX execute
On Mac OS X you can install ArangoDB using the packagemanager [Homebrew](http://mxcl.github.com/homebrew/):
brew install arangodb
* `brew install arangodb` (use `--HEAD` in order to build ArangoDB from current master)
For Linux use the distribution dependend package manager, see
[Installation Manual](http://www.arangodb.org/manuals/current/Installing.html)
for details.
This will install ArangoDB and all dependencies. Note that the server will be installed as
For Windows users: we are working hard on a Windows version. A first version will become available soon.
/usr/local/sbin/arangod
If the package manager has not already started the ArangoDB server, use
The ArangoDB shell will be install as
/usr/local/bin/arangosh
## First Steps
Start the server:
> /usr/sbin/arangod
unix> /path/to/sbin/arangod
2012-03-30T12:54:19Z [11794] INFO ArangoDB (version 1.x.y) is ready for business
2012-03-30T12:54:19Z [11794] INFO Have Fun!
Start the shell in another windows:
`/path/to/sbin` is OS dependent. It will normally by either `/usr/sbin` or `/user/local/sbin`. Point your browser to
> /usr/bin/arangosh
_
__ _ _ __ __ _ _ __ __ _ ___ ___| |__
/ _` | '__/ _` | '_ \ / _` |/ _ \/ __| '_ \
| (_| | | | (_| | | | | (_| | (_) \__ \ | | |
\__,_|_| \__,_|_| |_|\__, |\___/|___/_| |_|
|___/
http://localhost:8529/
Welcome to arangosh 1.x.y. Copyright (c) 2012 triAGENS GmbH.
Using Google V8 3.9.4.0 JavaScript engine.
Using READLINE 6.1.
and select the tab `Shell`. You can now use the Arango shell from within your browser. Alternative, it is available as command-line tool _arangosh_.
Connected to Arango DB 127.0.0.1:8529 Version 1.x.y
arangosh> db._create("hallo");
arangosh> db.hallo.save({ world: "earth" });
arangosh> db._create("examples")
[ArangoCollection 106097, "examples]
Congratulations! You have created your first collection called `hallo` and your first document. To verify your achievements
arangosh> db.examples.save({ Hallo: "World" });
{"error":false,"_id":"106097/2333739","_rev":2333739}
arangosh> db.hallo.toArray();
arangosh> db.examples.all();
[{ _id : "82883/1524675", _rev : 1524675, Hallo : "World" }]
## Caveat
More Information
----------------
Please note that this is an early version of ArangoDB. There will be
bugs and we'd really appreciate it if you report them:
Please check the
[Installation Manual](http://www.arangodb.org/manuals/current/InstallManual.html)
for installation and compilation instructions.
The
[User Manual](http://www.arangodb.org/manuals/current/UserManual.html)
has an introductory chapter showing the basic operations of ArangoDB.
Or you can use the
[online tutorial](http://www.arangodb.org/try)
to play with ArangoDB without installing it locally.
Stay in Contact
---------------
Please note that there will be bugs and we'd really appreciate it if
you report them:
https://github.com/triAGENS/ArangoDB/issues
You can use the Google group for improvements, feature requests, comments
http://www.arangodb.org/connect

View File

@ -222,8 +222,14 @@
/// brew install arangodb
/// @endcode
///
/// This will install the current stable version of ArangoDB within
/// your Homebrew tree.
/// This will install the current stable version of ArangoDB and all dependencies within
/// your Homebrew tree. Note that the server will be installed as
///
/// /usr/local/sbin/arangod
///
/// The ArangoDB shell will be install as
///
/// /usr/local/bin/arangosh
///
/// If you want to install the latest version use:
///