{"id":7013,"date":"2015-02-20T12:37:40","date_gmt":"2015-02-20T10:37:40","guid":{"rendered":"http:\/\/blog.zhaw.ch\/icclab\/?p=7013"},"modified":"2015-02-27T12:52:30","modified_gmt":"2015-02-27T10:52:30","slug":"how-to-install-and-setup-monasca-1-3","status":"publish","type":"post","link":"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/","title":{"rendered":"How to install and setup Monasca (1\/3)"},"content":{"rendered":"

In my previous blog post<\/a> I covered my initial impressions on Monasca. In the following trilogy I will cover its installation, setup, and testing. The installation will be performed for the Java version of Monasca, as some components have both Java and Python code available. For those which only need a quick local setup best would be to use the vagrant setup found here<\/a>.<\/p>\n

The installation will be performed on Ubuntu 14.04 and will be split into 3 posts. The first one<\/a> (this one) will cover dependency installation and configuration, the next one<\/a> will cover Monasca’s installation and configuration, and the final one<\/a> will cover the testing of the whole setup.<\/p>\n

<\/p>\n

The first steps are to update, upgrade and reboot the system.<\/p>\n

sudo apt-get update\r\nsudo apt-get upgrade -y\r\nsudo reboot<\/pre>\n
Next we have to setup the hostnames as, during this tutorial, we will use the monasca and devstack hostnames to refer to the virtual machines. For that, \/etc\/hosts needs to be edited and the following lines added to it.<\/p>\n
127.0.0.1 monasca\r\n[please_put_correct_ip] devstack<\/pre>\n
and then<\/p>\n
sudo hostname monasca<\/pre>\n
Next we will install git as we will use it a lot.<\/p>\n
sudo apt-get install -y git<\/pre>\n
Next we will install MySQL. We will need the username \/ password combination further on so for tutorial purposes set them to root \/ password.<\/p>\n
sudo apt-get install -y mysql-server libmysqlclient-dev<\/pre>\n
We have to download the latest Monasca MySQL schema and import it.<\/p>\n
wget https:\/\/raw.githubusercontent.com\/stackforge\/cookbook-monasca-schema\/master\/files\/default\/mysql\/mon.sql\r\nmysql -uroot -ppassword < mon.sql\r\nrm -rf mon.sql<\/pre>\n
Please note that this schema file is no longer maintained and the schema at<\/p>\n
https:\/\/github.com\/hpcloud-mon\/ansible-monasca-schema\/blob\/master\/templates\/mon.sql.j2<\/pre>\n
is the reference one, however it is served as a template for users and should be manually edited according to personal preferences before being imported.<\/p>\n
Because of some Monasca which connect on the external interface, the default MySQL bind-address needs to be changed to 0.0.0.0 in \/etc\/mysql\/my.cnf<\/p>\n
sudo sed -i.bak 's\/127.0.0.1\/0.0.0.0\/g' \/etc\/mysql\/my.cnf<\/pre>\n
And then we restart MySQL<\/p>\n
sudo service mysql restart<\/pre>\n
Next we’ll install and start Zookeeper<\/p>\n
sudo apt-get install -y zookeeper zookeeperd zookeeper-bin\r\nsudo service zookeeper start\r\n<\/pre>\n
And then Kafka and its dependency Scala<\/p>\n
sudo apt-get install -y scala\r\n\r\nwget http:\/\/mirror.switch.ch\/mirror\/apache\/dist\/kafka\/0.8.1.1\/kafka_2.9.2-0.8.1.1.tgz\r\n\r\ntar xvf kafka_2.9.2-0.8.1.1.tgz\r\n\r\nmv kafka_2.9.2-0.8.1.1 kafka\r\n\r\nrm kafka_2.9.2-0.8.1.1.tgz<\/pre>\n
Next we have to configure and start it<\/p>\n
sed -i.bak 's\/#host.name=localhost\/host.name=monasca\/g' kafka\/config\/server.properties\r\nsed -i.bak 's\/zookeeper.connect=localhost:2181\/zookeeper.connect=monasca:2181\/g' kafka\/config\/server.properties\r\nsudo nohup .\/kafka\/bin\/kafka-server-start.sh .\/kafka\/config\/server.properties &<\/pre>\n
Please give it a moment to start before creating the partitions for Monasca<\/p>\n
.\/kafka\/bin\/kafka-topics.sh --create --topic metrics --partitions 4 --zookeeper monasca:2181 --replication-factor 1\r\n.\/kafka\/bin\/kafka-topics.sh --create --topic events --partitions 4 --zookeeper monasca:2181 --replication-factor 1\r\n.\/kafka\/bin\/kafka-topics.sh --create --topic raw-events --partitions 4 --zookeeper monasca:2181 --replication-factor 1\r\n.\/kafka\/bin\/kafka-topics.sh --create --topic transformed-events --partitions 4 --zookeeper monasca:2181 --replication-factor 1\r\n.\/kafka\/bin\/kafka-topics.sh --create --topic alarm-state-transitions --partitions 4 --zookeeper monasca:2181 --replication-factor 1\r\n.\/kafka\/bin\/kafka-topics.sh --create --topic alarm-notifications --partitions 4 --zookeeper monasca:2181 --replication-factor 1\r\n.\/kafka\/bin\/kafka-topics.sh --create --topic retry-notifications --partitions 4 --zookeeper monasca:2181 --replication-factor 1<\/pre>\n
Postfix is required by monasca-notification in order to send emails<\/p>\n
sudo debconf-set-selections <<< \"postfix postfix\/mailname string monasca\"\r\nsudo debconf-set-selections <<< \"postfix postfix\/main_mailer_type string 'Internet Site'\"\r\nsudo apt-get install -y postfix<\/pre>\n
Then we need InfluxDB for storing metrics<\/p>\n
wget http:\/\/s3.amazonaws.com\/influxdb\/influxdb_latest_amd64.deb\r\nsudo dpkg -i influxdb_latest_amd64.deb\r\nrm influxdb_latest_amd64.deb<\/pre>\n
And we’ll change it’s default port to 9090 and restart the service<\/p>\n
sudo sed -i.bak 's\/port = 8090\/port = 9090\/g' \/opt\/influxdb\/shared\/config.toml\r\nsudo service influxdb restart<\/pre>\n
Next we create the database and users<\/p>\n
curl -X POST 'http:\/\/monasca:8086\/db?u=root&p=root' -d '{\"name\": \"mon\"}'\r\ncurl -X POST 'http:\/\/monasca:8086\/db\/mon\/users?u=root&p=root' -d '{\"name\": \"mon_api\", \"password\": \"password\"}'\r\ncurl -X POST 'http:\/\/monasca:8086\/db\/mon\/users?u=root&p=root' -d '{\"name\": \"mon_persister\", \"password\": \"password\"}'<\/pre>\n
As a side note, in order to view the metrics stored in InfluxDB, one can go to http:\/\/monasca:8083\/ (please replace monasca with the appropriate IP) and login with username\/password combination root\/root.<\/p>\n
In order to install Monasca’s packages we need to setup the python environment and java environment<\/p>\n
sudo apt-get install -y python-pip default-jre default-jdk maven<\/pre>\n
Monasca’s thresholding engine is reliant on Apache Storm so that’s what we’ll setup and start next<\/p>\n
wget http:\/\/mirror.switch.ch\/mirror\/apache\/dist\/storm\/apache-storm-0.9.3\/apache-storm-0.9.3.tar.gz\r\ntar xvf apache-storm-0.9.3.tar.gz\r\nrm apache-storm-0.9.3.tar.gz\r\nsudo mkdir -p \/opt\/storm\/\r\nsudo mv apache-storm-0.9.3\/ \/opt\/storm\/\r\nsudo mv \/opt\/storm\/apache-storm-0.9.3\/ \/opt\/storm\/current<\/pre>\n
We need to make storm play nice with Zookeeper and set it up<\/p>\n
sudo sed -i.bak '\/\"nimbus\"\/a\\\r\nnimbus.host: \"monasca\"\\\r\nstorm.zookeeper.servers:\\\r\n  - monasca\\\r\n\\\r\nui.port: 60888' \/opt\/storm\/current\/conf\/storm.yaml<\/pre>\n
Last thing is to start nimbus and the supervisor. Please give nimbus some time to start up before running the supervisor startup<\/p>\n
\/opt\/storm\/current\/bin\/storm nimbus &\r\n\/opt\/storm\/current\/bin\/storm supervisor &<\/pre>\n
Up next<\/a> are the installation and configuration of Monasca components.<\/p>\n
Schlagw\u00f6rter: cloud incident management<\/a>, monasca<\/a>
<\/div>","protected":false},"excerpt":{"rendered":"
In my previous blog post I covered my initial impressions on Monasca. In the following trilogy I will cover its installation, setup, and testing. The installation will be performed for the Java version of Monasca, as some components have both Java and Python code available. For those which only need a quick local setup best […]<\/p>\n","protected":false},"author":142,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"ngg_post_thumbnail":0,"footnotes":""},"categories":[1],"tags":[509,510],"features":[],"class_list":["post-7013","post","type-post","status-publish","format-standard","hentry","category-allgemein","tag-cloud-incident-management-2","tag-monasca"],"yoast_head":"\nHow to install and setup Monasca (1\/3) - Service Engineering (ICCLab & SPLab)<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to install and setup Monasca (1\/3)\" \/>\n<meta property=\"og:description\" content=\"In my previous blog post I covered my initial impressions on Monasca. In the following trilogy I will cover its installation, setup, and testing. The installation will be performed for the Java version of Monasca, as some components have both Java and Python code available. For those which only need a quick local setup best […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/\" \/>\n<meta property=\"og:site_name\" content=\"Service Engineering (ICCLab & SPLab)\" \/>\n<meta property=\"article:published_time\" content=\"2015-02-20T10:37:40+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2015-02-27T10:52:30+00:00\" \/>\n<meta name=\"author\" content=\"mune\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"mune\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/\"},\"author\":{\"name\":\"mune\",\"@id\":\"https:\/\/blog.zhaw.ch\/icclab\/#\/schema\/person\/ad6f9dc95a64a3da5cfcbe9b76581014\"},\"headline\":\"How to install and setup Monasca (1\/3)\",\"datePublished\":\"2015-02-20T10:37:40+00:00\",\"dateModified\":\"2015-02-27T10:52:30+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/\"},\"wordCount\":471,\"commentCount\":12,\"keywords\":[\"cloud incident management\",\"monasca\"],\"articleSection\":[\"*.*\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/\",\"url\":\"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/\",\"name\":\"How to install and setup Monasca (1\/3) - Service Engineering (ICCLab & SPLab)\",\"isPartOf\":{\"@id\":\"https:\/\/blog.zhaw.ch\/icclab\/#website\"},\"datePublished\":\"2015-02-20T10:37:40+00:00\",\"dateModified\":\"2015-02-27T10:52:30+00:00\",\"author\":{\"@id\":\"https:\/\/blog.zhaw.ch\/icclab\/#\/schema\/person\/ad6f9dc95a64a3da5cfcbe9b76581014\"},\"breadcrumb\":{\"@id\":\"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Startseite\",\"item\":\"https:\/\/blog.zhaw.ch\/icclab\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How to install and setup Monasca (1\/3)\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/blog.zhaw.ch\/icclab\/#website\",\"url\":\"https:\/\/blog.zhaw.ch\/icclab\/\",\"name\":\"Service Engineering (ICCLab & SPLab)\",\"description\":\"A Blog of the ZHAW Zurich University of Applied Sciences\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/blog.zhaw.ch\/icclab\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/blog.zhaw.ch\/icclab\/#\/schema\/person\/ad6f9dc95a64a3da5cfcbe9b76581014\",\"name\":\"mune\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/secure.gravatar.com\/avatar\/7b886759523f8a854ac234c59f59f32dee27ca251311c457235251e8aa94bcaf?s=96&d=mm&r=g\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/7b886759523f8a854ac234c59f59f32dee27ca251311c457235251e8aa94bcaf?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/7b886759523f8a854ac234c59f59f32dee27ca251311c457235251e8aa94bcaf?s=96&d=mm&r=g\",\"caption\":\"mune\"},\"url\":\"https:\/\/blog.zhaw.ch\/icclab\/author\/mune\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"How to install and setup Monasca (1\/3) - Service Engineering (ICCLab & SPLab)","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/","og_locale":"en_US","og_type":"article","og_title":"How to install and setup Monasca (1\/3)","og_description":"In my previous blog post I covered my initial impressions on Monasca. In the following trilogy I will cover its installation, setup, and testing. The installation will be performed for the Java version of Monasca, as some components have both Java and Python code available. For those which only need a quick local setup best […]","og_url":"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/","og_site_name":"Service Engineering (ICCLab & SPLab)","article_published_time":"2015-02-20T10:37:40+00:00","article_modified_time":"2015-02-27T10:52:30+00:00","author":"mune","twitter_card":"summary_large_image","twitter_misc":{"Written by":"mune","Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/#article","isPartOf":{"@id":"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/"},"author":{"name":"mune","@id":"https:\/\/blog.zhaw.ch\/icclab\/#\/schema\/person\/ad6f9dc95a64a3da5cfcbe9b76581014"},"headline":"How to install and setup Monasca (1\/3)","datePublished":"2015-02-20T10:37:40+00:00","dateModified":"2015-02-27T10:52:30+00:00","mainEntityOfPage":{"@id":"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/"},"wordCount":471,"commentCount":12,"keywords":["cloud incident management","monasca"],"articleSection":["*.*"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/","url":"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/","name":"How to install and setup Monasca (1\/3) - Service Engineering (ICCLab & SPLab)","isPartOf":{"@id":"https:\/\/blog.zhaw.ch\/icclab\/#website"},"datePublished":"2015-02-20T10:37:40+00:00","dateModified":"2015-02-27T10:52:30+00:00","author":{"@id":"https:\/\/blog.zhaw.ch\/icclab\/#\/schema\/person\/ad6f9dc95a64a3da5cfcbe9b76581014"},"breadcrumb":{"@id":"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/blog.zhaw.ch\/icclab\/how-to-install-and-setup-monasca-1-3\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Startseite","item":"https:\/\/blog.zhaw.ch\/icclab\/"},{"@type":"ListItem","position":2,"name":"How to install and setup Monasca (1\/3)"}]},{"@type":"WebSite","@id":"https:\/\/blog.zhaw.ch\/icclab\/#website","url":"https:\/\/blog.zhaw.ch\/icclab\/","name":"Service Engineering (ICCLab & SPLab)","description":"A Blog of the ZHAW Zurich University of Applied Sciences","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/blog.zhaw.ch\/icclab\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/blog.zhaw.ch\/icclab\/#\/schema\/person\/ad6f9dc95a64a3da5cfcbe9b76581014","name":"mune","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/7b886759523f8a854ac234c59f59f32dee27ca251311c457235251e8aa94bcaf?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/7b886759523f8a854ac234c59f59f32dee27ca251311c457235251e8aa94bcaf?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/7b886759523f8a854ac234c59f59f32dee27ca251311c457235251e8aa94bcaf?s=96&d=mm&r=g","caption":"mune"},"url":"https:\/\/blog.zhaw.ch\/icclab\/author\/mune\/"}]}},"_links":{"self":[{"href":"https:\/\/blog.zhaw.ch\/icclab\/wp-json\/wp\/v2\/posts\/7013","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.zhaw.ch\/icclab\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.zhaw.ch\/icclab\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.zhaw.ch\/icclab\/wp-json\/wp\/v2\/users\/142"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.zhaw.ch\/icclab\/wp-json\/wp\/v2\/comments?post=7013"}],"version-history":[{"count":45,"href":"https:\/\/blog.zhaw.ch\/icclab\/wp-json\/wp\/v2\/posts\/7013\/revisions"}],"predecessor-version":[{"id":7687,"href":"https:\/\/blog.zhaw.ch\/icclab\/wp-json\/wp\/v2\/posts\/7013\/revisions\/7687"}],"wp:attachment":[{"href":"https:\/\/blog.zhaw.ch\/icclab\/wp-json\/wp\/v2\/media?parent=7013"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.zhaw.ch\/icclab\/wp-json\/wp\/v2\/categories?post=7013"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.zhaw.ch\/icclab\/wp-json\/wp\/v2\/tags?post=7013"},{"taxonomy":"features","embeddable":true,"href":"https:\/\/blog.zhaw.ch\/icclab\/wp-json\/wp\/v2\/features?post=7013"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}