Version 18 (modified by, 13 years ago) (diff)


Kansei Genie Evaluation

The KanseiGenie project delivered a group of packages available at the KanseiGenie Packages Download page. The Portal Cloning and Director Packages are used to clone Kansei at a new testbed. Installation instructions are found at Source Cloning page under the Documentation area and also the Full Installation instructions are available to cover both the Portal Cloning and Director Packages.

First Evaluation Time Frame: October 12, 2011 Second Evaluation Time Frame: November 1, 2011.

Kansei Genie Findings

The initial set of issues discovered prevented installation. Feedback was captured in the KanseiGenieFeedback-20111012.txt email.

An update to the documentation was made to remove future features, this version was used for the second evaluation. The documentation was in an inconsistent state, because it was being updated for features under development. Started the second evaluation with instructions found at the KanseiGenie Portal Cloning page, but was redirected to the Full Installation instructions.

Kansei Genie How-to

The software was downloaded from the KanseiGenie Packages Download page, which included the following software:

        Index of /KanseiGenie/Downloads/Packages/Secure
 	File Name	                        Last modified	        Size	Description
  	KG_Director_2011-10-31.tgz	        31-Oct-2011 20:14 	179K	 
  	KG_LPCD_UserTools_2011-10-13.tgz	13-Oct-2011 13:31 	381K	 
 	KG_LinuxPCDirector_2011-10-29.tgz	29-Oct-2011 17:08 	799K	 
 	KG_Orca_2011-10-13.tgz	                30-Oct-2011 04:46 	680M	 
 	KG_Portal_2011-10-31.tgz	        31-Oct-2011 15:49 	6.3M	 
 	KG_StargateDirector_2011-10-13.tgz	13-Oct-2011 13:31 	798K	 
 	KG_Webservices_2011-10-31.tgz	        31-Oct-2011 13:04 	81K	 
 	KG_Webservices_DEPENDENCIES.tar	        31-Oct-2011 19:48 	783M	                31-Oct-2011 15:42 	5.2K	 

The script installs prerequisite packages for Ubuntu systems:

  • for KanseiGenie Portal: apache2 php-pear libapache2-mod-php5 smarty php-http-upload
  • for KanseiGenie Director: mysql-server php-db mysql-php5 mysql-client-core-5.1 openntpd build-essential libnet-ssh-perl libnet-scp-expect-perl libcrpyt-dh-perl libgmp3-dev libdata-dumper-simple-perl liblog-log4perl libconfig-inifiles-perl libdate-calc-perl .

The script requires a system restart.

KanseiGenie Portal How-to

Using a login and password provided by the Kansei folks, downloaded the Portal package; Unpacked and installed it:

  $ sudo ./ 
  Starting installation of dependencies for KanseiGenie
  Installation script 2011-10-21
  Do you accept the KanseiGenie license terms?  Reply [y/N]: Y
  Update your system software information and upgrade to latest system packages?   Reply [y/N]: y
  Getting recent package information from online repositories ..
    ..... many output lines deleted ..... 
  Installing new version of config file /etc/apparmor.d/usr.bin.firefox ...
  Installing new version of config file /etc/apport/blacklist.d/firefox ...
  Please restart all running instances of firefox, or you will experience problems.
  Processing triggers for libc-bin ...
  ldconfig deferred processing now taking place
  Processing triggers for python-support ...
  Install KanseiGenie Web Portal dependencies?  Reply [y/N]: y
  Install KanseiGenie Director dependencies?  Reply [y/N]: y
  Install KanseiGenie Web Services dependencies?  Reply [y/N]: y
  Install TinyOS?  Reply [y/N]: y
  Remember to REBOOT before continuing installation of KanseiGenie.  
  REBOOT NOW  because some recently installed components required by the
  KanseiGenie installation scripts may not be running yet.
  $ sudo shutdown -r now

Next unpacked and install the KG portal package:

 $ tar xvzf KG_Portal_2011-10-31.tgz 
 $ cd Portal
 $ sudo ./
 Starting installation of KanseiGenie Researcher Portal..
 ...... Many output lines deleted..........
 Install KanseiGenie Portal's MySQL Username, Password, and Database?   Reply [Y/n]: y
 Please enter KanseiGenie Researcher Portal's MySQL Username for /var/www/KanseiGenie/Config/DB.ini (KG_manager): KG_manager
 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
 Install and enable apache2 kansei-www site?   Reply [Y/n]: y
 Site kansei-www already enabled
  * Reloading web server config apache2                                                                        [ OK ] 
 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

Added a user account as instructed:

 $ cd /etc/apache2
 $ sudo htpasswd -b users lnevers password-string
 Adding password for user lnevers

Customized the Portal's configuration file:

$ sudo vi /var/www/KanseiGenie/Config/Portal.ini

KanseiGenie Director How-to

Downloaded the Director package from the same location as the Portal package; Unpacked and installed it:

$ tar xvzf KG_Director_2011-10-31.tgz 
$ cd Director
$ sudo bash
Starting installation of KanseiGenie Director..\n
Copying files to /opt/KanseiGenie
Adding the KanseiGenie service
use sudo service KanseiGenie start
use sudo service KanseiGenie stop
Add kansei user to system?  Reply [Y/n]: y
Creating the user kansei ... please use something similar to Kansei Scheduler Service as the full name.
Changing the user information for kansei
Enter the new value, or press ENTER for the default
        Full Name []: BBN Kansei Scheduler Service
        Room Number []: 
        Work Phone []: 
        Home Phone []: 
        Other []: 
