Setup Installation Guide

Hello! Welcome to our Lab. On this page we will guide you through the installation process of our Lab.

Here are the steps:

Install Ubuntu 18.04.3 LTS.

https://ubuntu.com/download or
https://tutorials.ubuntu.com/tutorial/tutorial-create-a-usb-stick-on-ubuntu or
https://tutorials.ubuntu.com/tutorial/tutorial-create-a-usb-stick-on-windows
Install updates running
```
sudo apt update
sudo apt upgrade
```
Create a folder called 'dev' in your home directory
In this folder clone our cpm software repository into your /dev folder by typing:
```
cd ~/dev
git clone https://git.rwth-aachen.de/CPM/Project/Lab/software.git
```
you have to enter your git username and password
Prepare to run our installation script by getting a license.dat-file for the RTI DDS Connext Service (ask your supervisor if you are a student or get into contact with RTI)

Run our script to install all necessary components. You find our script in the "software" folder you have just cloned. You find it in the folder "install-script-for-ubuntu-setup"

todo	full installation	simulation setup only
run	bash setup_cpm_build_environment.sh	bash setup_cpm_build_environment.sh --simulation
What will it install?	Unbuntu packages	Unbuntu packages
	Joystick/ Gamepad	Joystick/ Gamepad
	RTI DDS Connext	RTI DDS Connext
	RTI ARM
	OpenCV 4.0 for the Indoor Positioning System
	Basler Pylon 5 for the Indoor Positioning System and lab camera

If you want to change the DDS Domian later, go to /etc/profile.
If you want to update your license file go to:
```
/opt/rti_connext_dds-6.0.0/rti_license.dat
```
Reboot your computer or
open a new terminal and type
```
cd ~/dev; source /etc/profile.d/rti_connext_dds.sh
```
Run the build script. It will also clone the cpm library so keep your git username and password on hand.
full setup only simulation setup
./build_all.bash
./build_all.bash --simulation
For the middleware usage you need to set up environment variables.Use our script. Open it in the "software folder". It can be loaded into your currently running session by typing:
```
 . ./environment_variables.bash
```
Do not set LD_LIBRARY_PATH for the whole system, only for your current shell.
Set your local communication parameters by editing the XML template
You need to replace the template parameter of the QOS_LOCAL_COMMUNICATION.xml.template with the machine's IP address and store the resulting file as QOS_LOCAL_COMMUNICATION.xml. This file can then be loaded by both the Middleware and your script.
Bash example:
```
# Copy local communication QoS, use correct IP
my_ip=$(ip route get 8.8.8.8 | awk -F"src " 'NR==1{split($2,a," ");print a[1]}')
sed -e "s/TEMPLATE_IP/${my_ip}/g" \
<../QOS_LOCAL_COMMUNICATION.xml.template \
>./QOS_LOCAL_COMMUNICATION.xml
```