diff --git a/src/administrators-guide/src/docbkx/content/installation-guide.xml b/src/administrators-guide/src/docbkx/content/installation-guide.xml index 3173b6a..07a58af 100644 --- a/src/administrators-guide/src/docbkx/content/installation-guide.xml +++ b/src/administrators-guide/src/docbkx/content/installation-guide.xml @@ -23,209 +23,113 @@ http://www.w3.org/1999/xlink http://www.w3.org/1999/xlink.xsd" version="5.0"> Install Murano Components - This chapter describes how to install Murano components on a - separate devbox. We - strongly recommend to use a separate host (virtual machine or real - host) for Murano - devbox as it prevents you from various dependency conflicts. + This chapter describes how to install Murano components on a separate devbox. + We strongly recommend to use a separate host (virtual machine or real host) for Murano + devbox as it prevents you from various dependency conflicts.
Automatic Installation - There is a script to automate Murano installation onto - devbox. + There is a script to automate Murano installation onto devbox. - Create a folder to hold cloned - repositories - ># mkdir -p /opt/git + Create a folder to hold cloned repositories + +># mkdir -p /opt/git + - Clone murano-deployment - repository - + Clone murano-deployment repository + ># cd /opt/git ># git clone git://github.com/stackforge/murano-deployment.git - + - Change directory to - murano-deployment - and switch to required branch (e.g.master) - -># cd /opt/git/murano-deployment -># git checkout -b master origin/master - - - - - Install - prerequisites - + Set configuration and install prerequisites + ># cd /opt/git/murano-deployment/devbox-scripts ># ./murano-git-install.sh prerequisites - + + + Press Enter to edit /etc/murano-deployment/lab-binding.rc, + then 'i' to enter INSERT mode. After editing press ESC and type :wq to write and exit from VI. + +LAB_HOST='lab_IP_or_hostname' +ADMIN_USER='admin' +ADMIN_PASSWORD='admin_pass' +RABBITMQ_LOGIN='muranouser' +RABBITMQ_PASSWORD='murano' +RABBITMQ_VHOST='muranovhost' +#RABBITMQ_HOST='' +BRANCH_NAME='master' +SSL_ENABLED='false' +SSL_CA_FILE='' +SSL_CERT_FILE='' +SSL_KEY_FILE='' + + + + LAB_HOST - IP or hostname of the lab. + This address/hostname should point to the host where Keystone is installed. + + + ADMIN_USER - OpenStack admin user. + + + ADMIN_PASSWORD - A password for OpenStack admin user. + + + RABBITMQ_USER - User to connect to RabbitMQ host. + + + RABBITMQ_PASSWORD - Password for that user. + + + RABBITMQ_VHOST - vHost which will be used by Murano + components. Provides additional layer of isolation from other devboxes. + + + RABBITMQ_HOST - (optional) IP address or hostname of + the host where RabbitMQ is installed IF it is not the same host as LAB_HOST points to. + + + RABBITMQ_HOST_ALT - (optional) IP address or hostname of + the RabbitMQ host to connect from inside the Windows instance. In some cases the + addresses like LAB_HOST or RABBITMQ_HOST are inaccessible from instances, and they must use + different address. + + + FILE_SHARE_HOST - (optional) IP address or hostname of + the host where file share with prerequisites is located if it is not the same host as + LAB_HOST points to. + + + BRANCH_NAME - branch name from which all Murano + components will be fetched for installation. + + + SSL_ENABLED - Set 'true' if + OpenStack is configured with SSL support and 'false' otherwise. + + + SSL_CA_FILE - Path to CA certificate for certificate validation + on client side. Leave it empty when used self-signed certificates. + + + + + + Install Murano components + +># ./murano-git-install.sh install + - Configure the following parameters in lab binding - configuration file - /etc/murano-deployment/lab-binding.rc - - - - - LAB_HOST - - - IP or nostname - of the lab. Actually, this address/name - should point to the - host where Keystone is installed. - - - - - ADMIN_USER - - - OpenStack - admin - user - - - - - ADMIN_PASSWORD - - - A password for OpenStack - admin - - user - - - - - RABBITMQ_USER - - - User to connect to RabbitMQ host - - - - - - RABBITMQ_PASSWORD - - - Password for that user - - - - - RABBITMQ_VHOST - - - vHost - which will be used by Murano - components. Provides additional - layer of isolation from other devboxes. - - - - - RABBITMQ_HOST - - - - (optional) IP address or hostname of - the host where RabbitMQ - is installed IF it is not the same host - as LAB_HOST points - to - - - - - - RABBITMQ_HOST_ALT - - - - (optional) IP address or hostname of - the RabbitMQ host to - connect from inside the Windows - instance. In some cases the - addresses like LAB_HOST or - RABBITMQ_HOST are inaccessible - from instances, and they must use - different address. - - - - - FILE_SHARE_HOST - - - - (optional) IP address or hostname of - the host where file - share with prerequisites is located IF - it is not the same - host as LAB_HOST points to. - - - - - BRANCH_NAME - - - branch name - from which all Murano components will - be fetched for - installation - - - - - SSL_ENABLED - - - Set - 'true' - if OpenStack is - configured with SSL support and - 'false' - - otherwise. - - - - - SSL_CA_FILE - - - Path to CA - certificate for certificate validation - on client - side. - - - - - - - Install Murano - components - -># ./murano-git-install.sh install - - - - Login to the Dashboard using URL - http://<your - VM IP>/dashboard - - or - http://<your - VM IP>/horizon - - + Login to the Dashboard using URL http://your_VM_IP/horizon + on Ubuntu or http://your_VM_IP/dashboard on CentOS.