From f4067f70883ce46842ece5c1431227b2e4cd7559 Mon Sep 17 00:00:00 2001 From: ab7pa Date: Thu, 27 Jun 2024 10:27:10 -0700 Subject: [PATCH] newUI-20 --- arednGettingStarted/node_admin.rst | 50 ++++++++++++------------------ 1 file changed, 19 insertions(+), 31 deletions(-) diff --git a/arednGettingStarted/node_admin.rst b/arednGettingStarted/node_admin.rst index a2d6d3b..5c7634a 100644 --- a/arednGettingStarted/node_admin.rst +++ b/arednGettingStarted/node_admin.rst @@ -165,7 +165,7 @@ LAN Size Another choice is ``NAT`` and in this mode the LAN is isolated from the mesh. All outgoing traffic has its source address modified to be the *Mesh* IP address of the node itself. This is the same way that most home routers use an Internet connection, and all services provided by computers on the LAN can only be accessed through port forwarding rules. - Finally, you may also ``disable`` your node's ability to provide a LAN network. + Finally, you may also ``disable`` your node's ability to provide a LAN network. If the LAN is disabled then the node's DHCP server will also be disabled. WAN Enable This switch allows you to enable or disable your node's WAN interface, which is typically used to connect to the Internet or some other external network. The WAN interface is ``enabled`` by default, and the *Mode* setting below will be displayed. If you ``disable`` the WAN interface, the *Mode* setting will not appear. @@ -286,15 +286,18 @@ Watchdog Daily Watchdog hour Enter an integer between 0 - 23 which represents the hour of each day that you would like Watchdog to automatically reboot your node. The default is an empty field, in which case Watchdog will not auto-reboot your node. -.. image:: _images/admin-internal-svc-3.png - :alt: Admin Internal Services continued - :align: center - -| +PoE and USB Power Passthrough + These settings will only appear if you have node hardware which supports PoE or USB power passthrough. One example is the *Mikrotik hAP ac lite* which provides one USB-A power jack as well as ~22v PoE power passthrough on Ethernet port 5. You are allowed to enable or disable power passthrough on nodes with ports that support this feature. Message Updates The AREDN |trade| development team may post messages which Internet-connected nodes will automatically download and display. You may also use a local message source to display messages on your node's status page. Enter an integer in this field for the number of hours you want your node to wait before refreshing its messages. The default value is ``1`` hour between updates. + .. image:: _images/admin-internal-svc-3.png + :alt: Admin Internal Services continued + :align: center + + | + Local Message URL This field allows you to enter the URL for a local message source. If you configure a local message server, then your nodes without Internet access can also receive alert messages pertinent to your local mesh. Enter the URL without a trailing backslash. @@ -343,6 +346,16 @@ Viewing, Editing, and Deleting Services You can click the ``Cancel`` button to ignore any changes you made on this display. When you are finished with your changes, click the ``Done`` button. You will then be returned to your node's *admin* view where you will be able to ``Commit`` or ``Revert`` your changes. + Service Advertisement Process + `OLSR (Optimized Link State Routing) `_ propagates service entries to other nodes across the network. Once every hour your node will verify that its own service entries are valid. Your node will **not** propagate services across the network if it finds any of these conditions: + + 1. The host is not pingable across the network + 2. There is no service listening on the specified port + 3. The HTTP link does not return a *success* status code + 4. The package for this service is not yet installed + + The node's *Advertised Services* list will still show the defined service (with an alert icon and hover text marking it as non-advertised), but your node will not actually *advertise* that service to the network. If the service URL becomes reachable in the future or if the dependent package is later installed, then your node will resume advertising the service across the network. + Managing Host Aliases *Host Aliases* provide a way for you to create a hostname alias for a device on your node's LAN. This can be useful if you want a computer or device on your LAN to be identified by something other than its actual hostname. Your Host Alias will be propagated across the network even if the actual hostname has *Do Not Propagate* checked in its DHCP Reservation, allowing you to hide the actual hostname while still advertising the alias on the mesh. Once an alias is defined, it will become available for creating local services (described above). @@ -763,31 +776,6 @@ iPerf3 Support Data There may be times when you want to view more detailed information about the configuration and operation of your node, or even forward this information to the AREDN |trade| team in order to get help with a problem. Click the *Support Data* icon to save a compressed archive file to your local computer. - ---------------------------------------------------------------------- - - -Service Advertisement Process ??? - `OLSR (Optimized Link State Routing) `_ propagates service entries to other nodes across the network. Once every hour your node will verify that its own service entries are valid. Your node will **not** propagate services across the network if it finds any of these conditions: - - 1. The host is not pingable across the network - 2. There is no service listening on the specified port - 3. The HTTP link does not return a *success* status code - 4. The package for this service is not yet installed - - The node's *Advertised Services* list will still show the defined service (with an alert icon and hover text marking it as non-advertised), but your node will not actually *advertise* that service to the network. If the service URL becomes reachable in the future or if the dependent package is later installed, then your node will resume advertising the service across the network. - - -PoE and USB Power Passthrough ??? - These rows will only appear in the table if you have node hardware which supports PoE or USB power passthrough. One example is the *Mikrotik hAP ac lite* which provides one USB-A power jack, as well as PoE power passthrough on Ethernet port 5. You are allowed to enable or disable power passthrough on nodes with ports that support this feature. Move the slider to **ON** and click *Save Setting* to enable power passthrough. - - -Tunnel WAN Only Setting ??? - This setting is enabled by default and it prevents tunnel traffic from being routed over the Mesh network. It limits tunnels to using the WAN interface, which is typically the intended route. If in your situation you need tunnel traffic to be routed over RF to a node with WAN access, then you can disable this setting to allow that traffic to pass. - - - - Node Reset Button Actions -------------------------