Is the information correct? [Y/n] 
Install Director MySQL database and users?  Reply [Y/n]: y
Please enter KanseiGenie's MySQL Username (also found in /var/www/KanseiGenie/Config/DB.ini and /opt/KanseiGenie/config.ini): KG_manager
Please enter KanseiGenie's MySQL Password (also found in /var/www/KanseiGenie/Config/DB.ini and /opt/KanseiGenie/config.ini): KG-Man-Ager
Creating the mysql KG_manager user...
You may be prompted for the MySQL root password.
ERROR 1396 (HY000) at line 1: Operation CREATE USER failed for 'KG_manager'@'localhost'
Don't forget to store the KG_manager password in  /opt/KanseiGenie/config.ini and at the Portal's /var/www/KanseiGenie/Config/DB.ini .
Creating KG_ExpDB Database in MySQL

Modified both /opt/KanseiGenie/config.ini and /var/www/KanseiGenie/Config/DB.ini to include the KG_manager password.

KanseiGenie WebServices How-to

Downloaded the WebService package from the same location as the Portal and Director packages; Unpacked and installed it:

$ tar xvf KG_Webservices_DEPENDENCIES.tar 
$ cd Webservices
$ sudo bash 
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
Assuming KG_ExpDB has already been set up with KG Director.
Modifying environment variables in the KanseiGenie init.d script.  JBOSS_HOME, JBOSS_PUBLICIP, and JBOSS_PRIVATEIP are passed to JBOSS when the service is started.  You can also set these yourself somewhere else (/etc/environment) and the KanseiGenie service will use your environment's values instead.
Please enter your Public IP address (default:
Please enter your Private IP address (default:
Modifying /opt/javaApps/JBoss/jboss-4.2.3.GA/server/default/deploy/http-invoker.sar/META-INF/jboss-service.xml file.
Now setting up JBoss MySQL config.
Please enter your MySQL Bind Address (default:
Please enter your MySQL Port Number (default: 3306): 3306
Please enter KanseiGenie's MySQL Username (also found in /var/www/KanseiGenie/Config/DB.ini and /opt/KanseiGenie/config.ini): KG_manager
Please enter KanseiGenie's MySQL Password (also found in /var/www/KanseiGenie/Config/DB.ini and /opt/KanseiGenie/config.ini): KG-Man-Ager
Install KanseiGenie service to start/stop with the system?   Reply [Y/n]: 
update-rc.d: warning: /etc/init.d/KanseiGenie missing LSB information
update-rc.d: see <>
 Adding system startup for /etc/init.d/KanseiGenie ...
   /etc/rc0.d/K99KanseiGenie -> ../init.d/KanseiGenie
   /etc/rc1.d/K99KanseiGenie -> ../init.d/KanseiGenie
   /etc/rc6.d/K99KanseiGenie -> ../init.d/KanseiGenie
   /etc/rc2.d/S99KanseiGenie -> ../init.d/KanseiGenie
   /etc/rc3.d/S99KanseiGenie -> ../init.d/KanseiGenie
   /etc/rc4.d/S99KanseiGenie -> ../init.d/KanseiGenie
   /etc/rc5.d/S99KanseiGenie -> ../init.d/KanseiGenie
Creating the output file directory /var/www/KanseiGenie/Output
Done installing KanseiGenie Web Services.
use sudo service KanseiGenie start
use sudo service KanseiGenie stop

KanseiGenie !LinuxPCDirector How-to

Downloaded the Linux PC Director package from the same location as the other packages; Unpacked and installed it:

$ tar xvzf KG_LinuxPCDirector_2011-10-29.tgz 
$ cd LinuxPCDirector
$ sudo bash 
Starting installation of KanseiGenie Director..
Install script
Sending LinuxPCDirector files to /opt/LinuxPCDirector
Unzipping kansei_kernel
Please enter the IP address of the KG Director (default:
Updating /opt/LinuxPCDirector/kansei_kernel/
Please enter the KanseiGenie Node ID (sgID) of this PC (default: 100): 100
Updating ID file at /opt/LinuxPCDirector/kansei_kernel/ID
Updating  /opt/LinuxPCDirector/kansei_kernel/
Updating /opt/LinuxPCDirector/kansei_kernel/bin/
Updating /opt/LinuxPCDirector/kansei_kernel/bin/
Updating /opt/LinuxPCDirector/kansei_kernel/bin/tos-set-symbols
 Skipping hmonitor install \(add hmonitor user, set up dchow\)
Add LinuxPCDirector startup to KanseiGenie service?   Reply [Y/n]: Y
Adding LinuxPCDirector to KanseiGenie service script /etc/init.d/ .

Installation Customization Howto

Once the packages are installed, the user must customize the /var/www/KanseiGenie/Config/Portal.ini file. Documentation is available at the Portal Cloning Documentation page.


Email us with any questions and feedback on this page!

Attachments (2)

Download all attachments as: .zip