GIR3.2_kansei: KanseiGenieFeedback-20111102.txt

File KanseiGenieFeedback-20111102.txt, 9.6 KB (added by lnevers@bbn.com, 8 years ago)
Line 
1Subject:
2Re: Updated documentation for KanseiGenie
3From:
4Luisa Nevers <lnevers@bbn.com>
5Date:
611/2/2011 3:16 PM
7To:
8Michael McGrath <mcgrath.57@buckeyemail.osu.edu>
9CC:
10Wenjie Zeng <zengw@cse.ohio-state.edu>, Hongwei Zhang <hongwei@wayne.edu>, Anish Arora <anish@cse.ohio-state.edu>, "Michael A. McGrath" <mcgrathm@cse.ohio-state.edu>, Xi Ju <alexis.ju@gmail.com>, Harry Mussman <hmussman@bbn.com>, Heidi Picher Dempsey <hpd@bbn.com>, Luisa Nevers <lnevers@bbn.com>
11
12Hello Michael, Wenjie,
13
14First of all, I hope all is going well at GEC12!. Please feel free to ignore this email
15until after GEC12.   I have continued the Kansei Genie evaluation and have some
16more feedback:
17
18- On http://kansei.cse.ohio-state.edu/KanseiGenie/Doc/cloning.php?pageName=FullInstallation.html
19  in step 6, the script name included in the package differs from the instructions.
20       * Instructions use install_webservices.sh
21       * Package delivers install_webservices_dependencies.sh
22
23- Running the install_webservices_dependencies.sh reports a missing file:
24
25    $ sudo bash install_webservices_dependencies.sh
26    Starting installation of KanseiGenie Web Services..\n
27    Copying files to /opt/javaApps/JBoss
28    mv: cannot stat `jboss-4.2.3.GA': No such file or directory
29
30- I took a look at the Stargate Director package, even though I do not have
31  the platform and found that the package delivers an install script named
32  "install_LPCD.sh", the web instruction use a file "install_SGD.sh".
33
34- In Section 4.0 "Create a custom home page template"  of the Kansei Genie Portal Cloning
35  documentation there are incorrect instructions. The following path is in the documentation
36  "/var/www/KanseiGenie/Template", but the actual path is
37 "/var/www/KanseiGenie/Templates"
38 
39- In Section 6.0 "Customizing the Look and Feel of the portal" of the Kansei Genie Portal Cloning
40  documentation, the content of item 1 need re-wording. Also item 4 describes a home.tpl
41  file which does not exist in the Templates area.
42
43- Overall, when the KanseiGenie Portal Cloning steps are completed, I am not sure what
44  should be done next.  After customization, the documentation does not provide insight
45  into the next steps.
46
47READMEs Feedback:
48 -  Generally, acronyms are not spelled out in most README files.
49
50- The "ReadMe_Portal.txt" file does not provide any indication of the need
51   to run "install_library_UBU.sh" before the portal installation. On line 35 there
52   is a reference to an installation script attempting to load Apache, but the       
53   script name is not specified.
54
55- The "ReadMe_KGDirector.txt" file states the following:
56
57    "Some of the actions below will be accomplished by the installation script."
58
59   Which of the steps are executed? This is confusing, should clearly identity
60   which steps are manual and which are automated.
61
62- The "ReadMe_KGDirector.txt" file states the following:
63
64   "It is important to configure the components of the KSS correctly,
65     to get them all to work seemly. We list here the configurations of the KGDirector."
66
67    What follows looks like a configuration procedure, not a list of configuration files.
68     Also, no file names are specified in some cases and some steps are handled by scripts
69     and not by a user step, so the information is somewhat confusing to a kansei newbie.
70
71Thank you for your help and patience.
72Luisa
73
74On 11/1/2011 4:48 PM, Luisa Nevers wrote:
75> Hello Michael,
76>
77> Thank you for the quick response. I did rerun the install_library_UBU.sh script and now have no problems with
78> the portal installation.  I am now using the instruction you provided.
79>
80> One minor bit of feedback, the  KG_manager password delivered in /opt/KanseiGenie/config.ini and at the Portal's
81> /var/www/KanseiGenie/Config/DB.ini are not consistent.  The /opt/KanseiGenie/config.ini file delivers a password
82> string that is not the default value, while the /var/www/KanseiGenie/Config/DB.ini delivers a password string that is
83> the default.  It would be helpful if both configuration files were consistent and delivered the default value.
84>
85> Luisa
86>
87>
88> On 11/1/2011 3:27 PM, Michael McGrath wrote:
89>> Hello Luisa,
90>>
91>> I have spent every day for the last two and a half weeks trying to move most of the manual configurations into automatic installation scripts, but I haven't put the documentation for the new installation procedure on the website yet because the old installation instructions are also valid and do everything that the new installation scripts do.  I will provide a link to the new instructions for installing everything in one shot on one machine, except ORCA, because I haven't made it to installing ORCA automatically yet.
92>>
93>> 1) Please enter "y" to all options in install_library_UBU.sh script.  This script installs all needed libraries for KanseiGenie.  I have changed the default option to "yes" in all of the questions on the script to reflect this.
94>>
95>> 2) We only have one development version of KanseiGenie installed on our servers, so the unpacked directory named "Portal" contains the latest installation files.
96>>
97>> 3) I will remove most of the contents of the ReadMe_Portal.txt script.  Users should look to the on-line website documentation.  I will update this file with the simple installation instructions.
98>>
99>> 4) It looks like the apache2 web server needs to be installed.  Please select "y" when the first script, install_library_UBU.sh asks to install the portal dependencies.
100>>
101>> The full installation instructions should be at
102>>
103>> http://kansei.cse.ohio-state.edu/KanseiGenie/Doc/cloning.php?pageName=FullInstallation.html
104>>
105>> Thank you for your patience.
106>>
107>> Sincerely,
108>>
109>> Michael McGrath
110>> mcgrath.57@osu.edu
111>> ________________________________________
112>> From: Luisa Nevers [lnevers@bbn.com]
113>> Sent: Tuesday, November 01, 2011 2:18 PM
114>> To: Wenjie Zeng
115>> Cc: Hongwei Zhang; Anish Arora; Michael A. McGrath; Xi Ju; Harry Mussman
116>> Subject: Re: Updated documentation for KanseiGenie
117>>
118>> Hello Wenjie ,
119>>
120>> I have started to look at the software and documentation and have some
121>> minor issues and
122>> one problem (item 4 below):
123>>
124>> 1. On page
125>> http://kansei.cse.ohio-state.edu/KanseiGenie/Doc/cloning.php?pageName=KGPortal.html,
126>>      in section the  "0.0 Download and Extract"  section, there is not
127>> enough information so that I can decide
128>>      how to answer  these questions:
129>>            Install KanseiGenie Director dependencies?  Reply [y/N]:
130>>            Install KanseiGenie Web Services dependencies?  Reply [y/N]:
131>>            Install TinyOS?  Reply [y/N]:
132>>
133>> 2. The file Portal package file KG_Portal_2011-10-31.tgz  unpacks to a
134>> directory named "Portal"; The
135>>        directory naming does not reflect a package name, nor a version.
136>>
137>> 3. The file ReadMe_Portal.txt has lines longer that 80 characters, which
138>> causes wrapping text issues.
139>>
140>> 4. The install_portal.sh script reports the various errors, note that I
141>> did run install_library_UBU.sh first and
142>>       was assuming that it would handle prerequisites:
143>>
144>>       lnevers@arendia:~/kansei/rc2/Portal$ sudo ./install_portal.sh
145>>       Starting installation of KanseiGenie Researcher Portal..
146>>       ..... Many lines deleted ..............
147>>      php/Templates/dashBoard-header-button.tpl
148>>      php/index-maintenance.php
149>>      mv: cannot move `/home/lnevers/kansei/rc2/Portal/users' to
150>> `/etc/apache2/': Nota directory
151>>      Install KanseiGenie Portal's MySQL Username, Password, and
152>> Database?   Reply [Yn]:
153>>      Please enter KanseiGenie Researcher Portal's MySQL Username for
154>> /var/www/KanseiGenie/Config/DB.ini (KG_manager):    KG_managermv: cannot
155>> move `/home/lnevers/kansei/rc2/Portal/users' to `/etc/apache2/': Nota
156>> directory
157>>      Please enter KanseiGenie Researcher Portal's MySQL Password for
158>> /var/www/KanseiGenie/Config/DB.ini (default: KG-Man-Ager):    KG-Man-Ager
159>>      Creating MySQL database KG_PortalDB
160>>      ERROR 1470 (HY000) at line 1: String 'KG_managermv: cannot move
161>> `/home/lnevers/kansei/rc2/Portal/users' is too long for user    name
162>> (should be no longer than 16)
163>>      Install and enable apache2 kansei-www site?   Reply [Y/n]:
164>>      mv: cannot move `kansei-www' to `/etc/apache2/sites-available': No
165>> such file or directory
166>>      ./install_portal.sh: line 64: a2ensite: command not found
167>>      apache2: unrecognized service
168>>      KanseiGenie Researcher Portal installation script complete.
169>>      -->  Use htpasswd to edit the users file at /etc/apache2/users
170>>      -->  Please edit the Portal configuration file at /var/www/Portal.ini
171>>      -->  See comments inside the configuration files and
172>> http://kansei.cse.ohio-state.edu/Doc/cloning.php
173>>      Done.
174>>     $
175>>
176>> Luisa
177>>
178>>
179>> On 11/1/2011 9:27 AM, Luisa Nevers wrote:
180>>> Hello Wenjie ,
181>>>
182>>> I will take a look today.
183>>>
184>>> Thank you,
185>>>
186>>> Luisa
187>>>
188>>> On 10/31/2011 5:30 PM, Wenjie Zeng wrote:
189>>>> Hi Luisa,
190>>>>
191>>>> We've updated the documentations for KanseiGenie. The problems you
192>>>> ran into previously is because we had started updating KanseiGenie
193>>>> with new features that are out of the scope of GENI and the site was
194>>>> in a inconsistent state. We have now rolled back our site to a
195>>>> consistent state for your inspection. Please use the following
196>>>> credential when you download the source code (they are case sensitive):
197>>>>
198>>>> user name: Luisa
199>>>> password: luisa@bbn
200>>>>
201>>>> The latest cloning documentation can be found here
202>>>> http://kansei.cse.ohio-state.edu/KanseiGenie/Doc/cloning.php.
203>>>>
204>>>> Best regards,
205>>>> -- Wenjie Zeng
206>>
207>>
208>>
209>
210>
211