For the impatient ones we provide an AMI (Amazon machine image) with the stable version of Rapyuta installed. For details on how to kickstart the AMI visit the Prebuild AMI page.
The other option is the good old way: get the source code and install. Under this option, you again have several choices on the target platform. Here are a few the we tried and recommend:
1. Ping google.com to check your internet connectivity and DNS.
ping google.com
2. Install some basic dependencies
sudo apt-get install python-setuptools python-dev git-core
1. Clone the rce repository
git clone -b master https://github.com/rapyuta/rce.git rce
2. Install packages
cd rce sudo ./install.sh
3. Setup container filesystem
./setup/provision all
(Look at INSTALL for details on options with this script. For testing purposes, press y to the first prompt and press Enter for the rest.)
4. Add ROS environment variables
echo 'source /opt/ros/{fuerte|groovy}/setup.sh' >> ~/.bashrc
1. Enter packages' paths into ~/.rce/config.ini. Add packages' paths under header machine/packages. e.g.
[machine/packages]
Test={PATH TO RCE LOCAL REPOSITORY}/rce/test
(There is a test package in the default repository which you can use to test your installation.)
2. Enter the container filesystem
sudo rce-make
3. Make the ROS packages: # rosmake to compile packages # apt-get to install using the package manager
rosmake Test
4. Leave the container filesystem
exit
5. Add packages' paths to ROS_PACKAGE_PATH variable
export ROS_PACKAGE_PATH=$ROS_PACKAGE_PATH:{PATH TO RCE}/rce/test
To make it default add it to your .bashrc
echo 'export ROS_PACKAGE_PATH=$ROS_PACKAGE_PATH:{PATH TO RCE}/rce/test' >> ~/.bashrc
1. Start rce-master in one terminal.
rce-master
(The main process of the cloud engine)
2. Start rce-robot in another terminal.
rce-robot localhost
(This process manages connections with a robot or ROS environment)
3. Start rce-container in another terminal.
sudo rce-container localhost
(This process manages the containers)
4. Run roscore in another terminal.
roscore
5. Run ros client with test config file in another terminal.
rce-ros {PATH TO RCE LOCAL REPOSITORY}/test/debug.cfg
6. List ROSService Calls.
rosservice list
(You should see /parameterTest and /stringEchoService)
7. Test ROSService Calls.
rosservice call /stringEchoService somestring
(You should see somestring echoed back)
If you reach this point, Congratulations!, you've successfully installed Rapyuta. More Usage Options can be found here
