|
|
|
Go Back to Cloning Documentation Index
Installing KanseiGenie Software Suite on a Single Ubuntu Machine
This page describes installation instructions for creating a KanseiGenie site-server to manage a series of local wireless sensor network mote array fabrics. The site-server may be connected to other remote sites using the GENI ORCA framework, but ORCA installation is not included in this guide yet.
- This guide assumes you are installing the components of KanseiGenie on a single Ubuntu 10.04 Lucid Lynx machine that is directly connected to a testbed of mote array fabric via USB cables (and USB hubs if necessary.) Although installation scripts have been written to use any version of Ubuntu, we have tested with Ubuntu 10.04.
- This guide skips installation of the Stargate Director component, and instead installs the LinuxPCDirector component as the Tier 2 layer between motes and the KanseiGenie Director. If you intend to use a different testbed topology, please read over this installation procedure and substitute sections of this guide with the component-specific installation instructions linked from the main KanseiGenie Cloning Documentation page.
- Benchtop-Array-Kit users should have access to a virtual machine image that was created using these installation procedures as a starting point.
- Portable-Array-Kit users should have access to software that will allow them to connect to a server set up using these instructions.
- KanseiGenie downloads are currently packaged with the creation date appended to the package file name as YYYY-MM-DD. Please visit the secure download page to get the actual file name of each package mentioned in these instructions.
Instructions:
- Go to http://kansei.cse.ohio-state.edu/KanseiGenie/Downloads/Packages/Secure.
- Download install_library_UBU.sh , KG_Portal_20YY-MM-DD.tgz , KG_Director_20YY-MM-DD.tgz, KG_Webservices_DEPENDENCIES.tar, KG_LinuxPCDirector_20YY-MM-DD.tgz into the default ~/Downloads location.
- Alternatively, if you are working from the command line, you can download these by using wget --user=USERNAME --password=PASSWORD http://kansei.cse.ohio-state.edu/KanseiGenie/Downloads/Packages/Secure/PACKAGENAME
- Open the terminal application. Navigate to the Downloads folder with
- cd ~/Downloads
- Execute command sudo bash install_library_UBU.sh
- Answer y to the first prompt to accept the KanseiGenie License terms.
- Answer y to the second prompt to update your system software to the latest packages
- Answer y to the third prompt to install the KanseiGenie Web Portal dependencies.
- Answer y to the fourth prompt to install the KanseiGenie Director dependencies. If at some point the install script installs MySQL, leave the root password blank (press the down arrow key to select Ok when the create password screen shows up each of three times.) If openntp installation fails, wait until the script is over with and then execute from the command line sudo aa-complain /usr/sbin/ntpd, followed by sudo apt-get install -f and then re-run the installation script. The OpenNTP bug is documented here: https://bugs.launchpad.net/ubuntu/+source/openntpd/+bug/458061
- Answer y to the fifth prompt to install the KanseiGenie Web Services dependencies. Answer Yes to accept the Oracle Java 6 JRE license.
- Answer y to the sixth prompt to install TinyOS.
- REBOOT the computer with sudo reboot
- Now let's install KG Portal. Open up a terminal.
- cd Downloads
- tar -xzf KG_Portal_20YY-MM-DD.tgz
- cd Portal
- sudo bash install_portal.sh
- Use the default values presented by the installation script (press enter at each prompt.)
- cd ..
- rm -rf Portal
- Now let's install KG Director.
- tar -xzf KG_Director_20YY-MM-DD.tgz
- cd Director
- sudo bash install_director.sh
- Use the default values presented by the installation script.
- You may get a "CREATE USER failed" message from MySQL -- in this case, the user already exists from the Portal setup and therefore everything is okay.
- cd ..
- Now let's install KG Web Services.
- tar -xf KG_Webservices_DEPENDENCIES.tar
- cd Webservices
- sudo bash install_webservices_dependencies.sh
- Use the default values presented by the installation script.
- cd ..
- Now let's install KG LinuxPCDirector.
- tar -xzf KG_LinuxPCDirector_20YY-MM-DD.tgz
- cd LinuxPCDirector
- sudo bash install_linuxpcdirector.sh
- Use the default values presented by the installation script.
- cd ..
- Now let's customize the installation (MANDATORY).
- Edit /var/www/KanseiGenie/Config/Portal.ini See the full Portal Cloning Documentation for everything that needs to be changed in the /var/www/KanseiGenie/Config/Portal.ini file. The following are reminders:
- Make sure to enable the benchtop site in the [portal] section, or use a custom site name.
- Make sure to edit the values in the [benchtop] section, or rename [benchtop] if you used a custom name for site2 in the [portal] section.
- You can customize the landing page if desired by creating /var/www/KanseiGenie/Templates/index-YOURSITE.tpl
- You can customize the banner image by placing an image in the Images folder and specifying it in the config file.
- Specific instructions are in the Portal Cloning Documentation.
- Install motes. This involves changing configurations in the database file. Insert motes as rows in the TelosB table. We are working on an installation script for adding/deleting motes.
- mysql -uroot
- INSERT INTO KG_ExpDB.telosbs 1,1,"/dev/ttyUSB0",1,1,"yes","yes",0,100,"XBQ9V400"
- INSERT INTO KG_ExpDB.telosbs 2,2,"/dev/ttyUSB1",1,2,"yes","yes",0,100,"XBQ9V4F0"
Security Hardening Kansei
The following items are not enabled by this installation guide but may be considered if the site is on a public network.
- Use HTTPS
- Change the default database usernames and passwords.
- Change the MySQL root password.
- Restrict the MySQL's kansei user to connect from localhost.