Gitiles
Code Review Sign In
asterix-gerrit.ics.uci.edu / asterixdb / fb188dbdc0c9d5e388ca3354cd0ce0c73d9d8905
commitfb188dbdc0c9d5e388ca3354cd0ce0c73d9d8905[log] [tgz]
authorChris Hillery <chillery@lambda.nu>Thu May 26 12:25:09 2016 -0700
committerTill Westmann <tillw@apache.org>Thu May 26 12:58:54 2016 -0700
tree0554754503368f39427d1cda378a573c06e0725e
parentfd7fb5a1002a8ad787d50610893e1bf0e6421ac7 [diff]
ASTERIXDB-1428: Config-management improvements for AsterixDB

1. Added ability for NC Service to log NC output to file
2. Improve config communication from CC to NC
3. Allow overriding NC command name from CC config (and removed said
   option from NC Service config as that's the wrong place to manage it)
4. Improve finding NC command (don't depend on PATH)
5. Create asterixncservice.bat script for Windows
6. Fixed NCServiceIT accordingly

Change-Id: I0f2ad32d489ffc27adbb06aebcc1f22a9fcf784e
Reviewed-on: https://asterix-gerrit.ics.uci.edu/887
Reviewed-by: Jenkins <jenkins@fulliautomatix.ics.uci.edu>
Reviewed-by: Ian Maxon <imaxon@apache.org>
Tested-by: Jenkins <jenkins@fulliautomatix.ics.uci.edu>
Reviewed-by: Till Westmann <tillw@apache.org>
8 files changed
tree: 0554754503368f39427d1cda378a573c06e0725e
  1. .gitattributes
  2. .gitignore
  3. README.md
  4. asterixdb/
  5. build.xml
  6. hyracks-fullstack/
  7. pom.xml
README.md

#AsterixDB

AsterixDB is a BDMS (Big Data Management System) with a rich feature set that sets it apart from other Big Data platforms. Its feature set makes it well-suited to modern needs such as web data warehousing and social data storage and analysis. AsterixDB has:

  • A semistructured NoSQL style data model (ADM) resulting from extending JSON with object database ideas
  • An expressive and declarative query language (AQL) that supports a broad range of queries and analysis over semistructured data
  • A parallel runtime query execution engine, Hyracks, that has been scale-tested on up to 1000+ cores and 500+ disks
  • Partitioned LSM-based data storage and indexing to support efficient ingestion and management of semistructured data
  • Support for query access to externally stored data (e.g., data in HDFS) as well as to data stored natively by AsterixDB
  • A rich set of primitive data types, including spatial and temporal data in addition to integer, floating point, and textual data
  • Secondary indexing options that include B+ trees, R trees, and inverted keyword (exact and fuzzy) index types
  • Support for fuzzy and spatial queries as well as for more traditional parametric queries
  • Basic transactional (concurrency and recovery) capabilities akin to those of a NoSQL store

Learn more about AsterixDB at [http://asterixdb.incubator.apache.org] (http://asterixdb.incubator.apache.org)

##Building AsterixDB

To build AsterixDB from source, you should have a platform with the following:

  • A Unix-ish environment (Linux, OS X, will all do).
  • git
  • Maven 3.1.1 or newer.
  • Java 8 or newer.

Additionally to run all the integration tests you should be running sshd locally, and have passwordless ssh logins enabled for the account which is running the tests.

Instructions for building the master:

  • Checkout AsterixDB master:

      $git clone https://github.com/apache/incubator-asterixdb.git

  • Build AsterixDB master:

      $cd incubator-asterixdb
  $mvn clean package -DskipTests

##Running AsterixDB (on your machine from your build) Here are steps to get AsterixDB running on your machine:

  • Create a directory as the home for AsterixDB installer program, i.e., managix:

      $mkdir ~/managix

  • Copy AsterixDB binary artifact into the installer directory and unzip it:

      $cp asterixdb/asterix-installer/target/asterix-installer-*-binary-assembly.zip ~/managix/
  $cd ~/managix
  $unzip asterix-installer-*-binary-assembly.zip

  • Configure the installer:

      $bin/managix configure

  • Validate if the computer environment is suitable:

      $bin/managix validate

  • Create and start your instance:

      $bin/managix create -n test -c clusters/local/local.xml

  • Good to go and run queries in your browser at:

      http://localhost:19001

  • Read more documentations to learn the data model, query language, and how to create a cluster instance: [https://ci.apache.org/projects/asterixdb/index.html] (https://ci.apache.org/projects/asterixdb/index.html)

##Documentation

AsterixDB's official documentation resides at [https://ci.apache.org/projects/asterixdb/index.html] (https://ci.apache.org/projects/asterixdb/index.html). This is built from the maven project under asterix-doc/ as a maven site. The documentation on the official website refers to the most stable build version, so for pre-release versions one should refer to the compiled documentation.

##Support/Contact

If you have any questions, please feel free to ask on our mailing list, users@asterixdb.incubator.apache.org. Join the list by sending an email to users-subscribe@asterixdb.incubator.apache.org. If you are interested in the internals or developement of AsterixDB, also please feel free to subscribe to our developer mailing list, dev@asterixdb.incubator.apache.org, by sending an email to dev-subscribe@asterixdb.incubator.apache.org.