manual setup

EXPERT MODE - manual install from sources

Requirements

• Git to fetch the projects repositories from Github.
• cURL - Windows users can get it here
• A CouchApp deployment tool, for example:
  • CouchApp: the original python command line tool. Instructions are provided to install it on Linux, Mac OS X, Windows (there is a simple installer for Windows)
  • Erica: the new generation of CouchApp deployment. Available only on Linux for the moment.
• A CouchDB instance:
  • You can install one on your own server or your workstation for testing purposes. See http://couchdb.apache.org/#download.
  • The easiest way is to subscribe to a dedicated CouchDB hosting like IrisCouch or Cloudant. Both provide free service for low usage. Cloudant offers a more secured user management but a less recent CouchDB version (fully compatible with Acralyzer though). Because of this security layer, we would recommend using Cloudant as a free hosting service.
  • The build-couchdb project also provides an easy way to build couchdb from its sources.

Get acra-storage and acralyzer projects from Github

Create a directory on your filesystem where you want to store these 2 projects. In this directory, execute the commands:

$ git clone http://github.com/ACRA/acra-storage.git

$ git clone http://github.com/ACRA/acralyzer.git

This creates two directories acra-storage and acralyzer with each project's contents.

Deploy acra-storage

Deploy the first couchapp using the following command lines:

$ cd acra-storage
$ couchapp push http://[login]:[password]@[your.couchdb.host]:[port]/acra-[yourappname]

Replace all [parameters] with the correct values for your situation, for example, let's imagine I work for the company ACME and we develop an Android application called GreatApp. We have subscribed to an IrisCouch hosting with a hostname acme.iriscouch.com. The couchapp push command would look like:

$ couchapp push http://kevingaudin:[email protected]/acra-greatapp

Configure and deploy acralyzer

Edit the file acralyzer/_attachments/script/config.js and update the variable acralyzerConfig.defaultApp with the name of your app. With the previous example, you have to change:

    // Update this variable with the name of your app:
    acralyzerConfig.defaultApp = "storage";

into:

    // Update this variable with the name of your app:
    acralyzerConfig.defaultApp = "greatapp";

Deploy the second couchapp using the following command lines:

$ cd ../acralyzer
$ couchapp push http://[login]:[password]@[your.couchdb.host]:[port]/acralyzer

Replace all the [parameters] with the values for your couchdb instance. With the same example as above, it looks like:

$ couchapp push http://kevingaudin:[email protected]/acralyzer

As a result, a message should be displayed guiding you to the home page of your acralyzer instance.

2013-02-05 23:44:15 [INFO] Visit your CouchApp here:
http://acme.iriscouch.com/acralyzer/_design/acralyzer/index.html

You can already visit this link and see an empty dashboard layout.