From 541a4f24f4febc0aee9b7ce3442c103586697ab8 Mon Sep 17 00:00:00 2001
From: Giuseppe Carella <cargius@gmail.com>
Date: Tue, 28 Feb 2017 16:02:34 +0100
Subject: [PATCH] added zabbix 3 installation guide.

TODO: remember to change links to the zabbix additional file/scripts currently linking to the juju-charm repo. Those files should be moved in the zabbix plugin folder
---
 docs/nfvo-configuration.md                    |  5 +-
 docs/nfvo-installation-deb.md                 |  1 -
 docs/nfvo-installation-docker.md              |  1 -
 docs/nfvo-installation-mac.md                 |  1 -
 docs/nfvo-installation-src.md                 |  1 -
 docs/nfvo-installation.md                     |  1 -
 docs/zabbix-plugin.md                         |  5 +-
 ....md => zabbix-server-configuration-2.2.md} |  2 +-
 docs/zabbix-server-configuration-3.0.md       | 68 +++++++++++++++++++
 9 files changed, 75 insertions(+), 10 deletions(-)
 rename docs/{zabbix-server-configuration.md => zabbix-server-configuration-2.2.md} (98%)
 create mode 100644 docs/zabbix-server-configuration-3.0.md

diff --git a/docs/nfvo-configuration.md b/docs/nfvo-configuration.md
index 7ca7d34..7a9e77c 100644
--- a/docs/nfvo-configuration.md
+++ b/docs/nfvo-configuration.md
@@ -70,7 +70,8 @@ Please bare in mind that if the property is modified via APIs/dashboard, the cha
 
 #### parameters related with the monitoring system
 
