7575785accf54f0a1bf0857c9add6365f44d386e - asterixdb

commit	7575785accf54f0a1bf0857c9add6365f44d386e	[log] [tgz]
author	Abdullah Alamoudi <bamousaa@gmail.com>	Fri Jul 22 20:52:47 2016 +0300
committer	abdullah alamoudi <bamousaa@gmail.com>	Fri Jul 22 12:35:47 2016 -0700
tree	f821651d768c5d1ef36869426bc9d549e40924dd
parent	973a0d34e36de2fb950f4979843b3bef9f1f992d [diff]

Add Test NodeController, Test Data Generator, and Marker Logs

This test enable creating a node controller for unit test purposes.
The Node controller is identical to the regular node controller
except that it doesn't communicate with a cluster controller at all.

In this change, Test Data Generator is introduced which should
facilitate writing unit test cases which requires data generation.
The change also includes enabling feeds to send progress data. progress
information can then be sent through the pipeline and persisted in the
transaction logs and primary index component. A Unit test case has
been created to test adding progress markers to logs and index
components and then reading them.

The last part of this change is the addition of marker logs and their
callbacks. They enable components to create arbitrary logs and get a
callback when they are written to the transaction logs. Initial set of
unit tests were added for marker logs.

Change-Id: I3b9aa8de758b7d26ca34868b16e5ce693e0c0243
Reviewed-on: https://asterix-gerrit.ics.uci.edu/962
Tested-by: Jenkins <jenkins@fulliautomatix.ics.uci.edu>
Integration-Tests: Jenkins <jenkins@fulliautomatix.ics.uci.edu>
Reviewed-by: Michael Blow <mblow@apache.org>
Reviewed-by: abdullah alamoudi <bamousaa@gmail.com>

82 files changed

tree: f821651d768c5d1ef36869426bc9d549e40924dd

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, Apache 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.apache.org] (http://asterixdb.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/asterixdb.git

Build AsterixDB master:

  $cd 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.apache.org. Join the list by sending an email to users-subscribe@asterixdb.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.apache.org, by sending an email to dev-subscribe@asterixdb.apache.org.