Installer for Rhinohawk ROS

This repo contains an installer for setting up a new system to run Rhinohawk ROS. It's intended for provisioning fresh virtual machines and embedded devices.

⚠️ Use the installer at your own risk! ⚠️

The installer will modify your system by installing many packages and checking out code into your home directory.

We encourage you to read through the install script before running it.

Preparing your system

1. The best way to run this system for development is by using a virtual machine, for example, VirtualBox, Parallels, or VMWare Fusion. Alternatively, you can install on bare metal, such as an UpBoard or any other PC capable of running Linux.
2. Download and install a version of Ubuntu 16. We recommend Lubuntu 16.04.
3. If promoted after installation, do NOT upgrade to the next version of Ubuntu. Rhinohawk will only run on Ubuntu 16.
4. Install git (sudo apt-get install -y git)
5. We highly recommend that you configure a shared clipboard between the guest VM and your operating system.

Running the installer

To begin the installation process:

git clone https://github.com/RhinohawkUAV/rh_ros_installer.git
cd rh_ros_installer
./install.sh

You'll be prompted to begin the installation, and then periodically by sudo for your password to escalate privilege.

Using the system

Follow the instructions in the main repository to run the Rhinohawk system.

Melodic with Ubuntu Bionic (18.04)

To run melodic with bionic all you need to do is clone this repository as usual. Then

>> cd rh_ros_installer
>> ./install_ros.sh

You will be prompted for you password once when you start. The script would run for approximately 20minutes.

After the installation is complete. You will need to run catkin_make to build the ros nodes for rh.

>> . ~/.bashrc
>> cd ~/catkin_ws
>> catkin_make

Once this finishes (approximately 3 minutes), re-read the .bashrc script before proceeding.

>> . ~/.bashrc

Now you should be able to run the simulations from rh_simulation.