The following steps will guide you through setting up and installing Usergrid locally.
Clone the Usergrid repository from github
git clone git://github.com/apigee/usergrid-stack.git
cd into the directory
Build the Usergrid codebase with maven (you can optionally include -DskipTests to speed things up)
Download and install verion 1.0.10 or greater of Apache Cassandra. You can use either the DataStax Community Edition or the tar file from one of the ASF mirros. See the installation and setup instructions at either sites for additional details.
Next, clone this repository
git clone git://github.com/apigee/usergrid-rest-apigee-sample.git
Move into the project directory and build
cd usergrid-rest-apigee-sample && mvn install
Load the ROOT.war file from the target directory created in the step above into your servlet container
Start Apache Cassandra (either via the bin/cassandra script in the case of a tar file install or the service scripts from a packaged install)
Go to the following URL to initialize and setup the Usergrid database (by default, the username and password is superuser:superpass):
After about a minute of setup time, Usergrid should be running on your machine. Your next stop should be the documentation.
To customize the Usergrid installation to your environment, see the properties file located here: http://github.com/zznate/usergrid-rest-apigee-sample/blob/master/src/main/resources/usergrid.properties
Please send any issues or comments to the Usergrid mailing list.
Feel free to add to these instructions at any time by forking and sending a pull request.
Note: the current release of Apache Tomcat - 7.0.29 - is totally hosed (seriously, folks, if it's an obvious bug in the spec just don't implement it). Do not use it. 7.0.26 was used to verify this setup.