Specifications

AMF Introduction and Configuration
146 New and Enhanced Features in AlliedWare Plus 5.4.4 Major and Minor Versions
A clean device is one that has had its previous configuration components removed. The
process of cleaning is required when replacing a failed device with one that, although in
working condition, has been used previously and still retains components of its previous
configuration.
If you keep on-site spares, store them with clean configurations and current releases.
When you upgrade your network to a new AlliedWare Plus version, we recommend you
upgrade your spare devices too.
To clean up a previously used device, use the atmf cleanup command on page 174. This
command erases all data from NVS and Flash apart from:
■ The boot release file (a .rel file) and its release setting file
■ v1 license files /.configs/.swfeature.lic
■ v2 license files /.configs/.sw_v2.lic
The device is then rebooted to put it into a clean state. The device can then be used for
automatic node recovery.
Any other user files that remain in Flash will be overwritten during the automatic recovery
process. If there are any files stored in the Flash of the replacement device that need to be
retained, back these files up prior to installing the device into the AMF network.
Manual Node Recovery
There are certain situations where automatic recovery may fail. Automatic recovery has
been designed to be cautious in its approach to recovering nodes for reasons such as:
■ The backup stored on the AMF master not having a “Good” status
■ The replacement device having a release of the AlliedWare Plus Operating System
installed on it that is old enough to be incompatible with AW+ on the neighbor or the
master.
When these situations occur, automatic node recovery will fail.
In this failed state, the replacement device will have the AMF safe configuration mode
applied (see “AMF Safe Configuration Procedures” on page 148). After investigating
the failure and taking remedial action, you may want to initiate manual node recovery. To
do this, enter the following command:
where:
■ node_name is the host name of the device you wish to recover.
■ master_node_name is the host name of the AMF master that contains the backup
you want to use for the recovery.
The manual recovery command will bypass the usual checks performed by automatic
node recovery. Make sure that the backup configuration stored on the specified AMF
master is correct before you execute the command.
If you attempt to manually recover a node with the backup file of a node from a different
platform, the release file from the backup will be incompatible and won’t be copied to the
replacement device. Instead, the existing release on the replacement device will be used,
in order to ensure the device can join the AMF network and function correctly.
amf1#
atmf recover {<node_name>} {<master_node_name>}