bufunfa/doc/source/install.rst
2012-11-03 00:46:29 +01:00

3.4 KiB

Install

bufunfa is comprised of three components for more info on these please consolidate :architecture:.

Note

bufunfa makes extensive use of the messaging bus, but has not yet been tested with ZeroMQ. We recommend using Rabbit or qpid for now.

From Packages

From Source / GIT

Common steps

double: installing; rename_configs

Note

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

** Renaming configuration files is easy if you want to do it one by one then

do:: $ mv bufunfa-central.conf.sample bufunfa-central.conf

** You can also do it in one swoop::

$ rename 's/.sample$//' *.sample

Installing the Central

double: installing; central

  1. Clone the bufunfa repo off of github:: $ cd /opt/stack $ git clone https://github.com/ekarlso/bufunfa.git

  2. As a user with root permissions or sudo privileges, run the bufunfa installer:: $ cd bufunfa $ sudo python setup.py install

  3. See :rename_configs:

  4. Configure the central service

    Change the wanted configuration settings to match your environment :: $ vi bufunfa-central.conf

    Refer to configuration details on configuring the service.

  5. Start the central service:: $ bufunfa-central

Installing the Recorder ====================

double: installing; recorder

  1. Clone the bufunfa repo off of github:: $ cd /opt/stack $ git clone https://github.com/ekarlso/bufunfa.git

  2. As a user with root permissions or sudo privileges, run the bufunfa installer:: $ cd bufunfa $ sudo python setup.py install

  3. See :rename_configs:

  4. Configure the recorder service

    Change the wanted configuration settings to match your environment :: $ vi bufunfa-recorder.conf

    Refer to configuration details on configuring the service.

  5. Start the Recorder service:: $ bufunfa-recorder

Installing the API

double: installing; api

Note

The API Server needs to able to talk to Keystone for AuthN + Z and communicates via MQ to other services.

  1. Clone the bufunfa repo off of github:: $ cd /opt/stack $ git clone https://github.com/ekarlso/bufunfa.git

  2. As a user with root permissions or sudo privileges, run the bufunfa installer:: $ cd bufunfa $ sudo python setup.py install

  3. See :rename_configs:

  4. Configure the api service

    Change the wanted configuration settings to match your environment :: $ vi bufunfa-api.conf $ vi bufunfa-api-paste.ini

    Refer to configuration details on configuring the service.

  5. Start the API service:: $ bufunfa-api