murano/doc/source/install/install-api.rst

Install Murano API

This section describes how to install and configure the Application Catalog service for Ubuntu 16.04 (LTS).

Install and configure components

1. Install the packages:

   # apt-get update
   
   # apt-get install murano-engine murano-api

2. Edit murano.conf with your favorite editor. Below is an example which contains basic settings you likely need to configure.

   Note

   The example below uses SQLite database. Edit [database] section if you want to use any other database type.

   [DEFAULT]
   debug = true
   verbose = true
   rabbit_host = %RABBITMQ_SERVER_IP%
   rabbit_userid = %RABBITMQ_USER%
   rabbit_password = %RABBITMQ_PASSWORD%
   rabbit_virtual_host = %RABBITMQ_SERVER_VIRTUAL_HOST%
   driver = messagingv2
   
   ...
   
   [database]
   connection = mysql+pymysql://murano:MURANO_DBPASS@controller/murano
   
   ...
   
   [keystone]
   auth_url = 'http://%OPENSTACK_HOST_IP%:5000/v2.0'
   
   ...
   
   [keystone_authtoken]
   www_authenticate_uri = 'http://%OPENSTACK_HOST_IP%:5000/v2.0'
   auth_host = '%OPENSTACK_HOST_IP%'
   auth_port = 5000
   auth_protocol = http
   admin_tenant_name = %OPENSTACK_ADMIN_TENANT%
   admin_user = %OPENSTACK_ADMIN_USER%
   admin_password = %OPENSTACK_ADMIN_PASSWORD%
   
   ...
   
   [murano]
   url = http://%YOUR_HOST_IP%:8082
   
   [rabbitmq]
   host = %RABBITMQ_SERVER_IP%
   login = %RABBITMQ_USER%
   password = %RABBITMQ_PASSWORD%
   virtual_host = %RABBITMQ_SERVER_VIRTUAL_HOST%
   
   [networking]
   default_dns = 8.8.8.8 # In case openstack neutron has no default
                         # DNS configured

3. Populate the Murano database:

   # su -s /bin/sh -c "murano-db-manage upgrade" murano

   Note

   Ignore any deprecation messages in this output.

Finalize installation

1. Restart the Application Catalog services:

   # service murano-api restart
   # service murano-engine restart