Subject: Re: Updated documentation for KanseiGenie From: Luisa Nevers Date: 11/2/2011 3:16 PM To: Michael McGrath CC: Wenjie Zeng , Hongwei Zhang , Anish Arora , "Michael A. McGrath" , Xi Ju , Harry Mussman , Heidi Picher Dempsey , Luisa Nevers Hello Michael, Wenjie, First of all, I hope all is going well at GEC12!. Please feel free to ignore this email until after GEC12. I have continued the Kansei Genie evaluation and have some more feedback: - On http://kansei.cse.ohio-state.edu/KanseiGenie/Doc/cloning.php?pageName=FullInstallation.html in step 6, the script name included in the package differs from the instructions. * Instructions use install_webservices.sh * Package delivers install_webservices_dependencies.sh - Running the install_webservices_dependencies.sh reports a missing file: $ sudo bash install_webservices_dependencies.sh Starting installation of KanseiGenie Web Services..\n Copying files to /opt/javaApps/JBoss mv: cannot stat `jboss-4.2.3.GA': No such file or directory - I took a look at the Stargate Director package, even though I do not have the platform and found that the package delivers an install script named "install_LPCD.sh", the web instruction use a file "install_SGD.sh". - In Section 4.0 "Create a custom home page template" of the Kansei Genie Portal Cloning documentation there are incorrect instructions. The following path is in the documentation "/var/www/KanseiGenie/Template", but the actual path is "/var/www/KanseiGenie/Templates" - In Section 6.0 "Customizing the Look and Feel of the portal" of the Kansei Genie Portal Cloning documentation, the content of item 1 need re-wording. Also item 4 describes a home.tpl file which does not exist in the Templates area. - Overall, when the KanseiGenie Portal Cloning steps are completed, I am not sure what should be done next. After customization, the documentation does not provide insight into the next steps. READMEs Feedback: - Generally, acronyms are not spelled out in most README files. - The "ReadMe_Portal.txt" file does not provide any indication of the need to run "install_library_UBU.sh" before the portal installation. On line 35 there is a reference to an installation script attempting to load Apache, but the script name is not specified. - The "ReadMe_KGDirector.txt" file states the following: "Some of the actions below will be accomplished by the installation script." Which of the steps are executed? This is confusing, should clearly identity which steps are manual and which are automated. - The "ReadMe_KGDirector.txt" file states the following: "It is important to configure the components of the KSS correctly, to get them all to work seemly. We list here the configurations of the KGDirector." What follows looks like a configuration procedure, not a list of configuration files. Also, no file names are specified in some cases and some steps are handled by scripts and not by a user step, so the information is somewhat confusing to a kansei newbie. Thank you for your help and patience. Luisa On 11/1/2011 4:48 PM, Luisa Nevers wrote: > Hello Michael, > > Thank you for the quick response. I did rerun the install_library_UBU.sh script and now have no problems with > the portal installation. I am now using the instruction you provided. > > One minor bit of feedback, the KG_manager password delivered in /opt/KanseiGenie/config.ini and at the Portal's > /var/www/KanseiGenie/Config/DB.ini are not consistent. The /opt/KanseiGenie/config.ini file delivers a password > string that is not the default value, while the /var/www/KanseiGenie/Config/DB.ini delivers a password string that is > the default. It would be helpful if both configuration files were consistent and delivered the default value. > > Luisa > > > On 11/1/2011 3:27 PM, Michael McGrath wrote: >> Hello Luisa, >> >> 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. >> >> 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. >> >> 2) We only have one development version of KanseiGenie installed on our servers, so the unpacked directory named "Portal" contains the latest installation files. >> >> 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. >> >> 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. >> >> The full installation instructions should be at >> >> http://kansei.cse.ohio-state.edu/KanseiGenie/Doc/cloning.php?pageName=FullInstallation.html >> >> Thank you for your patience. >> >> Sincerely, >> >> Michael McGrath >> mcgrath.57@osu.edu >> ________________________________________ >> From: Luisa Nevers [lnevers@bbn.com] >> Sent: Tuesday, November 01, 2011 2:18 PM >> To: Wenjie Zeng >> Cc: Hongwei Zhang; Anish Arora; Michael A. McGrath; Xi Ju; Harry Mussman >> Subject: Re: Updated documentation for KanseiGenie >> >> Hello Wenjie , >> >> I have started to look at the software and documentation and have some >> minor issues and >> one problem (item 4 below): >> >> 1. On page >> http://kansei.cse.ohio-state.edu/KanseiGenie/Doc/cloning.php?pageName=KGPortal.html, >> in section the "0.0 Download and Extract" section, there is not >> enough information so that I can decide >> how to answer these questions: >> Install KanseiGenie Director dependencies? Reply [y/N]: >> Install KanseiGenie Web Services dependencies? Reply [y/N]: >> Install TinyOS? Reply [y/N]: >> >> 2. The file Portal package file KG_Portal_2011-10-31.tgz unpacks to a >> directory named "Portal"; The >> directory naming does not reflect a package name, nor a version. >> >> 3. The file ReadMe_Portal.txt has lines longer that 80 characters, which >> causes wrapping text issues. >> >> 4. The install_portal.sh script reports the various errors, note that I >> did run install_library_UBU.sh first and >> was assuming that it would handle prerequisites: >> >> lnevers@arendia:~/kansei/rc2/Portal$ sudo ./install_portal.sh >> Starting installation of KanseiGenie Researcher Portal.. >> ..... Many lines deleted .............. >> php/Templates/dashBoard-header-button.tpl >> php/index-maintenance.php >> mv: cannot move `/home/lnevers/kansei/rc2/Portal/users' to >> `/etc/apache2/': Nota directory >> Install KanseiGenie Portal's MySQL Username, Password, and >> Database? Reply [Yn]: >> Please enter KanseiGenie Researcher Portal's MySQL Username for >> /var/www/KanseiGenie/Config/DB.ini (KG_manager): KG_managermv: cannot >> move `/home/lnevers/kansei/rc2/Portal/users' to `/etc/apache2/': Nota >> directory >> Please enter KanseiGenie Researcher Portal's MySQL Password for >> /var/www/KanseiGenie/Config/DB.ini (default: KG-Man-Ager): KG-Man-Ager >> Creating MySQL database KG_PortalDB >> ERROR 1470 (HY000) at line 1: String 'KG_managermv: cannot move >> `/home/lnevers/kansei/rc2/Portal/users' is too long for user name >> (should be no longer than 16) >> Install and enable apache2 kansei-www site? Reply [Y/n]: >> mv: cannot move `kansei-www' to `/etc/apache2/sites-available': No >> such file or directory >> ./install_portal.sh: line 64: a2ensite: command not found >> apache2: unrecognized service >> KanseiGenie Researcher Portal installation script complete. >> --> Use htpasswd to edit the users file at /etc/apache2/users >> --> Please edit the Portal configuration file at /var/www/Portal.ini >> --> See comments inside the configuration files and >> http://kansei.cse.ohio-state.edu/Doc/cloning.php >> Done. >> $ >> >> Luisa >> >> >> On 11/1/2011 9:27 AM, Luisa Nevers wrote: >>> Hello Wenjie , >>> >>> I will take a look today. >>> >>> Thank you, >>> >>> Luisa >>> >>> On 10/31/2011 5:30 PM, Wenjie Zeng wrote: >>>> Hi Luisa, >>>> >>>> We've updated the documentations for KanseiGenie. The problems you >>>> ran into previously is because we had started updating KanseiGenie >>>> with new features that are out of the scope of GENI and the site was >>>> in a inconsistent state. We have now rolled back our site to a >>>> consistent state for your inspection. Please use the following >>>> credential when you download the source code (they are case sensitive): >>>> >>>> user name: Luisa >>>> password: luisa@bbn >>>> >>>> The latest cloning documentation can be found here >>>> http://kansei.cse.ohio-state.edu/KanseiGenie/Doc/cloning.php. >>>> >>>> Best regards, >>>> -- Wenjie Zeng >> >> >> > >