From f5f86e6365fdacac75903e728c99706dbc18a229 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20K=C3=BCthe?= Date: Sun, 8 Jan 2023 00:20:00 +0100 Subject: [PATCH 1/2] add doc how to activate the local configuration interface MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Marek Küthe --- docs/routing/babeld/babeld.md | 19 +++++++++++++++++++ docs/routing/babeld/babelweb2.md | 23 +++++++++++++++++++++++ 2 files changed, 42 insertions(+) create mode 100644 docs/routing/babeld/babelweb2.md diff --git a/docs/routing/babeld/babeld.md b/docs/routing/babeld/babeld.md index 11ac70e..01095d5 100644 --- a/docs/routing/babeld/babeld.md +++ b/docs/routing/babeld/babeld.md @@ -138,6 +138,25 @@ babeld -c Once babeld is started, forwarding is enabled in the kernel for IPv4 and IPv6. As soon as babeld is stopped, forwarding is deactivated again. A separate enabling like with bird is not necessary. So if you use babeld, you can ignore the steps of [IPv6 forwarding](../forwarding). +## Local configuration interface + +babeld offers a local configuration interface. This can be activated with the flag `-g`. For example, to enable the configuration interface on port `33123`, you can use the following command: +``` +babeld -g 33123 +``` + +The configuration interface can be used to find out various status information on the one hand and to configure babeld on the other. Furthermore, the configuration interface can be used by monitoring programs such as babelweb2. + +To connect to the configuration interface, you can use telnet: +``` +telnet ::1 33123 +``` + +With the command `dump` you can display the current status: +``` +dump +``` + ## Further links - [babeld homepage](https://www.irif.fr/~jch/software/babel/) diff --git a/docs/routing/babeld/babelweb2.md b/docs/routing/babeld/babelweb2.md new file mode 100644 index 0000000..f00d58e --- /dev/null +++ b/docs/routing/babeld/babelweb2.md @@ -0,0 +1,23 @@ + +# babelweb 2 + +babelweb 2 is a monitoring tool for Babel. It shows with a web interface the current neighbors, the current routes and a graphical overview of the babel network. + +## Installation + +First you have to download go. You can do this on Debian for example with the following command: +``` +sudo apt install golang +``` + +After that you have to clone the current git repo and compile the program: +``` +git clone https://github.com/Vivena/babelweb2 +cd babelweb2 +go build +``` +Now you have an executable program `babelweb2`. + +By default, the web interface runs on port 8080. You can also specify a different endpoint with the `-http` parameter. + +babelweb2 uses the local configuration interface of babeld. This must have been activated beforehand. babeld assumes that this is active on `[::1]:33123`. Alternatively, you can specify the endpoint with the `-node=` flag. From 9027ad30902d82e4ef350bdd2dd192b06f3d2fbc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20K=C3=BCthe?= Date: Sun, 8 Jan 2023 00:36:31 +0100 Subject: [PATCH 2/2] add menu entry MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Marek Küthe --- docs/routing/index.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/routing/index.md b/docs/routing/index.md index 8024fb6..3b32ac2 100644 --- a/docs/routing/index.md +++ b/docs/routing/index.md @@ -10,3 +10,4 @@ ## babeld - [Setting up Babeld](babeld/babeld) +- [babelweb2](babeld/babelweb2)