Tested on Ubuntu focal (20.04) amd64.
To install prerequisites:
sudo apt-get install git ansible build-essential
Clone the strawlab-ansible-roles repository into your local drive. We recommend:
cd ~/
git clone https://github.com/strawlab/strawlab-ansible-roles.git
To run the playbook (installs freemovr):
cd strawlab-ansible-roles/
sudo ansible-playbook -i "localhost," -c local playbook-focal.yml
This may take more than one hour to complete, aborting will result in errors. Sometimes running this command will return an error which may be due to events on a remote server. If this happens - try again later.
After the installation is complete, you can remove the strawlab-ansible-roles folder:
rm -rf ~/strawlab-ansible-roles/
Do this as a normal user
/opt/ros/workspace-installers/noetic/make-freemovr-engine-workspace.sh
Now you should have new directories in ~/ros
with everything installed.
The top-level workspace is at ~/freemovr-engine-noetic
.
You can initiate your ROS environment with
source ~/ros/freemovr-engine-noetic/devel/setup.bash
NOTE: You have to initiate your ROS environment with the above command every
time you open a new terminal window otherwise you will get an error when trying
to start FreemoVR. You can automate this by placing the following in
your $HOME/.bashrc
file:
if [ -f $HOME/ros/freemovr-engine-noetic/devel/setup.bash ]; then
source $HOME/ros/freemovr-engine-noetic/devel/setup.bash
fi
After this, you can run FreemoVR commands such as
roslaunch freemovr_engine demo_display_server.launch
On Linux with bash:
docker build -t strawlab-focal --file Dockerfile.focal .
docker run -it -v `pwd`:/ansible:ro strawlab-focal
On Windows with powershell:
docker build -t strawlab-focal --file Dockerfile.focal .
docker run -it -v ${PWD}:/ansible:ro strawlab-focal
The files in this repository are licensed under the BSD 3-clause license. See
LICENSE.txt
for more information.