deb-murano/install-guide/source/common_prerequisites.rst

Prerequisites

Before you install and configure the Application Catalog service, you must create a database, service credentials, and API endpoints.

1. To create the database, complete these steps:

   Murano can use various database types on the back end. For development purposes, SQLite is enough in most cases. For production installations, you should use MySQL or PostgreSQL databases.

   Warning

   Although murano could use a PostgreSQL database on the back end, it wasn't thoroughly tested and should be used with caution.

   • Use the database access client to connect to the database server as the root user:

     $ mysql -u root -p

   • Create the murano database:

     CREATE DATABASE murano;

   • Grant proper access to the murano database:

     GRANT ALL PRIVILEGES ON murano.* TO 'murano'@'localhost' IDENTIFIED BY 'MURANO_DBPASS';

     Replace MURANO_DBPASS with a suitable password.

   • Exit the database access client.

     exit;

2. Source the admin credentials to gain access to admin-only CLI commands:

   $ . admin-openrc

3. To create the service credentials, complete these steps:

   • Create the murano user:

     $ openstack user create --domain default --password-prompt murano

   • Add the admin role to the murano user:

     $ openstack role add --project service --user murano admin

   • Create the murano service entities:

     $ openstack service create --name murano --description "Application Catalog" application-catalog

4. Create the Application Catalog service API endpoints:

   $ openstack endpoint create --region RegionOne \
     application-catalog public http://<murano-ip>:8082
   $ openstack endpoint create --region RegionOne \
     application-catalog internal http://<murano-ip>:8082
   $ openstack endpoint create --region RegionOne \
     application-catalog admin http://<murano-ip>:8082

   Note

   URLs (publicurl, internalurl and adminurl) may be different depending on your environment.