Installing Manually

Common Steps

double: installing; common_steps

Note

The below operations should take place underneath your <project>/etc folder.

Install system package dependencies (Ubuntu):

$ apt-get install python-pip python-virtualenv
$ apt-get install rabbitmq-server mysql-server
$ apt-get build-dep python-lxml

Clone the BillingStack repo off of Github:

$ git clone https://github.com/billingstack/billingstack.git
$ cd billingstack

Note

This is to not interfere with system packages etc.

$ virtualenv --no-site-packages .venv $ . .venv/bin/activate

Install BillingStack and it's dependencies:

$ pip install -rtools/setup-requires -rtools/pip-requires -rtools/pip-options
$ python setup.py develop

Copy sample configs to usable ones, inside the etc folder do:

$ ls *.sample | while read f; do cp $f $(echo $f | sed "s/.sample$//g"); done

double: installing; central

Note

This is needed because it is the service that the API and others uses to communicate with to do stuff in the Database.

See Common Steps before proceeding.
Configure the central service:

Change the wanted configuration settings to match your environment, the file is in the etc folder:
```
$ vi etc/billingstack.conf
```
Refer to configuration details on configuring the service.
Create the DB for central:
```
$ python tools/resync_billingstack.py
```
Now you might want to load sample data for the time being:
```
$ python tools/dev_samples.py
```
Start the central service:
```
$ billingstack-central
```

Note

This is REQUIRED to be installed on the same machine that has access to the database and that has the billingstack-manage command.

Clone a provider repo off of github:

$ git clone git@github.com:billingstack/billingstack-braintree.git

Install it in the SAME env / venv as the main billingstack package:

$ pip install -rtools/setup-requires -rtools/pip-requires -rtools/pip-options
$ python setup.py develop

double: installing; api

Note

The API Server needs to able to talk via MQ to other services.