GIR3.1_ScalableMonitoring: S3-monitor-user-documentation-feedback.txt

File S3-monitor-user-documentation-feedback.txt, 5.5 KB (added by lnevers@bbn.com, 13 years ago)
Line 
1Subject:
2Re: S3 Monitor software release on wiki
3From:
4Luisa Nevers <lnevers@bbn.com>
5Date:
6Tue, 08 Mar 2011 15:16:22 -0500
7To:
8"Sharma, Puneet" <puneet.sharma@hp.com>
9CC:
10Vicraj 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>
11
12Hello,
13
14First of all, sorry for the delay.  I had been working on some stuff for
15GEC10, and have finally gotten back to S3monitor evaluation. I have some
16questions and comments about INSTALL.txt (similar to s3monitor-guide.pdf):
17
181. Question, should this software packages run on the GENI nodes in the
19   slice?  Or should it be run on hosts that are not part of the slice?
20
212. I am also having a hard time understanding what is meant by "two step
22   operation" and how/why it matters to the user.  Is there a restriction
23   to installing the two packages on the same node?
24
253. In the s3monitor-guide.pdf, because of the lack of section formats the
26   "Logs" and "Configuration files" sections seem to be subsections of the
27   "Why two steps procedure?" section.  Is this intended?
28
294. The INSTALL.txt is not following the document format outline as the pdf.  For
30   example in the pdf, "Configuration file" is a header similar to "Logs", but
31   in the text version this section separation is lost.
32
335. The "Configuration file" section lists the two S3monitor configurations, but
34   does not provide any insight into what is configured.
35
366. The INSTALL.txt has an _incorrect_ link, the mysql link used is:
37
38   http://dev.mysql.com/doc/refman/5.5/en/linuxinstallation.html
39
40   while in the pdf the link has a "-" in the name:
41
42   http://dev.mysql.com/doc/refman/5.5/en/linux-installation.html
43
446. While running "sudo bash ./install_s3monitor_service.sh"  I did not recognize
45   the first prompt:
46
47    $ sudo bash ./install_s3monitor_service.sh
48    Starting S3monitor Service installation
49    Installation path (Default:/opt/s3monitor)
50   
51  Did not realize that the above was asking me to confirm or modify, should make
52  changes to indicate that a response is needed.
53
547. "Steps to install" for the s3monitor_webapp package are inconsistent with the
55    s3monitor_service instructions:
56
57   The s3monitor_service instruction use "s3monitor_service-{version}.tar.gz"
58   which reflect the naming used for the package downloaded.
59
60   The s3monitor_webapp instructions use "Webapp-{version}.tar.gz" which does
61   not match the "s3monitor_webapp-r111.tar.gz" downloaded.
62
638. Web apps installation complains about a directory existing which does not exist:
64
65    $ sudo bash ./install_s3monitor_webapp.sh
66    Starting S3monitor Service installation
67    Tomcat Webapp Path (Default:/var/lib/tomcat6/webapps)
68
69    Destination directory already exists
70    Overwrite it(y/n): (Default:y)
71    ^C
72    $ ls -l /var/lib/tomcat6/webapps
73    ls: cannot access /var/lib/tomcat6/webapps: No such file or directory
74    $
75
76   This may be due to the hard-coded variable 'TOMCAT_DIR="/var/lib/tomcat6"' in
77   the script install_s3monitor_webapp.sh.  The pre-requiresites are for tomcat5.5 or
78   higher. (Now running with tomcat6)
79
809. In a scenario where the database portion of the webapp installation fails, there is
81   no failure handling, the script is "completed" in the same way as a success scenario.
82
83    $ sudo bash ./install_s3monitor_webapp.sh
84    <<< many lines delete>>>
85    Writing Configuration file
86    Creating Schema...
87    ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)
88    ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)
89    ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)
90    ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)
91    ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)
92    Installation Complete
93
9410.  The INSTALL.TXT files should have a pointer to the next document to use.  Where the user
95     is instructed on run-time and where the workflow is defined.
96
97NOTE: The remaining feedback applies only to S3monitor-guide.pdf
98=================================================================
99
100The S3monitor-guide.pdf shows the following table of contents:
101
102    About this Document
103    1. Introduction to S3 Monitor Service
104    2. Software Prerequisites
105    3. Installation Instructions
106    4. Work flow
107
108But the sections found in the body of the document do not match the ones listed.
109Also the "Work flow" section seems to be replaced by "SNAPSHOTS", which do not
110have any explanation. Following are the actual sections in the document that
111maybe should be captured:
112
113    INTRODUCTION
114    Why two steps procedure?   
115    Logs
116    Configuration file
117    SOFTWARE PRE-REQUISITES
118    INSTALLATION INSTRUCTION    <- should be "INSTRUCTIONS"
119    1. S3monitor-service installation instruction
120    2. S3monitor-Webapp installation instruction
121    3. Sensor pod data collector setup instructions
122    SNAPSHOTS
123    1. Page Screen
124    2. Login page
125    3. Admin page [logged in as admin]
126    4.Main page [logged in as User]
127    5. List of Nodes
128    6.Measurements
129    7. Instant Measurement
130    a)Ping
131    b)Trace Route
132    c) Path Chirp
133    8. Periodic Measurement
134    a)Configure
135    b)Deploy
136    c) List
137    d)Delete
138    9. Results
139
140
141If there are any questions, please let me know.
142
143Regards,
144
145Luisa Nevers
146