This document provides all the steps for configuring your environment.
There is two kind of environment to configure. You can either configure a production environment, which is the environment that is running on the submarine. Or you can also configure a development environment, that is going to help you to develop our softwares.
Once you have correctly installed and configured you environment, you are ready to use our softwares. In order to simplify the usage of S.O.N.I.A. Software, we are using a single git repository that regroup all the modules that we use as git submodule.
This repository is located at
email@example.com:sonia-auv/ros_sonia_ws.git and you will have to be part of the SONIA organisation to access it. If it is not the case yet, please ask an administrator to add you.
This repository is composed of several branches:
ros_sonia_ws:core- Barbones environment for running the submarine
ros_sonia_ws:desktop- Full environment for development.
You will find the details on how to install and configure you environment on all the specific sections:
Now install bash_it in order to have a better command line interface:
git clone --depth=1 https://github.com/Bash-it/bash-it.git ~/.bash_it ~/.bash_it/install.sh rm ~/.bashrc.bak sed -i -e 's/bobby/nwinkler/g' ~/.bashrc
Now edit your
~/.bashrc and add the following configuration at the beginning of the file:
# If not running interactively, con't do anything case $- in *i*) ;; *) return;; esac if ! shopt -oq posix; then if [ -f /usr/share/bash-completion/bash_completion ]; then . /usr/share/bash-completion/bash_completion elif [ -f /etc/bash_completion ]; then . /etc/bash_completion fi fi
And source the other bash files at the end of your file:
# Load common aliases if [ -f ~/.bash_aliases ]; then . ~/.bash_aliases fi # Load SONIA Configuration if [ -f ~/.bash_sonia ]; then . ~/.bash_sonia fi
Then resource your
Installing software is really simple, just execute the following command and enjoy the show (Be aware that at some point you might need to do some actions[ i.e press ENTER]):
cd ~ wget http://sonia-auv.readthedocs.org/assets/files/melodic_18.04/sonia-install-1 -O ~/sonia-install-1 wget http://sonia-auv.readthedocs.org/assets/files/melodic_18.04/sonia-install-2 -O ~/sonia-install-2 sudo chmod +x sonia-install-1 sonia-install-2 ./sonia-install-1 # SYSTEM WILL REBOOT. AFTER IT, EXECUTE THE FOLLOWING : ./sonia-install-2 # Then remove the two files rm sonia-install-1 sonia-install-2