Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

update install docs #6

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
56 changes: 55 additions & 1 deletion INSTALL.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Installing ROSRV
# ROSRV Manual Installation

Here are instructions for installing and building ROSRV by checking out its
source code on GitHub.
Expand Down Expand Up @@ -42,3 +42,57 @@ via catkin as `catkin run rvmonitor <MONITOR_NAME>`.
See [docs/Usage.md](docs/Usage.md) for further information on how to run ROSRV.
Get help or report problems on
[ROSRV's issues page](https://github.com/FormalSystemsLaboratory/ROSRV/issues).

# ROSRV Guided Installation

These instructions will take you from a fresh box to a working ROSRV installation.
For maximum portability, installing a fresh machine/VM is recommended.

0. Find an Ubuntu 16.04 box or spin up a new Ubuntu 16.04 machine/VM.
All other steps occur on this machine/VM and assume the default shell is bash.

1. Setup ROS PPA

```
sudo sh -c '. /etc/lsb-release && echo "deb http://mirror.umd.edu/packages.ros.org/ros/ubuntu $DISTRIB_CODENAME main" > /etc/apt/sources.list.d/ros-latest.list'
sudo apt-key adv --keyserver 'hkp://keyserver.ubuntu.com:80' --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654
sudo apt-get update
```

2. Install ROS package and RV-Monitor and ROSRV dependencies

```
sudo apt install ros-kinetic-desktop-full
sudo apt install default-jdk-headless clang-6.0 maven python3-pip python3-yaml ros-kinetic-marti-common-msgs
```

3. Initialize ROS with this magic

```
sudo rosdep init
rosdep update
echo "source /opt/ros/kinetic/setup.bash" >> ~/.bashrc
source ~/.bashrc
```

4. Install pytest via pip3

```
pip3 install pytest
```

5. Install RVMonitor on the darpa branch and setup environment variable

```
git clone -b darpa https://github.com/runtimeverification/rv-monitor
( cd rv-monitor; mvn install -DskipTests; )
echo "export RVMONITOR=\"$(pwd)/rv-monitor\"" >> $HOME/.bashrc
```

6. Get ROSRV master and run the tests (minus the DDL tests)

```
git clone https://github.com/Formal-Systems-Laboratory/ROSRV
cd ROSRV
PYTEST_FLAGS="--skip-dl-tests" ./Test
```