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
   transport_url = rabbit://%RABBITMQ_USER%:%RABBITMQ_PASSWORD%@%RABBITMQ_SERVER_IP%:5672/
   
   ...
   
   [database]
   connection = mysql+pymysql://murano:MURANO_DBPASS@controller/murano
   
   ...
   
   [keystone]
   auth_url = http://%OPENSTACK_KEYSTONE_ENDPOINT%
   
   ...
   
   [keystone_authtoken]
   project_domain_name = Default
   project_name = %OPENSTACK_ADMIN_PROJECT%
   user_domain_name = Default
   password = %OPENSTACK_ADMIN_PASSWORD%
   username = %OPENSTACK_ADMIN_USER%
   auth_url = http://%OPENSTACK_KEYSTONE_ENDPOINT%
   auth_type = 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