Sophia/librenms-speedtest
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

add instructions

Browse Source
This commit is contained in:
Jack Greyhat
2021-01-28 13:53:34 +01:00
parent 2d2d18f468
commit 88ec18d9ab
1 changed files with 26 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

49
README.md
View File

@ -13,33 +13,36 @@ Screenshot:<br/>
- Shell access to the LibreNMS server.
- Speedtest CLI by Ookla. To install this, use the following link and instructions:
- https://www.speedtest.net/apps/cli
- Verify you are running Speedtest CLI by Ookla by issuing the following command on your CLI:<br/>
```
speedtest --version
```
Expected example output: <br/>
```
Speedtest by Ookla 1.0.0.2 (5ae238b) Linux/x86_64-linux-musl 5.4.0-64-generic x86_64
The official command line client for testing the speed and performance
of your internet connection.
```
Note:<br/>
- Verify you are running Speedtest CLI by Ookla by issuing the following command on your CLI:<br> `speedtest --version`
Expected example output: `Speedtest by Ookla 1.0.0.2`
```
NOTE:<br/>
There is also the "speedtest-cli" package, which is possibly provided by your distribution's repository. This package, however, does not follow the same cli commands as the Ookla's Speedtest CLI package and is built with Python. It is known to under perform in some cases.<br/>
This dashboard will not work out of the box with the "speedtest-cli" package. Prefer to install Ookla's package.
```
### Plugin Installation
NOTE: These instructions assume you are the root user. If you are not, prepend sudo to the shell commands or temporarily become a user with root privileges.
- Login to your LibreNMS' server CLI.
- Go to your home dir: `cd ~/`
- Clone this repository into your home dir: `git clone https://gitlab.com/jackgreyhat/librenms-speedtest.git`
- Create the plugin directory into LibreNMS' plugin folder: `mkdir /opt/librenms/html/plugins/Speedtest`
- Copy the LibreNMS speedtest plugin contents into the newly created directory: `cp -r ~/librenms-speedtest/. /opt/librenms/html/plugins/Speedtest`
- Ensure correct ownership and permissions on the Speedtest plugin directory and files:
```
chown -R librenms:librenms /opt/librenms/html/plugins/Speedtest
chmod -R --reference=/opt/librenms/html/plugins/Test /opt/librenms/html/plugins/Speedtest
chmod +x /opt/librenms/html/plugins/Speedtest/librenms-speedtest.sh
NOTE:
These instructions assume you are the root user. If you are not, prepend sudo to the shell commands or temporarily become a user with root privileges.
```
- Login to your LibreNMS server CLI.
- Go to your home dir:<br/>
`cd ~/`
- Clone this repository into your home dir:<br/>
`git clone https://gitlab.com/jackgreyhat/librenms-speedtest.git`
- Create the plugin directory into LibreNMS plugin folder:<br/>
`mkdir /opt/librenms/html/plugins/Speedtest`
- Copy the LibreNMS speedtest plugin contents into the newly created directory:<br/>
`cp -r ~/librenms-speedtest/. /opt/librenms/html/plugins/Speedtest`
- Ensure correct ownership and permissions on the Speedtest plugin directory and files:<br/>
`chown -R librenms:librenms /opt/librenms/html/plugins/Speedtest`
`chmod -R --reference=/opt/librenms/html/plugins/Test /opt/librenms/html/plugins/Speedtest`
`chmod +x /opt/librenms/html/plugins/Speedtest/librenms-speedtest.sh`
- Switch to the librenms user:<br/>
`su - librenms`
- Accept the speedtest EULA and GDPR notice (if applicable) and run an initial speedtest:
`speedtest --accept-license --accept-gdpr`
- Go to the Speedtest plugins directory:
`cd /opt/librenms/html/plugins/Speedtest/`