-
Notifications
You must be signed in to change notification settings - Fork 8
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'development' of https://github.com/5G-MAG/rt-wui into main
� Conflicts: � README.md
- Loading branch information
Showing
6 changed files
with
64 additions
and
79 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -102,3 +102,6 @@ dist | |
|
||
# TernJS port file | ||
.tern-port | ||
|
||
#Webstorm | ||
.idea |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,50 +1,10 @@ | ||
# Installation guide | ||
Installation of 5G-MAG Reference Tools *Webinterface* consists of 4 Steps: | ||
1. Install dependencies | ||
2. Building the *Webinterface* | ||
3. Post installation configuration | ||
4. Run the *Webinterface* | ||
# rt-wui | ||
|
||
> The build was tested and verified on Ubuntu 20.04 LTS (64 bit). | ||
The 5G-MAG Reference Tools Webinterface (rt-wui) provides an optional graphical webinterface with a control display for | ||
each 5G-MAG Reference Tools process (MBMS Modem, MBMS Middleware, Application). Its main purpose is to collect and | ||
display useful information from the MBMS Modem, MBMS Middleware and Application Process. It also enables use cases where | ||
the 5G-MAG Reference Tools can be used for simple measurements (e.g., mobile measurements) or as a standalone device ( | ||
e.g., set-top box, mobile phone/tablet showcase). | ||
|
||
## Step 1: Install dependencies | ||
For the webinterface an additional package to the dependencies in *MBMS Modem* (see [here](https://github.com/5G-MAG/rt-mbms-modem#readme)) has to be installed for building: | ||
```` | ||
sudo apt update | ||
sudo apt install npm nginx | ||
```` | ||
|
||
## Step 2: Building the *Webinterface* | ||
### 2.1 Getting the source code | ||
```` | ||
cd ~ | ||
git clone https://github.com/5G-MAG/rt-wui | ||
```` | ||
|
||
### 2.2 Installing | ||
```` | ||
cd rt-wui | ||
npm install | ||
```` | ||
|
||
## Step 3: Post installation configuration | ||
As a last step you have to enable the nginx site, to allow requests to the 5G-MAG Reference Tools Webinterface over http. | ||
|
||
### 3.1 Creating a symbolic link | ||
Change to the sites-enabled directory and create a symbolic link from the rt-wui file in sites-available. After that, delete the default sym link: | ||
|
||
```` | ||
cd /etc/nginx/sites-enabled | ||
sudo ln -s ../sites-available/5gmag-rt-wui 5gmag-rt-wui | ||
sudo rm default | ||
```` | ||
|
||
### 3.2 Restart and enable autostart for nginx | ||
After creating the symbolic links, nginx has to be restarted. To always have the Webinterface available at startup, you can enable autostart via systemctl: | ||
```` | ||
sudo systemctl restart nginx.service | ||
sudo systemctl enable nginx.service | ||
```` | ||
|
||
## Step 4: Run the *Webinterface* | ||
After installing, make sure to follow the instructions in the *Documentation and Architecture* repository to [run the *5G-MAG Reference Tools Webinterface*](https://github.com/5G-MAG/Documentation-and-Architecture/wiki/Webinterface#Run-the-Webinterface). | ||
**A detailed overview and the installation instructions can be found in | ||
our [Wiki](https://github.com/5G-MAG/Documentation-and-Architecture/wiki/Webinterface).** |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters