Subject:
Re: S3 Monitor software release on wiki
From:
Luisa Nevers <lnevers@bbn.com>
Date:
Tue, 08 Mar 2011 15:16:22 -0500
To:
"Sharma, Puneet" <puneet.sharma@hp.com>
CC:
Vicraj Thomas <vthomas@bbn.com>, Sonia Fahmy <fahmy@cs.purdue.edu>, geni-s3monitor <geni-s3monitor@external.groups.hp.com>, Luisa Nevers <lnevers@bbn.com>, Heidi Picher Dempsey <hpd@bbn.com>

Hello,

First of all, sorry for the delay.  I had been working on some stuff for
GEC10, and have finally gotten back to S3monitor evaluation. I have some
questions and comments about INSTALL.txt (similar to s3monitor-guide.pdf):

1. Question, should this software packages run on the GENI nodes in the
   slice?  Or should it be run on hosts that are not part of the slice?

2. I am also having a hard time understanding what is meant by "two step
   operation" and how/why it matters to the user.  Is there a restriction
   to installing the two packages on the same node?

3. In the s3monitor-guide.pdf, because of the lack of section formats the
   "Logs" and "Configuration files" sections seem to be subsections of the
   "Why two steps procedure?" section.  Is this intended?

4. The INSTALL.txt is not following the document format outline as the pdf.  For
   example in the pdf, "Configuration file" is a header similar to "Logs", but
   in the text version this section separation is lost.

5. The "Configuration file" section lists the two S3monitor configurations, but
   does not provide any insight into what is configured.

6. The INSTALL.txt has an _incorrect_ link, the mysql link used is:

   http://dev.mysql.com/doc/refman/5.5/en/linuxinstallation.html

   while in the pdf the link has a "-" in the name:

   http://dev.mysql.com/doc/refman/5.5/en/linux-installation.html

6. While running "sudo bash ./install_s3monitor_service.sh"  I did not recognize
   the first prompt:

    $ sudo bash ./install_s3monitor_service.sh
    Starting S3monitor Service installation
    Installation path (Default:/opt/s3monitor)
    
  Did not realize that the above was asking me to confirm or modify, should make
  changes to indicate that a response is needed.

7. "Steps to install" for the s3monitor_webapp package are inconsistent with the
    s3monitor_service instructions:

   The s3monitor_service instruction use "s3monitor_service-{version}.tar.gz"
   which reflect the naming used for the package downloaded.

   The s3monitor_webapp instructions use "Webapp-{version}.tar.gz" which does
   not match the "s3monitor_webapp-r111.tar.gz" downloaded.

8. Web apps installation complains about a directory existing which does not exist:

    $ sudo bash ./install_s3monitor_webapp.sh
    Starting S3monitor Service installation
    Tomcat Webapp Path (Default:/var/lib/tomcat6/webapps)

    Destination directory already exists
    Overwrite it(y/n): (Default:y)
    ^C
    $ ls -l /var/lib/tomcat6/webapps
    ls: cannot access /var/lib/tomcat6/webapps: No such file or directory
    $

   This may be due to the hard-coded variable 'TOMCAT_DIR="/var/lib/tomcat6"' in
   the script install_s3monitor_webapp.sh.  The pre-requiresites are for tomcat5.5 or
   higher. (Now running with tomcat6)

9. In a scenario where the database portion of the webapp installation fails, there is
   no failure handling, the script is "completed" in the same way as a success scenario.

    $ sudo bash ./install_s3monitor_webapp.sh
    <<< many lines delete>>>
    Writing Configuration file
    Creating Schema...
    ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)
    ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)
    ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)
    ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)
    ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)
    Installation Complete

10.  The INSTALL.TXT files should have a pointer to the next document to use.  Where the user
     is instructed on run-time and where the workflow is defined.

NOTE: The remaining feedback applies only to S3monitor-guide.pdf
=================================================================

The S3monitor-guide.pdf shows the following table of contents:

    About this Document
    1. Introduction to S3 Monitor Service
    2. Software Prerequisites
    3. Installation Instructions
    4. Work flow

But the sections found in the body of the document do not match the ones listed.
Also the "Work flow" section seems to be replaced by "SNAPSHOTS", which do not
have any explanation. Following are the actual sections in the document that
maybe should be captured:

    INTRODUCTION
    Why two steps procedure?   
    Logs
    Configuration file
    SOFTWARE PRE-REQUISITES
    INSTALLATION INSTRUCTION    <- should be "INSTRUCTIONS"
    1. S3monitor-service installation instruction
    2. S3monitor-Webapp installation instruction
    3. Sensor pod data collector setup instructions
    SNAPSHOTS
    1. Page Screen
    2. Login page
    3. Admin page [logged in as admin]
    4.Main page [logged in as User]
    5. List of Nodes
    6.Measurements
    7. Instant Measurement
    a)Ping
    b)Trace Route
    c) Path Chirp
    8. Periodic Measurement
    a)Configure
    b)Deploy
    c) List
    d)Delete
    9. Results


If there are any questions, please let me know.

Regards,

Luisa Nevers