-**MONITORING:** Open Baton allows the monitoring of the VMs on top of which the VNFs are executing via an external monitoring system. At the moment Zabbix is the monitoring system supported. If you want to enable it, you need first to install and configure Zabbix server following the guide at this page [Zabbix server configuration][zabbix-server-configuration].
+**MONITORING:** Open Baton allows the monitoring of the VMs on top of which the VNFs are executing via an external monitoring system. At the moment Zabbix is the monitoring system supported.
+If you want to enable it, you need first to install and configure Zabbix server following the guide at this page [Zabbix server configuration][zabbix-server-configuration-3.0].
 Once the Zabbix server is correctly configured and running, you only need to add following property:
 
 ```properties 
@@ -282,4 +283,4 @@ spring.rabbitmq.requested-heartbeat=60
 [use-openbaton]:use.md
 [dummy-NSR]:dummy-NSR.md
 [reference-to-rabbit-site]:https://www.rabbitmq.com/
-[zabbix-server-configuration]:zabbix-server-configuration.md
+[zabbix-server-configuration-3.0]:zabbix-server-configuration-3.0.md
diff --git a/docs/nfvo-installation-deb.md b/docs/nfvo-installation-deb.md
index ab20996..1ee33e7 100644
--- a/docs/nfvo-installation-deb.md
+++ b/docs/nfvo-installation-deb.md
@@ -203,7 +203,6 @@ For specific configuration refer to the [configuration]
 [dummy-NSR]:dummy-NSR.md
 [reference-to-rabbit-site]:https://www.rabbitmq.com/
 [reference-to-mysql]:https://www.mysql.com/
-[zabbix-server-configuration]:zabbix-server-configuration.md
 
 <!---
 Script for open external links in a new tab
diff --git a/docs/nfvo-installation-docker.md b/docs/nfvo-installation-docker.md
index cb3e910..d58be05 100644
--- a/docs/nfvo-installation-docker.md
+++ b/docs/nfvo-installation-docker.md
@@ -70,7 +70,6 @@ sudo docker rm openbaton
 [use-openbaton]:use.md
 [dummy-NSR]:dummy-NSR.md
 [reference-to-rabbit-site]:https://www.rabbitmq.com/
-[zabbix-server-configuration]:zabbix-server-configuration.md
 [reference-to-op-repo-on-public-docker-hub]:https://hub.docker.com/r/openbaton/standalone/tags/
 
 <!---
diff --git a/docs/nfvo-installation-mac.md b/docs/nfvo-installation-mac.md
index bc72035..7670095 100644
--- a/docs/nfvo-installation-mac.md
+++ b/docs/nfvo-installation-mac.md
@@ -48,7 +48,6 @@ brew remove openbaton-nfvo
 [use-openbaton]:use.md
 [dummy-NSR]:dummy-NSR.md
 [reference-to-rabbit-site]:https://www.rabbitmq.com/
-[zabbix-server-configuration]:zabbix-server-configuration.md
 [homebrew-website]:http://brew.sh
 [rabbitmq-website]:https://www.rabbitmq.com
 [nfvo-configuration]:nfvo-configuration.md
diff --git a/docs/nfvo-installation-src.md b/docs/nfvo-installation-src.md
index 46ebeb9..aae4749 100644
--- a/docs/nfvo-installation-src.md
+++ b/docs/nfvo-installation-src.md
@@ -113,7 +113,6 @@ For specific configuration refer to the [configuration]
 [use-openbaton]:use.md
 [reference-to-rabbit-site]:https://www.rabbitmq.com/
 [reference-to-mysql]:https://www.mysql.com/
-[zabbix-server-configuration]:zabbix-server-configuration.md
 [bootstrap]:https://github.com/openbaton/bootstrap
 
 <!---
diff --git a/docs/nfvo-installation.md b/docs/nfvo-installation.md
index 62a9740..fcadedf 100644
--- a/docs/nfvo-installation.md
+++ b/docs/nfvo-installation.md
@@ -26,7 +26,6 @@ Once you have done with the installation, you can decide either to fine tune you
 [use-openbaton]:use.md
 [reference-to-rabbit-site]:https://www.rabbitmq.com/
 [vagrant]: nfvo-installation-vagrant.md
-[zabbix-server-configuration]:zabbix-server-configuration.md
 
 <!---
 Script for open external links in a new tab
diff --git a/docs/zabbix-plugin.md b/docs/zabbix-plugin.md
index b02e244..a93f451 100644
--- a/docs/zabbix-plugin.md
+++ b/docs/zabbix-plugin.md
@@ -21,7 +21,7 @@ Some of the benefits introduced by the usage of such plugin:
 
 The prerequisites are:  
 
-- Zabbix server (2.2 or 3.0) installed and running. See [how to configure Zabbix server 2.2][zabbix-server-configuration].
+- Zabbix server (2.2 or 3.0) installed and running. See [how to configure Zabbix server 2.2][zabbix-server-configuration-2.2] or [Zabbix server 3.0]zabbix-server-configuration-3.0].
 - RabbitMQ server installed and running  
 - Git installed
 - Gradle installed
@@ -401,4 +401,5 @@ it creates an alarm (mapping zabbix notification into standard Alarm) and notify
 [openbaton-website]:http://openbaton.github.io
 [custom-alertscripts]:https://www.zabbix.com/documentation/2.2/manual/config/notifications/media/script
 [action-zabbix]:https://www.zabbix.com/documentation/2.2/manual/config/notifications/action
-[zabbix-server-configuration]:zabbix-server-configuration.md
\ No newline at end of file
+[zabbix-server-configuration-2.2]:zabbix-server-configuration-2.2.md
+[zabbix-server-configuration-3.0]:zabbix-server-configuration-3.0.md
\ No newline at end of file
diff --git a/docs/zabbix-server-configuration.md b/docs/zabbix-server-configuration-2.2.md
similarity index 98%
rename from docs/zabbix-server-configuration.md
rename to docs/zabbix-server-configuration-2.2.md
index b05c6e1..6a4bcc6 100644
--- a/docs/zabbix-server-configuration.md
+++ b/docs/zabbix-server-configuration-2.2.md
@@ -1,4 +1,4 @@
-# Zabbix server installation and configuration
+# Zabbix server (2.2) installation and configuration
 
 ## On Ubuntu 14.04 
 
diff --git a/docs/zabbix-server-configuration-3.0.md b/docs/zabbix-server-configuration-3.0.md
new file mode 100644
index 0000000..1e18034
--- /dev/null
+++ b/docs/zabbix-server-configuration-3.0.md
@@ -0,0 +1,68 @@
+# Zabbix server 3.0 installation and configuration
+
+## On Ubuntu 14.04 
+
+While performing the installation on the same host where the NFVO was installed, remember that both systems are heavily consuming CPU and Memory resources, therefore you'll need a powerful machine in order to have proper performances results.
+
+During the installation the installer will request to put a password for the user root of the mysql server. You can choose the password you like (we'll refer from now on to this password as MYSQL_USER_PASSWORD_DEFAULT variable), however make sure you use the same password while configuring zabbix components later on.
+```sh
+sudo su
+ZABBIX_PACKAGE="zabbix-release_3.0-1+trusty_all.deb"
+ZABBIX_REPO="http://repo.zabbix.com/zabbix/3.0/ubuntu/pool/main/z/zabbix-release/${ZABBIX_PACKAGE}"
+wget "${ZABBIX_REPO}"
+dpkg -i "${ZABBIX_PACKAGE}"
+rm "${ZABBIX_PACKAGE}"
+apt-get update && apt-get -y install mysql-server zabbix-server-mysql zabbix-frontend-php
+```
+
+Once done, you should configure the file /etc/php5/apache2/php.ini file with the following commands: 
+
+```
+# choose the timezone you prefer
+sed -i 's/;date.timezone =/date.timezone = "Europe\/Berlin"/' /etc/php5/apache2/php.ini
+sed -i 's/# DBPassword=/DBPassword=/' /etc/zabbix/zabbix_server.conf
+wget https://raw.githubusercontent.com/openbaton/juju-charm/develop/hooks/zabbix.conf.php
+cp zabbix.conf.php /etc/zabbix/web/zabbix.conf.php 
+rm zabbix.conf.php
+```
+
+Import all the related database tables: 
+
+```
+export MYSQL_USER_PASSWORD_DEFAULT=<put-your-root-mysql-password-here> 
+mysql -uroot -e "create database zabbix character set utf8 collate utf8_bin;" -p"${MYSQL_USER_PASSWORD_DEFAULT}"
+mysql -uroot -e "grant all privileges on zabbix.* to zabbix@localhost identified by '';" -p"${MYSQL_USER_PASSWORD_DEFAULT}"
+zcat /usr/share/doc/zabbix-server-mysql/create.sql.gz | mysql -uroot -p"${MYSQL_USER_PASSWORD_DEFAULT}" zabbix
+```
+
+Restart services and you are almost done:
+
+```sh
+service apache2 reload
+service zabbix-server restart
+```
+
+At this point the Zabbix frontend should be available at http://your-ip/zabbix in the browser. Default username/password is Admin/zabbix. It will pop up a wizard window which will guide you through the final configuration of the server. 
+
+Additionally, you need to configure the auto registration action so that VNFs hosts are added automatically into zabbix db when they are started. 
+For doing it you can either do it via the zabbix dashboard reachable at  http://your-ip/zabbix/actionconf.php or using the provided python script. Follow the below guidelines to understand this process.  
+
+## Configure the auto registration using the provided helper script
+
+In order to facilitate the configuration of the Zabbix Server, we also provide a zbx_helper.py script which executes all actions in once. 
+You should run the following command into the host: 
+
+```sh
+wget https://raw.githubusercontent.com/openbaton/juju-charm/develop/hooks/zbx_helper.py
+# modify any parameters like Zabbix username and password in the main function at the bottom of the script and execute the following: 
+python zbx_helper.py -a
+```
+
+After that, the zabbix server is ready to monitor your VNFs!
+
+
+[zabbix-create-action-1]:images/zabbix-add-action-1.png
+[zabbix-create-action-2]:images/zabbix-add-action-2.png
+[zabbix-create-action-3]:images/zabbix-add-action-3.png
+
+