[GNUnet-SVN] r30315 - eclectic

[gnunet]

Author: wachs
Date: 2013-10-18 15:13:21 +0200 (Fri, 18 Oct 2013)
New Revision: 30315

Modified:
   eclectic/installation-guide.pdf
   eclectic/installation-guide.tex
Log:
updated installation guide


Modified: eclectic/installation-guide.pdf
===================================================================
(Binary files differ)

Modified: eclectic/installation-guide.tex
===================================================================
--- eclectic/installation-guide.tex     2013-10-18 13:09:38 UTC (rev 30314)
+++ eclectic/installation-guide.tex     2013-10-18 13:13:21 UTC (rev 30315)
@@ -13,7 +13,8 @@
 
 \begin{document}
 
-\lstset{ 
+\lstset{
+breaklines=true,
 language=bash,
 basicstyle=\ttfamily,  
 upquote=true,
@@ -56,44 +57,52 @@
 $ sudo apt-get install mysql-server libmysqlclient-dev
 \end{lstlisting}
 
-\chapter{Installing Zabbix}
+\chapter{Installing Zabbix Server}
 For our installation we used Zabbix in version 2.0.4 but our approach is 
supposed to work with newer version from the 2.x branch. An extensive Zabbix 
installation guide can be found on the Zabbix website:
 
\href{https://www.zabbix.com/wiki/howto/install/ubuntu/ubuntuinstall}{Installing
 Zabbix on Ubuntu from source files}.
-To install Zabbix on the server the following steps are required:\\
+To install Zabbix on the server the following steps are required:\\\\
 - Install required dependencies:
 \begin{lstlisting}
 sudo apt-get install build-essential mysql-server libmysqlclient15-dev php5 
php5-gd php5-mysql snmp libsnmp-dev snmpd libcurl4-openssl-dev fping libssh2-1 
libssh2-1-dev
 \end{lstlisting}
 - Download the Zabbix 2.0.4 source:
 \begin{lstlisting}
-$ wget http://sourceforge.net/projects/zabbix/files/\\
-  ZABBIX%20Latest%20Stable/2.0.4/zabbix-2.0.4.tar.gz
+$ wget 
http://sourceforge.net/projects/zabbix/files/ZABBIX%20Latest%20Stable/2.0.4/zabbix-2.0.4.tar.gz
 \end{lstlisting}
-Unpack the archive file, compile and install Zabbix:
+- Unpack the archive file, compile and install Zabbix:
 \begin{lstlisting}
 $ tar xf zabbix-2.0.4.tar.gz
 $ cd zabbix-2.0.4
 $ ./configure --prefix=/home/experimentation/zabbix --enable-server 
--with-mysql --with-net-snmp --with-libcurl --with-ssh2
 $ make install
 \end{lstlisting}
+At this point, it is preferred to create a mysql account specifically for 
Zabbix.\\
+Replace <username> and <password> in the next section with the mysql 
credentials.\\
+- Setup Zabbix database:
+\begin{lstlisting}
+$ mysql -u<username> -p<password>
+mysql> create database zabbix character set utf8 collate utf8_bin;
+mysql> quit;
+$ mysql -u<username> -p<password> zabbix < database/mysql/schema.sql
+$ mysql -u<username> -p<password> zabbix < database/mysql/images.sql
+$ mysql -u<username> -p<password> zabbix < database/mysql/data.sql
+$ editor /home/experimentation/zabbix/etc/zabbix_server.conf
+\end{lstlisting}
+Change `LogFile`, `DBUser` and `DBPassword` accordingly.\\
+- Start Zabbix server:
+\begin{lstlisting}
+$ /home/experimentation/zabbix/sbin/zabbix_server start
+\end{lstlisting}
+- Setup Zabbix web frontend:
+\begin{lstlisting}
+$ sudo cp -r frontends/php/ /var/www/zabbix/
+$ sudo chown -R www-data:www-data /var/www/zabbix/
+\end{lstlisting}
+- Go to http://<server>/zabbix/ and follow the installation instructions 
shown.\\
+- If you need to change some PHP variables, locate your php.ini file, most 
likely in /etc/php5/apache2/php.ini, change the required variables then restart 
apache.\\
+- At this point, you can login through the web interface with the default 
admin credentials: Admin/zabbix
 
-% done until here...
 
-\begin{verbatim}
-- Using user planetmaster on sam server
-- Run mysql database setup script here: 
https://www.zabbix.com/documentation/2.0/manual/appendix/install/db_scripts [^]
-- ./configure --prefix=/home/planetmaster/zabbix --enable-server --with-mysql 
--with-net-snmp --with-libcurl --with-ssh2
-- make install
-- edited /home/planetmaster/zabbix/etc/zabbix_server.conf
-changed log file location
-db user/pass
-- Installed the web frontend in 
/home/planetmaster/zabbix/zabbix-2.0.4/frontends/php to 
https://gnunet.org/zabbix/ [^] with Christian's help
-- Added .htaccess file to the frontend dir to override some php variables 
needed for the installation
-- Completed the installation through the web frontend
-- ./home/planetmaster/zabbix/sbin/zabbix_server start
-- Changed web admin password
-\end{verbatim}
-
 \section{Installing GPLMT}
 
 
@@ -175,6 +184,32 @@
 
 \section{Installing GPLMT GUI}
 
+\subsection{Requirements}
+
+\subsubsection{Pear XML\_RPC2}
+
+Can be installed by running:
+\begin{lstlisting}
+$ sudo apt-get install php-pear
+$ sudo pear install XML_RPC2
+\end{lstlisting}
+
+\subsection{Installation}
+
+Assuming Zabbix has been installed as per the instructions above, GPLMT GUI 
can be installed by running the following:
+\begin{lstlisting}
+$ cd
+$ sudo chqrp -R www-data gplmt/
+$ wget http://gnunet.org/zabbix/diff.tar.gz
+$ tar xvzf diff.tar.gz
+$ mysql -u<username> -p<password> zabbix < gplmt-gui/schema.sql # Replace 
<username> and <password>
+$ mysql -u<username> -p<password> zabbix < data.sql
+$ cd /var/www/zabbix/ # Or the zabbix web frontend directory if chosen 
differently
+$ sudo -u www-data patch -p0 < ~/gplmt-gui/diff
+$ sudo -u www-data editor include/experiments/conf.php
+\end{lstlisting}
+Change the value of \$GLOBALS['GPLMT\_DIR'] to the path you installed GPLMT to.
+
 \section{Installing MSH}
 MSH depends on GNUnet's networking API and hence requires gnunet-0.9.5a to be
 installed.  Additionally, it requires an MPI implementation to be installed