From 2336aef63624b4d91a770ca92d82f17b2dcc78cb Mon Sep 17 00:00:00 2001 From: Steve Lewis KC0EUW Date: Sun, 23 Feb 2020 08:01:34 -0700 Subject: [PATCH] Move wifi down to How-To Move wifi down tip to How-To guide. --- arednGettingStarted/downloading_firmware.rst | 2 +- arednGettingStarted/installing_firmware.rst | 2 -- arednHow-toGuides/firmware_upgrade.rst | 6 ++++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/arednGettingStarted/downloading_firmware.rst b/arednGettingStarted/downloading_firmware.rst index 883c4f8..61292de 100644 --- a/arednGettingStarted/downloading_firmware.rst +++ b/arednGettingStarted/downloading_firmware.rst @@ -17,7 +17,7 @@ Once you have selected the correct firmware image for your device, click the lin **Features Inherited from OpenWRT for New Architectures** The latest AREDN |trade| firmware contains features which are inherited from the newest OpenWRT upstream release (19.07). The OpenWRT *Release Notes* describe these new features and can be found here: `OpenWRT 19.07 Release Notes `_ - One important change is the inclusion of a new *target* for the firmware, labelled "ath79", which is the successor to the existing "ar71xx" target. The OpenWRT team explains the new target here: `ath79 `_. Their main goal is to bring the code into a form that will allow all devices to run a standard unpatched Linux kernel. This will greatly reduce the amount of customization required and will streamline the firmware build process. + One important change is the inclusion of a new *target* for the firmware, labelled "ath79", which is the successor to the existing "ar71xx" target. The OpenWRT team explains the new target here: `ath79 `_. Their main goal is to bring the code into a form that will allow all devices to run a standard unpatched Linux kernel. This will greatly reduce the amount of customization required and will streamline the firmware development process. You may notice that the AREDN |trade| firmware download page has one or both of these firmware versions for specific devices. Refer to the latest `firmware notes `_ in order to ensure you have the correct firmware image for your specific device. diff --git a/arednGettingStarted/installing_firmware.rst b/arednGettingStarted/installing_firmware.rst index c3de1b4..d68fff7 100644 --- a/arednGettingStarted/installing_firmware.rst +++ b/arednGettingStarted/installing_firmware.rst @@ -229,8 +229,6 @@ my-computer:$ ssh -p 2222 root@192.168.1.1 ~~~~~~~ after logging into the node as root (hsmm) ~~~~~~~ node:# sysupgrade -n /tmp/aredn-firmware-filename.bin -The steps above will usually work for operators struggling to install AREDN |trade| firmware on a *Mikrotik hAP ac lite* device. Recently another issue was described in the upstream OpenWRT code. The 5GHz 802.11ac wireless driver used only in the *hap ac lite* has a memory issue which can leave the device without sufficient memory to complete the firmware install. The AREDN |trade| development team advises that, if you can telnet or ssh to the node and type the command ``wifi down`` you can free the memory used by this driver. Then the firmware install from the command line or web interface should work as designed. - Additional questions and troubleshooting assistance can usually be obtained by creating a post on the AREDN |trade| `online forum `_, which has an active community of helpful and experienced operators. Post-Install Steps diff --git a/arednHow-toGuides/firmware_upgrade.rst b/arednHow-toGuides/firmware_upgrade.rst index 0c7cfbb..0dfb7aa 100644 --- a/arednHow-toGuides/firmware_upgrade.rst +++ b/arednHow-toGuides/firmware_upgrade.rst @@ -6,11 +6,13 @@ Upgrading an AREDN |trade| node is a straightforward process accomplished using Here are some "best practice" tips to assist with the firmware upgrade process. These ensure that memory utilization is at its minimum on the node. The upgrade process can fail due to lack of memory, but such a failure will leave the node unchanged on its previous firmware version. -Before starting the firmware upgrade, it may be necessary to stop, disable, or uninstall Meshchat, hamchat, snmp, and any active tunnels. The goal of this step is to keep those processes from using RAM memory and to free as much RAM as possible before the upgrade. Rebooting the node will ensure that its RAM utilization is at a minimum. +Before starting the firmware upgrade, it may be necessary to stop, disable, or uninstall extra packages such as Meshchat, snmp, and tunneling. The goal of this step is to keep those processes from using RAM memory and to free as much RAM as possible before the upgrade. Rebooting the node will ensure that its RAM utilization is at a minimum. + +You may also want to stop node programs or services that are not needed during the upgrade. For example, if you can telnet or ssh to the node and type the command ``wifi down`` you can free the memory used by this driver. When using a web browser to perform an upgrade, be sure to clear the browser's cache to remove any cached pages remaining from your node's previous firmware version. A clear cache will help to eliminate confusion when displaying node data in the browser. -Use a stepped approach to firmware upgrades. For example, if your node is running version 3.16.1.0 you should probably upgrade to version 3.18.9.0 before attempting to apply a newer version. +Use a stepped approach to firmware upgrades. For example, if your node is running version 3.18.9.0 you should probably upgrade to version 3.19.3.0 before attempting to apply a newer version. .. |trade| unicode:: U+00AE .. Registered Trademark SIGN