github-mirror/route0
1
0
Fork 0
mirror of https://github.com/Wojtek242/route0.git synced 2024-11-21 23:05:24 +01:00
Code Issues Packages Projects Releases Wiki Activity

Add link and instructions for VM image

Browse Source
This commit is contained in:
Wojciech Kozlowski 2019-04-07 17:31:04 +02:00
parent 9c1b34e9b2
commit da114867b1
2 changed files with 53 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
README.md
View File

@ -40,10 +40,20 @@ provisioned, and brought up on a single computer.
For the best experience it is recommended to run Route 0 experiments using the
Virtual Machine (VM) image developed specifically for this project.
TODO: INSTRUCTIONS FOR VM IMAGE
1. [Download the ova file](https://drive.google.com/open?id=1mlovQSG-xYbBFboqUwKugpQrQNCEoWzd).
2. In VirtualBox select `File->Import Appliance`, select the downloaded ova
file and then confirm all the settings. You may adjust the settings, but
the defaults will work just fine.
3. Start the Virtual Machine.
4. (Optional) For a better experience install the VirtualBox Guest Additions.
Instructions on how to do that can be found
[here](PLATFORM.md#virtualbox-guest-additions).
The account user name is `route0` and the password (needed for sudo commands)
is also `route0`.
If you would prefer to set up your own environment, you can follow these
[instructions](platform.md). They describe the steps needed to produce the
[instructions](PLATFORM.md). They describe the steps needed to produce the
exact same VM image available above.
Note that the VM does not come with the `route0` repository. This is because
@ -78,7 +88,7 @@ sudo python route0.py --topology <topology_name> --scenario <scenario_name>
To connect to an FRR daamon, you can either run the following command inside
the Mininet CLI
```
<node_name> telnet localhost <daemon_name>
noecho <node_name> telnet localhost <daemon_name>
```
You can also connect to an FRR daemon from a different terminal than the one in

47
platform.md
View File

@ -8,9 +8,9 @@ up to date kernel, Mininet, and FRR installation, but this has not been tested.
## Setting up a Virtual Machine
The following instructions setup exactly the same VM that is available from
this image (TODO: link). The instructions are provided below if for some
reason you would prefer not to or are not able touse the pre-distributed image.
The following instructions setup exactly the same VM that is suggested in the
`README` file. The instructions are provided below if for some reason you
would prefer not to or are not able to use the pre-distributed image.
### Base Operating System
@ -44,9 +44,38 @@ the terminal and run the following command
sudo apt purge unattended-upgrades
```
If you are using VirtualBox, you may find it useful to install the Guest
Additions. To install these Guest Additions follow [these
instructions](https://askubuntu.com/questions/22743/how-do-i-install-guest-additions-in-a-virtualbox-vm).
### VirtualBox Guest Additions
If you are using VirtualBox, you may find it useful to install the VirtualBox
Guest Additions. Note that these are not actually included in the provided VM
image as the installation depends on VirtualBox version.
The best way to install the guest additions is to install them from the ISO
image provided by VirtualBox. Before doing that though, you need to first
install `dkms` and `build-essential`. In the terminal run
```
sudo apt install dkms build-essential
```
Now you need to obtain the CD. Open your VM and from the menu bar select
`Devices->Insert Guest Additions CD image`. This will download the image.
In case the download fails, you can download the image directly from the
[VirtualBox website](http://download.virtualbox.org/virtualbox/). Make sure
you choose the right version for your VirtualBox installation (you can find it
from the menu bar `Help->About VirtualBox`) and download the
`VBoxGuestAdditions_<version>.iso`. Once the download completes make sure to
mount it in the settings window of your virtual machine.
Open the file explorer and navigate to the inserted CD. From here right click
and select `Open Terminal Here`. The last step is now to run
```
sudo ./VBoxLinuxAdditions.run
```
Once the installation completes, reboot the VM. Amongst other things you can
now enable the shared clipboard from the menu bar with `Devices->Shared
Clipboard`.
### Installing Mininet
@ -69,4 +98,8 @@ mininet/util/install.sh -fw
Installing FRR is also easy on Ubuntu as the developers maintain a Debian
repository which can be used for Ubuntu as well. To install FRR from this
repository follow [these instructions]((https://deb.frrouting.org/)).
repository, install curl
```
sudo apt install curl
```
and follow [these instructions]((https://deb.frrouting.org/)).