InstallationEDIV

From VNUML-WIKI
Revision as of 10:11, 1 October 2008 by Fjmartin (talk | contribs) (Perl installation)
Jump to: navigation, search

Installation Guide

IMPORTANT NOTE: EDIV documentation is still under construction.

Authors:
Francisco José Martín Moreno (fjmartin at dit.upm.es)
Miguel Ferrer Cámara (mferrer at dit.upm.es)
Fermín Galán Márquez (galan at dit.upm.es)
version 1.0, Jul 28th, 2008


Introduction

To get EDIV working, some configuration must be done in the EDIV controller and also in the hosts that form the cluster. There are two different types of installation: semi-automatic, through a deb package, or manual using a tzg compressed file.

Installing from .deb package

The deb package is not available yet. When available, installation instructions will be updated.

Installing from source .tgz

This installation procedure has been developed and tested only under Ubuntu distributions.

This type of installation involves the following steps:

Download the source file from the web

Is necessary to download the source file in the computer that is going to act as the EDIV controller. Then it must be decompressed in some place (e.g., /usr/local/src).

The source compressed file contains several files:

  • ediv_ctl.pl: this is the main program and it's main task is to launch and deploy the distributed network simulations.
  • ediv_*.pl: this files are scripts used to help configuring and installing EDIV, and also simulation and cluster management scripts.
  • *.pm modules: this are external perl modules used by the main EDIV program.
  • cluster.conf: this is an example of cluster configuration file.
  • README.txt: description and info about the release.
  • install: bash script to create EDIV necessary structure and place the previous files in the right place.

Configuring the EDIV controller

This step involves the following tasks:

Folder creation and file placement

The *.pm files must be moved to the /usr/local/share/perl/5.8.8/EDIV/ folder. The *.pl files must be placed in the /usr/bin/ folder. The cluster.conf file must be placed in the /etc/ediv folder.

To create the folders and put the files in the right place, execute the provided install script as root:

root@host:/temporary_directory# ./install

Perl installation

  • Perl installation if it wasn't previously installed:
apt-get install perl
  • Perl Math Round library installation:
apt-get install libmath-round-perl
  • AppConfig and PadWalker perl modules installation:
apt-get install libappconfig-perl libpadwalker-perl

NOTE: The AppConfig and PadWalker modules can be installed in a manual way. To do so, download and install the AppConfig-1.66 and PadWalker-1.7 from their corresponding CPAN web. The files contain README files with instructions on how to install those modules. Most of the AppConfig and PadWalker installation failures are caused due to the lack of an installed compiler. Try reinstalling them after issuing the following command:

apt-get install build-essential

SSH server installation

  • SSH server installation:
apt-get install openssh-server

NOTE: check that id_rsa.pub and id_rsa.pub files in the /root/.ssh/ folder have been generated after ssh server installation. These files contain the ssh keys necessary for ssh operation. If these files don't exist, issue the following command to generate them:

ssh-keygen -t rsa
ssh-keygen -t dsa
  • SSH server restart:

    Issue the following command to ensure proper ssh operation:
/etc/init.d/ssh restart

Database installation and configuration

  • Install MySQL database:
apt-get install mysql-server
  • Install some program to easily check the database contents (this step is optional). Some suggestions: phpmyadmin or mysql-query-browser.

    To install both of them use the following commands:
apt-get install phpmyadmin
apt-get install mysql-query-browser

NOTE: under ubuntu distributions some problems have been reported after phpmyadmin installation. They are solved issuing the following command:

ln -s /usr/share/phpmyadmin/ /var/www
  • Run the database structure creation script (included in the EDIV source compressed file):
ediv_db_manage.pl create

Cluster hosts configuration

The following tasks must be done before using some computer as a cluster member:

VNUML installation

A working installation of VNUML 1.8.3 or newer is required. Following the VNUML installation manual is recommended.

SSH server installation

Install the ssh server:

apt-get install openssh-server

EDIV controller SSH key importation

Importing the EDIV controller ssh key is required in the members of the cluster. This way the controller can execute commands as root in the hosts that are members of the cluster without requiring a password.

To import the key, edit the host /root/.ssh/authorized_keys file, adding the contents of the controller /root/.ssh/id_dsa.pub file.

NOTE: to check if the ssh keys exist and how to create them, read VNUML wiki

NOTE: if the controller computer is going to be a member of the cluster (controller and host at the same time) it's necessary to import its own key to the /root/.ssh/authorized_keys file.

IMPORTANT REMINDER: EDIV is now installed, but before trying to use it, a cluster configuration file must be created as described in the user manual.