Get Started
-----------

Grab the latest version by Bitbucket::

    hg clone https://bitbucket.org/mdogy/aurum-master
    cd aurum
    fab -u username -p password localhost kickstart

The last step will perform setup for you, assuming you have given
the proper user credential needed to install packages.

To serve Aurum, you can either serve in development mode, or production mode::

    python pserve development.ini
    python pserve production.ini

Since Aurum is bundled to use GCS, therefore, you should already have
`graphyte-config <https://bitbucket.org/yeukhon/graphyte-config-master>`_
on the machine installed. That repository will setup services and configuration needed
to deploy the Graphyte Project.

Since this assumption holds (it has to), we recommend to serve Aurum in the following ways::

    sudo service graphyte start-aurumdev
    sudo service graphyte start-aurum


Check all the options by tying ``sudo service graphyte help``.

Development mode is blocking. It blocks the current window. With the production mode, it does
not block but ``DEBUG`` and ``INFO`` will continue to print out. So if Aurum has a ``print``
or ``LOG.debug(...)`` statements, all the logging will be printed to screen.