diff options
| author | Christian Poessinger <christian@poessinger.com> | 2019-11-24 20:24:35 +0100 |
|---|---|---|
| committer | Christian Poessinger <christian@poessinger.com> | 2019-11-24 20:24:44 +0100 |
| commit | 46fa911c528d58567c721ee1b510d48f584e7de0 (patch) | |
| tree | d14ae6472aeeafd8d8e42bdd8025c1392427d968 | |
| parent | d9c14434aba05d94a3503c675d9eb819dc5107aa (diff) | |
| download | vyos-documentation-46fa911c528d58567c721ee1b510d48f584e7de0.tar.gz vyos-documentation-46fa911c528d58567c721ee1b510d48f584e7de0.zip | |
pppoe: restructure op-mode examples
| -rw-r--r-- | docs/interfaces/pppoe.rst | 56 |
1 files changed, 19 insertions, 37 deletions
diff --git a/docs/interfaces/pppoe.rst b/docs/interfaces/pppoe.rst index 576513a1..eca9a5f4 100644 --- a/docs/interfaces/pppoe.rst +++ b/docs/interfaces/pppoe.rst @@ -16,7 +16,7 @@ predominately via the PAP protocol and less often via CHAP. Operating Modes --------------- -VyOS supports setting up PPPoe in two different ways to a PPPoE internet +VyOS supports setting up PPPoE in two different ways to a PPPoE internet connection. This is due to most ISPs provide a modem that is also a wireless router. @@ -97,9 +97,9 @@ assigning it to the pppoe0 itself as shown here: VLAN Example ++++++++++++ -Some recent ISPs require you to build the PPPoe connection through a VLAN +Some recent ISPs require you to build the PPPoE connection through a VLAN interface. One of those ISPs is e.g. Deutsche Telekom in Germany. VyOS -can easily create a PPPoe session through an encapsulated VLAN interface. +can easily create a PPPoE session through an encapsulated VLAN interface. The following configuration will run your PPPoE connection through VLAN7 which is the default VLAN for Deutsche Telekom: @@ -118,46 +118,28 @@ which is the default VLAN for Deutsche Telekom: Troubleshooting --------------- -Connect/Disconnect -****************** +.. opcmd:: disconnect interface <interface> -You can test connecting and disconnecting with the below commands issued -on the operational level of your VyOS isntallation: +Test disconnecting given connection-oriented interface. `<interface>` can be +``pppoe0`` as example. -.. code-block:: sh - - disconnect interface 0 - connect interface 0 - -Logs -**** - -You can check the PPPoE connection logs with the following command which -shows the current statistics, status and some of the settings (i.e. MTU) -for the current connection on pppoe0. - -.. code-block:: sh - - show interfaces pppoe 0 +.. opcmd:: connect interface <interface> -Full Log -~~~~~~~~ +Test connecting given connection-oriented interface. `<interface>` can be +``pppoe0`` as example. -This command shows the entire log for the PPPoE connection starting with the -oldest data. Scroll down with the <space> key to reach the end where the -current data is. +.. opcmd:: show interfaces pppoe <interface> -.. code-block:: sh +Check PPPoE connection logs with the following command which shows the current +statistics, status and some of the settings (i.e. MTU) for the current +connection on <interface> (e.g. ``pppoe0``) - show interfaces pppoe 0 log +.. opcmd:: show interfaces pppoe <interface> log -Recent Log -~~~~~~~~~~ +Show entire log for the PPPoE connection starting with the oldest data. Scroll +down with the <space> key to reach the end where the current data is. -This command shows the same log as without the 'tail' option but only starts -with the last few lines and continues to show added lines until you exit with -``Ctrl + x`` - -.. code-block:: sh +.. opcmd:: show interfaces pppoe <interface> log tail - show interfaces pppoe 0 log tail +Shows the same log as without the 'tail' option but start with the last few +lines and continues to show added lines until you exit with ``Ctrl + x`` |