bilean/doc/source/install.rst

Installation

1. Get Bilean source code from Github

$ cd /opt/stack
$ git clone https://github.com/lvdongbing/bilean.git

2. Install Bilean with required packages

$ cd /opt/stack/bilean
$ sudo pip install -e .

3. Register Bilean service with keystone.

   This can be done using the setup-service script under the tools folder.

$ source ~/devstack/openrc admin
$ cd /opt/stack/bilean/tools
$ ./setup-service <HOST IP> <SERVICE_PASSWORD>

4. Generate configuration file for the Bilean service.

$ cd /opt/stack/bilean
$ tools/gen-config
$ sudo mkdir /etc/bilean
$ sudo cp etc/bilean/api-paste.ini /etc/bilean
$ sudo cp etc/bilean/policy.json /etc/bilean
$ sudo cp etc/bilean/resource_definitions.yaml /etc/bilean
$ sudo cp etc/bilean/bilean.conf.sample /etc/bilean/bilean.conf

Edit file /etc/bilean/bilean.conf according to your system settings. The most common options to be customized include:

[database]
connection = mysql://root:<DB PASSWORD>@127.0.0.1/bilean?charset=utf8

[keystone_authtoken]
auth_uri = http://<HOST>:5000/v3
auth_version = 3
cafile = /opt/stack/data/ca-bundle.pem
identity_uri = http://<HOST>:35357
admin_user = bilean
admin_password = <BILEAN PASSWORD>
admin_tenant_name = service

[authentication]
auth_url = http://<HOST>:5000/v3
service_username = bilean
service_password = <BILEAN PASSWORD>
service_project_name = service

[oslo_messaging_rabbit]
rabbit_userid = <RABBIT USER ID>
rabbit_hosts = <HOST>
rabbit_password = <RABBIT PASSWORD>

5. Create Bilean Database

Create Bilean database using the bilean-db-recreate script under the tools subdirectory.

$ cd /opt/stack/bilean/tools
$ ./bilean-db-recreate <DB PASSWORD>

6. Start bilean engine and api service.

You may need two consoles for the services each.

$ bilean-engine --config-file /etc/bilean/bilean.conf
$ bilean-api --config-file /etc/bilean/bilean.conf