# Murano in RDO OpenStack manual installation Want to install and use Murano in a RDO OpenStack environment? Here are the steps to do it. The first thing we need to do, is to know what is Murano: Murano is an application catalog who gives the users the capacity to launch pre-configured s/instances/jobs/g with apps in an OpenStack infrastructure. As the final user just select an application from a catalog with a minimal configuration, and Murano will take the role to orchestrate the background jobs(create instances, configure apps, connect networks, etc) For more information about application catalog project refer to this site: At this tutorial, i will use the following s/configurations/versions/g: * Centos 7.1 * RDO Liberty release * Hosts installed with packstack/ML2 network Let's start installing some pre requisites ``` sudo yum install -y gcc python-setuptools python-devel git postgresql-devel libffi-devel openssl-devel ``` Install pip ``` sudo easy_install pip ``` Install tox and upgrade six ``` sudo pip install tox sudo pip install --upgrade six ``` Create a database for murano ``` mysql -u root -p CREATE DATABASE murano; ``` Create murano user at MySQL ``` GRANT ALL PRIVILEGES ON murano.* TO 'murano'@'localhost' IDENTIFIED BY 'MURANODB_PASS'; GRANT ALL PRIVILEGES ON murano.* TO 'murano'@'%' IDENTIFIED BY 'MURANODB_PASS'; ``` Clone murano from liberty/stable branch ``` git clone -b stable/liberty git://git.openstack.org/openstack/murano ``` Install all requirements ``` cd ~/murano/ sudo pip install -r requirements.txt ``` Install murano ``` sudo python setup.py install ``` Create sample configuration file ``` oslo-config-generator --config-file etc/oslo-config-generator/murano.conf ``` Create murano directory and copy the sample content on it ``` mkdir /etc/murano cp ~/murano/etc/murano/* /etc/murano/ ``` Rename sample configuration to murano.conf ``` mv /etc/murano/murano.conf.sample /etc/murano/murano.conf ``` \| Edit the configuration file like this, adjust the configuration as your environment needs. `vi /etc/murano/murano.conf` ``` [oslo_messaging_rabbit] rabbit_host=RABBITMQ_IP rabbit_port=5672 rabbit_hosts=RABBITMQ_IP:5672 rabbit_use_ssl=False rabbit_userid=guest rabbit_password=guest rabbit_virtual_host=/ rabbit_ha_queues=False rabbit_notification_exchange=openstack rabbit_notification_topic=notifications [database] connection = mysql://murano:MURANODB_PASS@MYSQL_IP/murano [keystone_authtoken] auth_uri=http://KEYSTONE_IP:5000/v2.0 identity_uri=http://KEYSTONE_IP:35357 admin_user=murano admin_password=MURANO_PASS admin_tenant_name=services [murano] url = http://MURANO_IP:8082 [rabbitmq] host=RABBITMQ_IP login=guest password=guest virtual_host=/ ``` Create murano user ``` openstack user create --password MURANO_PASS murano ``` Add murano user to services tenant with admin privileges ``` openstack role add --project services --user murano admin ``` Create a service for application-catalog ``` openstack service create --name muranoapi --description "Murano Project" application-catalog ``` Associate an endpoint to application-catalog service ``` openstack endpoint create --region RegionOne --publicurl 'http://MURANO_IP:8082/' --adminurl 'http://MURANO_IP:8082/' --internalurl 'http://http://MURANO_IP:8082/' MURANO_SERVICE_ID ``` Sync the database ``` murano-db-manage --config-file /etc/murano/murano.conf upgrade ``` Open a new terminal and start murano-api service ``` murano-api --config-file /etc/murano/murano.conf ``` Import base murano package ``` murano-manage --config-file /etc/murano/murano.conf import-package murano/meta/io.murano ``` In a new terminal, start murano-engine service ``` murano-engine --config-file /etc/murano/murano.conf ``` Clone stable liberty module for horizon ``` git clone -b stable/liberty git://git.openstack.org/openstack/murano-dashboard ``` Install base requirements ``` cd ~/murano-dashboard pip install -r requirements.txt ``` Install murano-dashboard module ``` sudo python setup.py install ``` Enable murano-dashboard at horizon ``` cp muranodashboard/local/_50_murano.py /usr/share/openstack-dashboard/openstack_dashboard/enabled/ ``` Restart apache to apply changes ``` systemctl restart httpd ``` Import ApacheHttpServer package ``` murano --murano-repo-url="http://storage.apps.openstack.org/" package-import io.murano.apps.apache.ApacheHttpServer ``` You can find more packages at: This will add a Debian image to glance image service, wait until the image is in active status Create a file with the following content, modify the variables with your own needs`vi object_model_patch.json` ``` [ { "op": "add", "path": "/-", "value": { "instance": { "availabilityZone": "nova", "name": "APP_NAME", "image": "GLANCE_IMAGE_ID", "keyname": "KEY_PAIR", "flavor": "FLAVOR", "assignFloatingIp": false, "?": { "type": "io.murano.resources.LinuxMuranoInstance", "id": "===id1===" } }, "name": "ApacheHttpServer", "enablePHP": true, "?": { "type": "io.murano.apps.apache.ApacheHttpServer", "id": "===id2===" } } } ] ``` Create an environment ``` murano environment-create --join-subnet-id SUBNET_ID ENVIRONMENT_NAME murano environment-create --join-subnet-id e2c5175a-d5bc-4eb7-91ba-67ac9120c64a test +----------------------------------+------+---------------------+---------------------+ | ID | Name | Created | Updated | +----------------------------------+------+---------------------+---------------------+ | 68a19d233d2d42459faf64d375d995e5 | test | 2015-12-11T13:09:57 | 2015-12-11T13:09:57 | +----------------------------------+------+---------------------+---------------------+ ``` Create a session for temporal working on the environment ``` murano environment-session-create ENVIRONMENT_ID murano environment-session-create 68a19d233d2d42459faf64d375d995e5 Created new session: +----------+----------------------------------+ | Property | Value | +----------+----------------------------------+ | id | b0f5e39a9c4c419c9ee7fdb6c92c37a6 | +----------+----------------------------------+ ``` Add the file with the apps configuration ``` murano environment-apps-edit --session-id SESSION_ID ENVIRONMENT_ID FILE_NAME murano environment-apps-edit --session-id b0f5e39a9c4c419c9ee7fdb6c92c37a6 68a19d233d2d42459faf64d375d995e5 object_model_patch.json ``` Deploy the environment ``` murano environment-deploy ENVIRONMENT_ID --session-id SESSION_ID murano environment-deploy 68a19d233d2d42459faf64d375d995e5 --session-id b0f5e39a9c4c419c9ee7fdb6c92c37a6 +-----------+-------------------------------------------------------------+ | Property | Value | +-----------+-------------------------------------------------------------+ | created | 2015-12-11T13:09:57 | | id | 68a19d233d2d42459faf64d375d995e5 | | name | test | | services | [ | | | { | | | "instance": { | | | "availabilityZone": "nova", | | | "name": "test", | | | "assignFloatingIp": false, | | | "keyname": "", | | | "flavor": "twogb", | | | "image": "9049eb0c-081e-4d56-9413-72fdc6f8d8bf", | | | "?": { | | | "type": "io.murano.resources.LinuxMuranoInstance", | | | "id": "30f5a591a58a468fbf4d7ef4755e0512" | | | } | | | }, | | | "name": "ApacheHttpServer", | | | "enablePHP": true, | | | "?": { | | | "status": "deploying", | | | "type": "io.murano.apps.apache.ApacheHttpServer", | | | "id": "98b994565c634f7e97d5f365203ce222" | | | } | | | } | | | ] | | status | deploying | | tenant_id | 3a5d50fac9a3462fa4d76b8b84677c3f | | updated | 2015-12-11T13:09:57 | | version | 0 | +-----------+-------------------------------------------------------------+ ``` Now, you can check at nova the building status of the instances ``` nova list +--------------------------------------+-----------------------------------------+--------+------------+-------------+----------+ | ID | Name | Status | Task State | Power State | Networks | +--------------------------------------+-----------------------------------------+--------+------------+-------------+----------+ | a68cedfb-7b4c-47a6-96fb-6b64a85a8ca6 | murano-mmnpdii1ozz7r2-test-5np5cvfeoiyh | BUILD | scheduling | NOSTATE | | +--------------------------------------+-----------------------------------------+--------+------------+-------------+----------+ ``` After a while, the instance is up and running ``` nova list +--------------------------------------+-----------------------------------------+--------+------------+-------------+------------------+ | ID | Name | Status | Task State | Power State | Networks | +--------------------------------------+-----------------------------------------+--------+------------+-------------+------------------+ | a68cedfb-7b4c-47a6-96fb-6b64a85a8ca6 | murano-mmnpdii1ozz7r2-test-5np5cvfeoiyh | ACTIVE | - | Running | private=10.0.0.8 | +--------------------------------------+-----------------------------------------+--------+------------+-------------+------------------+ ``` Once the instance is active, murano will configure the application inside, wait until the status is ready. ``` murano environment-show f392de2004e24ff7b2a08f05df0599b8 +-----------+---------------------------------------------------------------+ | Property | Value | +-----------+---------------------------------------------------------------+ | created | 2015-12-11T13:43:23 | | id | 68a19d233d2d42459faf64d375d995e5 | | name | test | | services | [ | | | { | | | "instance": { | | | "availabilityZone": "nova", | | | "openstackId": "91615340-e1d3-428e-848f-38a762004d33", | | | "name": "test", | | | "securityGroupName": null, | | | "image": "9049eb0c-081e-4d56-9413-72fdc6f8d8bf", | | | "assignFloatingIp": false, | | | "floatingIpAddress": null, | | | "keyname": "", | | | "?": { | | | "classVersion": "0.0.0", | | | "name": null, | | | "package": "io.murano", | | | "type": "io.murano.resources.LinuxMuranoInstance", | | | "_actions": {}, | | | "id": "30f5a591a58a468fbf4d7ef4755e0512" | | | }, | | | "ipAddresses": [ | | | "10.0.0.8" | | | ], | | | "flavor": "twogb", | | | "networks": { | | | "useFlatNetwork": false, | | | "primaryNetwork": null, | | | "useEnvironmentNetwork": true, | | | "customNetworks": [] | | | }, | | | "sharedIps": [] | | | }, | | | "name": "ApacheHttpServer", | | | "?": { | | | "classVersion": "0.0.0", | | | "status": "ready", | | | "name": null, | | | "package": "io.murano.apps.apache.ApacheHttpServer", | | | "type": "io.murano.apps.apache.ApacheHttpServer", | | | "_actions": {}, | | | "id": "98b994565c634f7e97d5f365203ce222" | | | }, | | | "enablePHP": true | | | } | | | ] | | status | ready | | tenant_id | 3a5d50fac9a3462fa4d76b8b84677c3f | | updated | 2015-12-11T13:47:35 | | version | 1 | +-----------+---------------------------------------------------------------+ ``` That's all you need to have up and running a Murano application catalog, for now there is no rpm package to ease the installation, so you need to install from source like we done. A thing you can do, is create systemd files to manage murano services in a easier way. Regards, Eduardo Gonzalez --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://blog.egonzalez.org/openstack/index/murano-in-rdo-openstack-manual-installation.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.