Getting started - fpaut/cloudeebus GitHub Wiki

Installing Cloudeebus from the project root directory:

sudo python setup.py install

Installed files

The server script and information files are installed in Python's dist-packages folder: /usr/local/lib/python2.7/dist-packages/cloudeebus-0.1-py2.7.egg/

The cloudeebus.py wrapper shell goes in the executables path: /usr/local/bin/cloudeebus.py

Troubleshooting

Cloudeebus needs the Autobahn and Twisted Python frameworks. If not already installed, these components are pulled automatically by the Python setup installer. The Twisted framework builds some of it's own components at installation, so it also needs Python headers. If the install process aborts, make sure these packages are installed.

sudo apt-get install python-setuptools
sudo apt-get install python-argparse
sudo apt-get install python-dev

Running Cloudeebus

cloudeebus.py command-line options

usage: cloudeebus.py [-h] [-d] [-o] [-p PORT] [-c CREDENTIALS] [-w WHITELIST]

Javascript DBus bridge.

optional arguments:
  -h, --help            show this help message and exit
  -d, --debug           log debug info on standard output
  -o, --opendoor        allow anonymous access to all services
  -p PORT, --port PORT  port number
  -c CREDENTIALS, --credentials CREDENTIALS
                        path to credentials file
  -w WHITELIST, --whitelist WHITELIST
                        path to whitelist file

Examples

Running the server in debug mode with no security check

cloudeebus.py --debug --opendoor

Running the server in debug mode with credentials and a whitelist

cloudeebus.py --debug --credentials=./CREDS --whitelist=./LIST

Running two servers with different credentials and whitelists

cloudeebus.py --port=9001 --credentials=./CREDS1 --whitelist=./LIST1
cloudeebus.py --port=9002 --credentials=./CREDS2 --whitelist=./LIST2