Skip to content

RAPP Scripts

Jump to bottom Edit New page
Manos Tsardoulias edited this page Nov 27, 2015 · 5 revisions

The rapp_scripts folder contains scripts necessary for operations related to the RAPP Platform. The scripts are divided into four folders:

backup

The following scripts are offered:

  • dumpRAPPMysqlDatabase.sh: Dumps the RAPP MySQL database in a .sql file
  • importRAPPMysqlDatabase.sh: Imports the RAPP MySQL database from a .sql file
  • dumpRAPPOntology.sh: Dumps the RAPP ontology in an .owl file
  • importRAPPOntology.sh: Imports the RAPP ontology from an .owl file

deploy

There are two files aimed for deployment:

  • deploy_rapp_ros.sh: Deploys the RAPP Platform back-end, i.e. all the ROS nodes
  • deploy_hop_services.sh: Deploys the corresponding HOP services

Follow the next steps to deploy the RAPP Platform software:

  • screen
  • ./deploy_rapp_ros.sh
  • Press Ctrl + a + d to detach
  • screen
  • ./deploy_hop_services
  • Press Ctrl + a + d to detach
  • screen -ls to check that 2 screen sessions exist

To reattach to screen session:

screen -r [pid.]tty.host

Screen how-to: http://www.rackaid.com/blog/linux-screen-tutorial-and-how-to/

setup

These scripts can be executed after a clean Ubuntu 14.04 installation, in order to install the appropriate packages and setup the environment.

Step 0 - Github installation

Install git in order to be able to clone the repositories:

sudo apt-get install git mercurial

WARNING: At least 10 GB's of free space are recommended.

Install RAPP Platform

It is advised to execute the clean_install.sh script in a clean VM or clean system.

Performs:

  • initial system updates
  • installs ROS Indigo
  • downloads all Github repositories needed
  • builds and install all repos (rapp_platform, knowrob, rosjava)
  • downloads builds and installs depending libraries for Sphinx4
  • installs MySQL
  • installs HOP

What you must do manually

A new MySQL user was created with username = dummyUser and password = changeMe and was granted all on RappStore DB. It is highly recommended that you change the password and the username of the user. The username and password are stored in the file located at /etc/db_credentials. The file db_credentials is used by the RAPP platform services, be sure to update it with the correct username and password. It's first line is the username and it's second line the password.

Setup in an existing system

If you want to add rapp-platform to an already existent system (Ubuntu 14.04) you should choose which setup scripts you need to execute. For example if you have MySQL install you do not need to execute 8_mysql_install.sh.

Scripts

  • 1_system_updates.sh: Fetches the Ubuntu 14.04 updates and installs them
  • 2_ros_setup.sh: Installs ROS Indigo
  • 3_auxiliary_packages_setup.sh: Installs software from apt-get, necessary for the correct RAPP Platform deployment
  • 4_rosjava_setup.sh: Fetches a number of GitHub repositories and compiles rosjava. This is a dependency of Knowrob.
  • 5_knowrob_setup.sh: Fetches the Knowrob repository and builds it. Knowrob is the tool that deploys the RAPP ontology.
  • 6_rapp_platform_setup.sh: Fetches the rapp-platform and rapp-api repositories and builds them
  • 7_sphinx_libraries.sh: Fetches the Sphinx4 necessary libraries, compiles them and installs them, Sphinx4 is used for ASR (Automatic Speech Recognition).
  • 8_mysql_install.sh: Installs MySQL
  • 9_create_rapp_mysql_db.sh: Adds the RAPP MySQL empty database in mysql
  • 10_create_rapp_mysql_user.sh: Creates a user to enable access the to database from the RAPP Platform code
  • 11_hop_setup.sh: Installs HOP and Bigloo, the tools providing the RAPP Platform generic services.
NOTES:

The following notes concern the manual setup of rapp-platform (not the clean setup form our scripts):

documentation

Scripts to automatically create documentation from the RAPP Platform code, the services and this wiki, using Doxygen.

RAPP Project, http://rapp-project.eu/

Add a custom sidebar
Clone this wiki locally