Difference between revisions of "InstallationEDIV"

From VNUML-WIKI
Jump to: navigation, search
(Download the source file from the web)
(Download the source file from the web)
Line 37: Line 37:
 
* ediv_*.pl: this files are scripts used to help configuring and installing EDIV, and also simulation and cluster management scripts.
 
* 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.
 
* *.pm modules: this are external perl modules used by the main EDIV program.
 +
* cluster.conf: this is an example of cluster configuration file.
  
 
=== Configuring the EDIV controller ===
 
=== Configuring the EDIV controller ===

Revision as of 09:39, 19 September 2008

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.

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.

sudo mkdir /usr/local/share/perl/5.8.8/EDIV/
sudo mv /root/EDIV/*.pm /usr/local/share/perl/5.8.8/EDIV/

The *.pl files must be placed in the /usr/bin/ folder:

sudo mv /root/EDIV/*.pl /usr/bin/

Perl installation

  • Perl installation if it wasn't previously installed:
sudo apt-get install perl
  • Perl Math Round library installation:
sudo apt-get install libmath-round-perl
  • 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.

    NOTE: 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:
sudo apt-get install build-essential

SSH server installation

  • SSH server installation:
sudo 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:
sudo /etc/init.d/ssh restart

Database installation and configuration

  • Install MySQL database:
sudo 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:
sudo apt-get install phpmyadmin
sudo 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:

sudo ln -s /usr/share/phpmyadmin/ /var/www
  • Run the database structure creation script (included in the EDIV source compressed file):
sudo 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:

sudo 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.