1 | Subject:
|
---|
2 | Re: Updated documentation for KanseiGenie
|
---|
3 | From:
|
---|
4 | Luisa Nevers <lnevers@bbn.com>
|
---|
5 | Date:
|
---|
6 | 11/2/2011 3:16 PM
|
---|
7 | To:
|
---|
8 | Michael McGrath <mcgrath.57@buckeyemail.osu.edu>
|
---|
9 | CC:
|
---|
10 | Wenjie 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 |
|
---|
12 | Hello Michael, Wenjie,
|
---|
13 |
|
---|
14 | First of all, I hope all is going well at GEC12!. Please feel free to ignore this email
|
---|
15 | until after GEC12. I have continued the Kansei Genie evaluation and have some
|
---|
16 | more 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 |
|
---|
47 | READMEs 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 |
|
---|
71 | Thank you for your help and patience.
|
---|
72 | Luisa
|
---|
73 |
|
---|
74 | On 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 |
|
---|