Skip to content

systemd unit and readme section fixes #2

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.

Sign up for GitHub

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

Open
mbound wants to merge 2 commits into
base: master
Choose a base branch
from
Open

systemd unit and readme section fixes #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
baec0a4
adding systemd unit and readme section. fixed lldpd package in debian…
Oct 15, 2021
efaef2a
Update README.md
Jan 11, 2022
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
34 changes: 27 additions & 7 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,18 +23,38 @@ First, create bridge interfaces on your appliance and connect each bridge interf
Connect each WAN end to a physical interface.
Install and start wanem and use the HTML interface to configure the bandwidth, the delay, the packet loss and the jitter of each interface.

### Installing on Debian
### Installing on Debian or Ubuntu (tested on 16.04 and 18.04)

```
apt-get update
apt-get install ruby bridge-utils lldp ruby-dev
gem install sinatra
gem install thin
git clone https://github.com/PJO2/wanem
apt-get install build-essential ruby bridge-utils lldpd ruby-dev
gem install sinatra --no-ri --no-rdoc
gem install thin --no-ri --no-rdoc
git clone https://github.com/mbound/wanem
cd wanem
ruby ./http_main.rb
```

### Autostart with systemd (example on Ubuntu 18.04, should work with 16.04 as well)

On systemd-based distributions, wanem can be auto-started at boot with a simple systemd unit file (provided in the repository).
Note that this unit is written with the assumptions that:
- the service will be started as `root` user
- the `http_main.rb` is in `/home/ubuntu/wanem`

Make sure to change both accordingly before installing the unit.

To install and start the unit:
```
sudo cp wanem.service /etc/systemd/system/
systemctl enable wanem
systemctl start wanem
```
To check the status:
```
systemctl status wanem
```


### Installing on Cumulus Linux
ruby-dev is not a package, should be installed manually
Expand All @@ -50,7 +70,7 @@ dpkg -i ruby2.1-dev_2.1.5-2+deb8u6_amd64.deb

gem install sinatra:1.4.8
gem install thin
git clone https://github.com/PJO2/wanem
git clone https://github.com/mbound/wanem
cd wanem
ruby ./http_main.rb
```
Expand All @@ -73,7 +93,7 @@ yum install bridge-utils lldpd ruby ruby-dev
gem install sinatra:1.4.8
gem install thin

git clone https://github.com/PJO2/wanem
git clone https://github.com/mbound/wanem
cd wanem
ruby ./http_main.rb
```
Expand Down
13 changes: 13 additions & 0 deletions wanem.service
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# wanem.service
[Unit]
Description=Starts Wanem WAN emulator web UI

[Service]
User=root
Group=root
WorkingDirectory=/home/ubuntu/wanem
Restart=always
ExecStart=/usr/bin/ruby ./http_main.rb

[Install]
WantedBy=multi-user.target