AMF (Allied Telesis Management Framework) Software Reference Supplement for x-Series Switches AlliedWare Plus™ Operating System Version 5.4.
Acknowledgments This product includes software developed by the University of California, Berkeley and its contributors. Copyright ©1982, 1986, 1990, 1991, 1993 The Regents of the University of California. All rights reserved. This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/). Copyright ©1998-2008 The OpenSSL Project. All rights reserved.
Contents of this Software Reference Supplement This document introduces AMF for Allied Telesis x-series switches. It contains the following introductory material on AMF, including links to related information.
AMF Software Reference Supplement for Allied Telesis x-Series Switches 4 AlliedWare PlusTM Operating System - Software Version 5.4.3-1.
Introduction to AMF AMF, the Allied Telesis Management Framework, is a suite of network management features that simplify management of its member switches—from the network core out to its edge. AMF simplifies switch recovery and firmware replacements and upgrades. It greatly reduces the network management and maintenance overhead. AMF Capable Products and Software AMF is supported on the following products when running software version 5.3.4-1.4 or later: ■ Switchblade™ x8100 series switches.
Video Topic Centralized Network Management This video shows how the management of modern complex networks can be greatly simplified with AMF. Click the following link to view the video: www.alliedtelesis.com/videos/AMFmanagement Auto-provisioning This video shows how the addition of new switches to expand the network can be automated with AMF. Click the following link to view the video: www.alliedtelesis.
Video Topic AMF Live Demo: Zero-Touch Auto Recovery This video shows a live demonstration of the autorecovery feature of AMF. A network device is powered off to simulate a failure and the replacement is automatically re-configured by AMF without any user intervention. Click the following link to view the video: www.alliedtelesis.com/videos/AMFautorecovery AMF Software Reference Supplement for Allied Telesis x-Series Switches C613-50031-01 REV B AlliedWare PlusTM Operating System - Software Version 5.4.
AMF Software Reference Supplement for Allied Telesis x-Series Switches 8 AlliedWare PlusTM Operating System - Software Version 5.4.3-1.
Technical Guide How To | Configure and Use AMF on Allied Telesis Switches Introduction The Allied Telesis Management Framework (AMF) is a suite of features that combine to simplify network management across all supported network devices from the core to the edge. AMF also provides simplified unit recovery and firmware upgrade management.
Introduction Contents Introduction............................................................................................................................................................................. 9 What information will you find in this document?................................................................................... 9 Which products and software version does it apply to? ..................................................................... 9 Software feature licensing ..............
Introduction Adding a preconfigured device to the network ..............................................................................................36 Using the unified CLI with working-sets...............................................................................................................38 The working-set........................................................................................................................................................38 Working-set groups ..............
The key benefits of AMF The key benefits of AMF The key benefits of AMF include its: unified command-line, simple configuration backup and recovery process, and time-saving rolling firmware upgrade. Unified command-line The primary means of configuring and controlling AlliedWare Plus (AW+) units is via a textbased command-line interface. In existing networks, this command-line is available via a serial console port as well as remote login sessions (e.g. SSH).
AMF concepts AMF concepts Network name The AMF network name is used to determine the AMF network a node belongs to. All nodes within an AMF network must be configured with the same AMF name. Node AMF members are commonly referred to as nodes. A node can be a single switch, or a VCStack. Master nodes AMF master nodes are user defined and form the core domain of the AMF network. They are: responsible for performing file system backups of all nodes in the AMF network.
AMF concepts nodes connected via regular AMF links will be part of a higher or lower domain depending on whether they are closer to or further away from the core domain. Nodes within a domain must be connected in either a chain or ring topology. This means that a maximum of two crosslinks should be configured on any single node. The advantage of an AMF domain is that two links from a domain to a single higher level domain (closer to the core) will provide redundant AMF links.
AMF concepts Links AMF links are used to connect AMF nodes to AMF nodes in other AMF domains, and are either uplinks or downlinks. Uplinks are used to connect a domain with a higher Core distance (further from the Core) to a domain with a lower Core distance (closer to the Core. Downlinks are used to connect a domain with a lower Core distance to a domain with a higher Core distance. AMF links are used to pass AMF management traffic between nodes, but can also be used to carry other network traffic.
AMF network guidelines Working-sets An AMF working-set is a set of nodes, which is either arbitrarily user defined, or one of the pre-defined working-set groups (see "Working-set groups" on page 38). Specifying or selecting a working-set allows CLI commands to be executed on all nodes within the selected working-set with a single command. A working-set can be defined, selected and configured from any node within an AMF network.
AMF network guidelines Loop-free data plane The current version of AMF does not control the data plane, so it is a requirement that the network is configured such that the data plane is kept loop free. Note: Currently AMF does not support the use of STP on links between AMF nodes. Use of STP with redundant network links has the potential to block AMF control connections, and also could lead to periods of traffic leakage during the start of automatic node recovery.
AMF network guidelines AMF interaction with QoS and ACLs It's important that ACL and QoS rules do not block any traffic on VLAN 4091 and 4092 as they are the default AMF control VLANs. Likewise ACL and QoS rules should not block any Layer 3 traffic on 172.31.0.* or 172.31.128.* as these are the default AMF management traffic subnets. Packets with protocol type 0xfbae and BPDU packets that use the MAC address: 0180.c200.002e should also not be blocked.
Configuring AMF Configuring AMF The following configuration example uses a simplified network to explain the steps required to configure AMF. Simple AMF example with a single master F AM ter 1 s Ma por m Me t1.1 .1 r1 por .1 be por por t1.1 t1.1 por .3 t1.0 .1 por por m Me t1.1 .2 r3 t1.1 r2 por .2 .1 be .2 por t1.1 m Me be por t1.1 t1.1 .3 t1.0 .1 er mb Me 4 Crosslink Link Figure 4: Simple AMF network Configuration AMF Master 1. Set the host name.
Configuring AMF across CFCs. If an AT-x908 VCStack is configured as an AMF master, a licence is required to be installed on both stack members. 4. Configure the data VLANs. AMF_Master(config)#vlan database AMF_Master(config-vlan)#vlan 2-3 5. Disable RSTP globally (this is enabled by default). AMF_Master (config)#no spanning-tree rstp enable 6. Configure ports as AMF-links. AMF_Master(config)#int port1.1.1-1.1.2 AMF_Master(config-if)#switchport atmf-link 7. Configure data VLANs on AMF-links as required.
Configuring AMF 5. Configure ports as AMF-links. Member1(config)#int port1.1.1,port1.1.3 Member1(config-if)#switchport atmf-link 6. Configure data VLANs on the AMF links as required. Member1(config-if)#switchport trunk allowed vlan add 2-3 7. Configure AMF-crosslink. Member1(config)#int port1.1.
Configuring AMF 5. Configure ports as AMF-links. Member2(config)#int port1.1.1,port1.1.3 Member2(config-if)#switchport atmf-link 6. Configure data VLANs on the AMF-links as required. Member2(config-if)#switchport trunk allowed vlan add 2-3 7. Configure AMF-crosslink. Member2(config)#int port1.1.
Configuring AMF 5. Configure ports as AMF-links. Member3(config)#int port1.0.1 Member3(config-if)#switchport atmf-link 6. Configure data VLANs on the AMF links as required. Member3(config-if)#switchport trunk allowed vlan add 2-3 7. Save the configuration and reboot the switch. Member3#copy running-config startup-config Building configuration... [OK] Member3#reload reboot system? (y/n): y Configuration Member 4 1. Set the host name.
Configuring AMF 7. Save the configuration and reboot the switch. Member4#copy running-config startup-config Building configuration...
Using the AMF network Using the AMF network AMF backups AMF backups are an essential part of AMF network operation, as they are the mechanism by which AMF master nodes update their records of the AMF network. By default, AMF master nodes are configured to perform automatic scheduled backups of the entire AMF network once per day at 3.00am. AMF backups are stored on external removable media (e.g.
Using the AMF network Safe removal of external storage media Removing external storage media, or rebooting the master node, while an AMF backup is underway could potentially cause corruption to files in the backup. Although files damaged as a result of mishandling backup media will be replaced during the next backup cycle, if the file system on the media becomes damaged it may require reformatting before being inserted into the AMF master.
Performing a manual backup Performing a manual backup Whenever a new device is added to the AMF network or when the configuration has changed on a member node, it is always advisable to perform a manual backup from the AMF master in order to ensure the removable media installed on the master node has an up to date backup of all nodes within the AMF.
Backups on VCStacks running as AMF masters Backups on VCStacks running as AMF masters When a VCStack or SBx8100 with dual CFCs is running as an AMF master node, it is important to note that an AMF backup will only occur on the external removable media installed in the VCS master (or Active CFC). This means that following a failover event, the new VCS master will not have an AMF backup stored on its external storage media, and will not be able to provide configuration backup and recovery when required.
Backups on VCStacks running as AMF masters Next, create a user defined working-set group containing the nodes in the current workingset using the atmf group command: atmf1[2]#conf t atmf1[2](config)#atmf group AMF_masters Here is an example manual backup activation script called atmfbackup_all_masters.
Node recovery Node recovery Automatic node recovery AMF has been designed so that when a node fails it can be replaced with an unconfigured device of the same type, and AMF will automatically upgrade and configure the new device from the most recent backup. Often the replacement device will be a factory default, brand new “out of the box” device, but it may be that you want to replace the failed unit with one that has been previously used elsewhere.
Node recovery A “Clean” node The recommended procedure for returning a device to a “clean” state is to remove any preexisting boot configuration, including any backup boot configuration, and delete all configuration files from Flash. If the device you are cleaning has previously had VCStack enabled, it is also necessary to delete the stacking configuration file. For example: configure terminal no boot config-file no boot config-file backup exit delete force *.cfg delete force .configs/stk.
Node recovery When these situations occur, automatic node recovery may fail. If automatic node recovery fails, the replacement device will have AMF safe configuration mode applied, (see section "AMF safe configuration" on page 34). If automatic node recovery fails, you may wish to proceed with manual node recovery, which can be initiated by entering the command: atmf recover {} {} Where: node_name is the host name of the device you wish to recover.
Node recovery In the extremely unlikely situation of needing to replace an entire VCStack that is a member of an AMF network, you can use AMF automatic node recovery to first recover stack ID 1, which will become the VCstack master. Note: The replacement device which will become the VCStack master must be a clean unit, (see the section "A “Clean” node" on page 31). The procedure for recovering an entire stack is as follows: 1. Connect a clean device to the AMF network, and power it on.
AMF safe configuration AMF safe configuration If, for any reason, AMF automatic node recovery fails, AMF contains a safety net feature which puts the replacement node into a safe configuration state. This is to prevent an unconfigured device from joining the network and creating loops. How can I tell if my device has had AMF safe configuration applied? A log message will be generated when AMF safe configuration is applied. This message will appear in the log some time after the startup sequence.
AMF safe configuration See below for an example excerpt from the show running-configuration command for a device in AMF safe configuration mode: awplus#show running-config ... ! vlan database vlan 4090 name atmf_node_recovery_safe_vlan vlan 4090 state disable ! interface port1.0.1-1.0.4 shutdown switchport switchport mode trunk switchport trunk allowed vlan add 4090 switchport trunk native vlan none ! interface port1.0.
Adding a preconfigured device to the network In order to retain connectivity to the AMF network, AMF link and crosslink settings should not be changed. In the example above you can see that port1.0.5 is an automatically configured ATMF link. You can see the error message indicating it was skipped by the switchport mode access command, as AMF links must be in trunk mode. Warning: No changes should be made to the device's configuration while a node recovery is underway.
Adding a preconfigured device to the network procedure ensures that there is no possibility of creating loops by having an unconfigured node connected to the network. The example below shows a clean node that has been connected to a port on a neighboring AMF node that configured as an atmf-link.
Using the unified CLI with working-sets Using the unified CLI with working-sets The unified CLI is a central component of AMF. It provides users with a configuration and display interface that can control the entire AMF network from a single point. Control of the nodes within an AMF network is provided through the working-set command. The working-set An AMF working-set is a set of nodes, which is either arbitrarily user defined or one of the pre-defined working-set groups.
Using the unified CLI with working-sets Automatic working-set groups There are three automatic working-set groups that will exist on every AMF network: 1. All—all nodes within the AMF network. 2. Current—the current working-set of nodes. This group is useful for adding additional nodes to the current working-set. 3. Local—the local device In any AMF network there will also be a number of other automatic working-set groups that are dependent on the platform types which exist within the network.
Using the unified CLI with working-sets User-defined working-set groups In addition to the automatic working-set groups, it is also possible to create user-defined groups for arbitrary sets of nodes that the user may wish to group together. For example, all AMF master nodes. To create and use a user-defined working-set group: 1. Create a working-set containing the desired nodes. 2.
Using the unified CLI with working-sets Executing commands on working-sets Once you have selected the desired working-set of nodes on which you wish to execute commands, in general there is no difference to executing commands on a single AlliedWare Plus device. When a command is executed that is valid for all nodes within the working-set, the output is displayed for each of the nodes separately.
Using the unified CLI with working-sets atmf1[4]# show card ======= Master: ======= Slot Card Type State -------------------------------------------------------------------1 AT-SBx81GP24 Online 2 AT-SBx81GP24 Online 3 AT-SBx81XZ4 Online 4 AT-SBx81XS6 Online 5 AT-SBx81CFC400 Online (Active) 6 7 8 9 10 11 12 --------------------------------------------------------------------=============================== x510_1, x908_VCS_1, x908_VCS_2: =============================== % Invalid input detected at '^' marker.
Using the unified CLI with working-sets Interactive commands There is one other command type, known as interactive commands, for which it is not appropriate to execute the commands simultaneously across multiple nodes within a working-set. When any interactive commands are entered from within a working-set they will be executed on the local node only.
Rolling-reboot firmware upgrade Rolling-reboot firmware upgrade The Rolling-reboot firmware upgrade feature allows nodes within an AMF network to be rebooted and upgraded in a rolling sequence in order to minimize downtime and reduce the management overhead.
Rolling-reboot firmware upgrade Here is an example of a Rolling Reboot firmware upgrade summary report: ==================================================================== ATMF Rolling Reboot Complete Node Name Reboot Status Release Name Release Status --------------------------------------------------------------------Node1 Rebooted x510-main-20121018-2.rel Upgraded Node2 Rebooted x900-main-20121018-2.rel Upgraded Node3 Rebooted x610-main-20121018-2.
Rolling-reboot firmware upgrade csg_vcf[5]#atmf Retrieving data Retrieving data Retrieving data Retrieving data Retrieving data reboot-rolling usb:/rel/*.rel from SBSBx8100 from SBx908-VCS2 from x510_1 from x510_2 from SBx908-VCS1 ATMF Rolling Reboot Nodes: Timeout Node Name (Minutes) New Release File Status --------------------------------------------------------------------x510_2 9 x510-main-20121203-1.rel Release ready x510_1 6 x510-main-20121203-1.rel Release ready SBx908-VCS1 9 x900-main-20121203-1.
===================================================================== Copying Release : x510-main-20121203-1.rel to x510_1 Updating Release : x510-main-20121203-1.rel information on x510_1 ===================================================================== ATMF Rolling Reboot: Rebooting x510_1 ==================================================================== 02:14:13 SBSBx8100 ATMF[1973]: x510_1 has left. 4 members in total.
Rolling-reboot firmware upgrade Page 48 | How to Configure and Use AMF on Allied Telesis Switches
AMF Commands AMF Naming Convention...................................................................................................................50 Controlling “show” Command Output..........................................................................................51 Command List ........................................................................................................................................53 atmf backup .....................................................................
AMF Commands AMF Naming Convention When AMF is enabled on a switch, it will automatically be assigned a host name. If a host name has already been assigned, by using the command hostname, this will remain. If however, no host name has been assigned, then the name applied will be the prefix, host_ followed (without a space) by the MAC address of the device. For example, a device whose MAC address is 0016.76b1.7a5e will have the name host_0016_76b1_7a5e assigned to it.
AMF Commands Controlling “show” Command Output You can control the output of show commands by using the | and > or >> tokens in the following ways: ■ To display only part of the output, follow the command with | and then other keywords (see Output Modifiers below) ■ To save the output to a file, follow the command with > filename ■ To append the output to an existing file, follow the command with >> filename Using the ? after typing the show command displays the following information about these toke
AMF Commands Exclude The exclude parameter excludes all lines of output that contain the input string. In the following output all lines containing the word “input” are excluded: awplus# show interface vlan1 | exclude input Interface vlan1 Scope: both Hardware is Ethernet, address is 192.168.14.
AMF Commands Command List This chapter provides an alphabetical reference for AMF commands. atmf backup This command can only be applied to a master node. It manually schedules an AMF backup to start at a specified time and to execute a specified number of times per day. Syntax atmf backup {default| frequency <1-24>} no atmf backup enable Default Parameter Description default Restore the default backup schedule Sets the time of day to apply the first backup, in hours and minutes.
AMF Commands atmf backup enable This command enables automatic AMF backups on the AMF master node. By default, automatic backup starts at 3:00 AM, but this schedule can be changed by the atmf backup command on page 53. Note that backups are initiated and stored on the master nodes. The no variant of this command will disable any amf backups that have been scheduled and previously enabled.
AMF Commands atmf backup now This command is run only from an AMF master and initiates an immediate AMF backup of either all AMF members, or a selected AMF member. Note that this backup information is stored in the external media on the master nodes, even though the selected AMF member may not be a master node.
AMF Commands Example 3 To initiate (from the amf_master_1 node) an immediate backup of all AMF member nodes, use the following command: amf_master_1# amf backup now Example 4 To initiate an immediate backup of the node with the host-name “office_annex” and store the configuration on both masters, use the following process: From the node amf_master_1, set the working-set to comprise only of the automatic group, master nodes.
AMF Commands atmf backup stop Running this command will immediately stop a currently executing AMF backup. Note that this command can only be applied to the master node. Syntax atmf backup stop Parameter Description backup The AMF backup process stop Immediately halts the running process Mode Privileged Exec Mode This command is used to halt an AMF backup that is in progress. In this situation the backup process will finish on its current node and then stop.
AMF Commands atmf domain vlan The AMF domain vlan is one of the internal VLANs that are used to communicate information about the state of the AMF network between nodes. AMF uses its internal VLANS (the management VLAN and the domain VLAN) to communicate its inter nodal network status information. These VLANs must be reserved for AMF and not used for other purposes. When an AMF network is first created all its nodes are assigned the default VID of 4091.
AMF Commands Examples To change the AMF domain VLAN to 4000 use the following commands: VCF-1# configure terminal VCF-1(config)# atmf domain vlan 4000 To reset the AMF domain VLAN to its default of 4091, use the following commands: VCF-1# configure terminal VCF-1(config)# no atmf domain vlan AMF Software Reference Supplement for Allied Telesis x-Series Switches C613-50031-01 REV B AlliedWare PlusTM Operating System - Software Version 5.4.3-1.
AMF Commands atmf enable This command manually enables (turns on) the AMF feature for the switch being configured. The “no” variant of this command disables (turns off ) the AMF feature on the member node. Syntax atmf enable no atmf enable Default Once AMF is configured, the AMF feature starts automatically when the switch starts up. Mode Global Configuration Usage Note that the switch does not auto negotiate AMF domain specific settings such as the Network Name.
AMF Commands atmf group (membership) This command configures your switch to be a member of one or more AMF groups. Groups exist in three forms: Implicit Groups, Automatic Groups, and User-defined Groups. ■ Implicit Groups « all - All nodes in the AMF « current - The current working-set « local - The originating node. Note that the Implicit Groups do not appear in show group output. ■ Automatic Groups - These are defined by hardware architecture. e.g x510, x610, x900, x8100.
AMF Commands The following example configures the switch to be members of three groups; two are company departments, and one comprises all devices located in building_2. To avoid having to run this command separately on each device that is to be added to these groups; you can remotely assign all of these devices to a working-set, then use the capabilities of the working-set to apply the atmf group (membership) command to all members of the working set.
AMF Commands atmf management subnet This command is used to assign a subnet that will be allocated to the AMF management and domain management VLANs. From the address space defined by this command, two subnets are created, a management subnet component and a domain component, as explained in the Usage section of this command description. AMF uses these internal IPv4 subnets when exchanging its internodal status packets.
AMF Commands Examples To change the AMF management subnet address on node VCF-1 to 172.25.0.0: VCF-1# configure terminal VCF-1(config)# atmf management subnet 172.25.0.0 Examples To change the AMF management subnet address on node VCF-1 back to its default of 172.31.0.0: VCF-1# configure terminal VCF-1(config)# no atmf management subnet AMF Software Reference Supplement for Allied Telesis x-Series Switches 64 AlliedWare PlusTM Operating System - Software Version 5.4.3-1.
AMF Commands atmf management vlan The AMF management VLAN is created when the AMF network is first initiated and is assigned its default VID of 4092. This command enables you to change the VID from this default value. The AMF management vlan is one of the internal VLANs that are used to communicate information about the state of the AMF network between nodes. AMF uses its internal VLANS (such as the management VLAN and the domain VLAN) to communicate its inter nodal network status information.
AMF Commands To reset the AMF domain VLAN to its default of 4092, use the following commands: VCF-1# configure terminal VCF-1(config)# no atmf management vlan Related Commands atmf domain vlan show atmf detail AMF Software Reference Supplement for Allied Telesis x-Series Switches 66 AlliedWare PlusTM Operating System - Software Version 5.4.3-1.
AMF Commands atmf master This command configures the switch to be an AMF master node and automatically creates an AMF master group. The master node is considered to be the core of the AMF network, and must be present for the AMF to form. The AMF master has its node depth set to 0. An AMF master node must be present for an AMF network to form. Up to two AMF master nodes may exist in a network, and they “must” be connected by an AMF crosslink.
AMF Commands atmf network-name This command applies an AMF network name to a (prospective) AMF node. In order for an AMF network to be valid, its network-name must be configured on at least two nodes, one of which must be configured as a master and have an AMF License applied. These nodes may be connected using either AMF downlinks or crosslinks. For more information on configuring an AMF master node see the atmf master command on page 67.
AMF Commands atmf reboot-rolling This command enables you to reboot the nodes in an AMF working-set, one at a time, as a rolling sequence in order to minimize downtime. Once a rebooted node has finished running its configuration and has brought its ports up it re-joins the AMF network and the next node is rebooted. By adding the url parameter, you can also upgrade your switches’ software one AMF node at a time.
AMF Commands Several checks are performed to ensure the upgrade will succeed. These include checking the current node release boots from flash. If there is enough space on flash, the software release is copied to flash to a new location on each node as it is processed. The new release name will updated using the "boot system " command, and the old release will become the backup release file.
AMF Commands When the reboot has completed, a number of status screens appear. The selection of these screens will depending on the parameters set.
AMF Commands Example-2 To update firmware releases, use the following command: Node_1# atmf working-set group all ATMF_NETWORK[9]# atmf reboot-rolling card:/5.4.3/x*-5.4.3-*.rel . ATMF Rolling Reboot Nodes: Timeout Node Name (Minutes) New Release File Status -------------------------------------------------------------SW_Team1 8 x510-5.4.3-0.5.rel Release Ready SW_Team2 10 x510-5.4.3-0.5.rel Release Ready SW_Team3 8 --Not Supported HW_Team1 6 --Incompatible Bld2_Floor_1 6 x900-5.4.3-0.5.
AMF Commands atmf recover This command is used to manually initiate the recovery (or replication) of an AMF node, usually when a node is being replaced. The recovery/replication process involves loading the configuration file for a node that is either about to be replaced or has experienced some problem. The configuration file of the device being replaced is selected by the nodename parameter, and the master node holding the config file is specified by the parameter .
AMF Commands atmf remote-login Use this command to remotely login to other AMF nodes in order to run commands as if a local user of that node. Syntax Default atmf remote-login [user ] Parameter Description atmf The Allied Telesis Management Framework feature. remote-login Remote login.
AMF Commands atmf working-set The ATMF working-set command enables you to execute commands across an individually listed set (or preselected group) of AMF nodes. Group selection is made using the atmf group (membership) command on page 61. This command opens a session on multiple network devices. When you change the working set to anything other than the local device, the prompt will change to the AMF network name, followed by the size of the working set, shown in square brackets.
AMF Commands Example-1 To add all nodes in the AMF to the working-set, use the command: node1# atmf working-set group all Note This command adds the implicit group “all” to the working set; where “all” comprises all nodes in the AMF.
AMF Commands clear atmf links statistics This command resets the values of all AMF link, port, and global statistics to zero. Syntax Mode Example clear atmf links statistics Privilege Exec To reset the AMF link statistics values, use the command: node_1# clear atmf links statistics Related Commands show atmf links statistics AMF Software Reference Supplement for Allied Telesis x-Series Switches C613-50031-01 REV B AlliedWare PlusTM Operating System - Software Version 5.4.3-1.
AMF Commands debug atmf This command enables the AMF debugging facilities, and displays information that is relevant (only) to the current node. The detail of the debugging displayed depends on the parameters specified. If no additional parameters are specified, then the command output will display all AMF debugging information, including link events, topology discovery messages and all notable AMF events.
AMF Commands To debug all AMF packets, use the command: node_1# debug atmf packet Related Commands no debug all AMF Software Reference Supplement for Allied Telesis x-Series Switches C613-50031-01 REV B AlliedWare PlusTM Operating System - Software Version 5.4.3-1.
AMF Commands show atmf Displays information about the current AMF node. Syntax Default show atmf [detail|summary|tech|nodes|session] Parameter Description detail Displays detailed information about the current AMF node. summary Displays summary information about the current AMF node. tech Displays global AMF information. nodes Displays information about AMF network nodes. session Displays information on an AMF session. Only summary information is displayed.
AMF Commands Example 2 To show detailed information on AMF node_1 use the following command: node_1 show atmf detail Figure 1-2: Output from the show atmf detail command node_1#show atmf detail ATMF Detail Information Example 3 Network Name Node Name Node Address Node ID Node Depth Domain State Recovery State : : : : : : : ATMF_NET node_1 node_1.atmf 1 0 DomainController None Management VLAN VLAN ID Management Subnet Management IP Address Management Mask : : : : 4092 172.31.0.0 172.31.0.1 255.255.
AMF Commands The show AMF session command displays all CLI (Command Line Interface) sessions for users that are currently logged in and running a CLI session. For example, in the case below, node_1 and node5 have active users logged in.
AMF Commands The AMF tech command collects all the AMF commands, and displays them. You can use this command when you want to see an overview of the AMF network.
AMF Commands Table 1-1: Parameter definitions from the show atmf command (cont’d) Parameter Definition Node ID A Unique identifier assigned to a Node on an AMF network. Node Depth The number of nodes in path from this node to level of the AMF root node. It can be thought of as the vertical depth of the ATMF network from a particular node to the zero level of the ATMF root node. Domain State The state of Node in a Domain in AMF network as Controller/Backup.
AMF Commands show atmf backup This command displays information about AMF backup status. Syntax Mode Examples show atmf backup {logs] Parameter Description backup The backup configuration logs Displays detailed log information User Exec - Privilege level 15 To display the AMF backup information, use the command: node_1# show atmf backup Node_1# show atmf backup ScheduledBackup ......Enabled Schedule............1 per day starting at 03:00 Next Backup Time....19 May 2012 03:00 Backup Media.........
AMF Commands Figure 1-6: Parameter definitions from the show atmf backup command (cont’d) Parameter Definition Current Action The task that the AMF backup mechanism is currently performing. This will be a combination of either (Idle, Starting, Doing, Stopping), or (manual, scheduled). Started The date and time that the currently executing task was initiated in the format DD MMM YYYY. Current Node The name of the node that is currently being backed up.
AMF Commands show atmf group This command can be used to display the group membership within to a particular AMF node. It can also be used with the working-set command to display group membership within a working set. Each node in the AMF is automatically added to the group that is appropriate to its hardware architecture. e.g x510, x610. Nodes that are configured as masters are automatically assigned to the master group. You can create arbitrary groups of AMF members based on your own selection criteria.
AMF Commands A typical output screen from this command is shown below: ATMF group information master, poe, x8100 ========================================= node-1, node-2, node3, node-4, node-5, node-6: ============================================== ATMF group information sysadmin, x8100 ATMF_NETWORK[6]# This confirms that the six nodes (node-1 to node-6) are now members of the working-set and that these nodes reside within the ATMF_Network.
AMF Commands show atmf group members This command will display all group memberships within an AMF working-set. Each node in the AMF working set is automatically added to automatic groups which are defined by hardware architecture. e.g x510, x610. Nodes that are configured as masters are automatically assigned to the master group. User can define arbitrary groupings of AMF members based on their own criteria, which can be used to select groups of nodes.
AMF Commands Figure 1-10: Parameter definitions from the show atmf group command Related Commands Parameter Definition Automatic Groups Lists the Automatic Groups and their nodal composition. The sample output shows AMF nodes based on same Hardware type or belonging to same Master group. User-defined Groups Shows grouping of AMF nodes in user defined groups. Total Members Shows the total number of members in each group. Members Shows the list of AMF Nodes in each group.
AMF Commands show atmf links brief This commands display brief information about all the AMF links configured on the selected node.
AMF Commands Note You can manage your show output, or make it a more selective, by using a command modifier. For information on using show-command modifiers, see “Controlling “show” Command Output” on page 51. Related Commands no debug all clear atmf links statistics clear atmf links statistics show atmf AMF Software Reference Supplement for Allied Telesis x-Series Switches 92 AlliedWare PlusTM Operating System - Software Version 5.4.3-1.
AMF Commands show atmf links detail By default, the following commands display various levels of detail about all the AMF links configured on the device and also display detailed statistics about the AMF packet exchanges between the devices. It is also possible to display the AMF link configuration and packet exchange statistics for a specified interface.
AMF Commands Figure 1-13: Sample output from the show atmf links detail command. (cont’d) Port Ifindex VR ID Port Status Port State Port BPDU Receive Count : : : : : : port2.0.2 6002 0 Down Init 0 : : : : Building_2.4501 - Building_1.4501 3 - 3 0014.2299.137d - eccd.6d03.10e3 Full - Full Link State Entries: Node.
AMF Commands Figure 1-13: Sample output from the show atmf links detail command. (cont’d) Downlink Domain Information: Domain Domain Controller Domain Controller MAC Number of Links Number of Links Up Number of Links on This Node Links are Blocked Node Transaction List Node Transaction ID Domain List Domain Node Ifindex Transaction ID Flags Domain Node Ifindex Transaction ID Flags : : : : : : : Bld2_Floor_1's domain Bld2_Floor_1 eccd.6d3f.
AMF Commands Figure 1-14: Parameter definitions from the show atmf links detail command Parameter Definition Local Port Shows local port on the Node configured for AMF Network. Link Type Shows link type as Uplink/Downlink (Parent and child) or Cross-link (Nodes in same domain). Port Status Shows status of the local port on the Node as UP/DOWN. ATMF State Shows AMF state of the local port: ■ Init - Link is down.
AMF Commands Figure 1-14: Parameter definitions from the show atmf links detail command (cont’d) Parameter Definition Uplink Information Show all uplink entries. ■ Waiting for Sync - Flag if uplinks are currently waiting for synchronization. ■ Transaction ID - Shows transaction id of the local node. ■ Number of Links - Number of up downlinks in the domain. ■ Number of Local Uplinks - Number of uplinks on this node to the parent domain. ■ Originating Node - Node originating the uplink information.
AMF Commands Figure 1-14: Parameter definitions from the show atmf links detail command (cont’d) Parameter Definition Up/Downlink Ports Information Shows all the configured up and down link ports on this node: ■ Port - Name of the local port. ■ Ifindex - Interface index of the local port. ■ VR ID - Virtual router id for the local port. ■ Port Status - Shows status of the local port on the Node as UP/DOWN. ■ Port State - AMF state of the local port. ■ Adjacent Node - Node name of the adjacent node.
AMF Commands show atmf links statistics By default, the following commands display various levels of detail about all the AMF links configured on the device and also display detailed statistics about the AMF packet exchanges between the devices. It is also possible to display the AMF link configuration and packet exchange statistics for a specified interface.
AMF Commands Example -2 To display the AMF links statistics on interface port1.0.5, use the command: node_1# show atmf links statistics interface port1.0.5 Figure 1-16: Sample output from the show atmf links statistics command for interface 1.0.5. ATMF Port Statistics: Receive Transmit port1.0.5 port1.0.5 port1.0.5 port1.0.
AMF Commands Note You can manage your show output, or make it a more selective, by using a command modifier. For information on using show-command modifiers, see “Controlling “show” Command Output” on page 51. Related Commands no debug all clear atmf links statistics clear atmf links statistics show atmf AMF Software Reference Supplement for Allied Telesis x-Series Switches C613-50031-01 REV B AlliedWare PlusTM Operating System - Software Version 5.4.3-1.
AMF Commands show atmf working-set This command displays the nodes that form the current AMF working-set Syntax show atmf working-set Mode User Exec - Privilege level 15 Examples To show current members of the working-set, use the command: ATMF_NETWORK[6]# show atmf working-set Figure 1-18: Sample output from the show atmf working-set command.
AMF Commands show running-config atmf This command displays the running system information that is specific to AMF. Syntax Mode Examples show running-config atmf User Exec and Global Configuration To display the current configuration of AMF, use the following commands: node_1# show running-config atmf Note You can manage your show output, or make it a more selective, by using a command modifier. For information on using show-command modifiers, see “Controlling “show” Command Output” on page 51.
AMF Commands switchport atmf-crosslink This command configures the selected port or aggregated link to be an AMF crosslink. Running this command will automatically place the port or aggregator into trunk mode (i.e. switchport mode trunk). The connection between two AMF masters must utilize a crosslink. Crosslinks are used to carry the AMF control information between master nodes. Multiple crosslinks can be configured between two master nodes, but only one crosslink can be active at any particular time.
AMF Commands Example-2 Example-2A This example is shown twice. Example 2A is the most basic command sequence. Example 2B is a good practice equivalent that avoids problems such as broadcast storms that can otherwise occur.
AMF Commands switchport atmf-link This command enables you to configure a port or aggregator to be an AMF uplink/ downlink. Running this command will automatically place the port or aggregator into trunk mode. The “no” variant of this command removes any AMF-link that may exist for the selected port or aggregated link. Syntax switchport atmf-link no switchport atmf-link Mode Example Parameter Description switchport The Layer 2 Interface atmf-link Sets the switchport to be an AMF link.
AMF Commands type atmf node This command configures a trigger to be activated at an AMF node join or leave event. Syntax Mode Example-1 type atmf node {join|leave} Parameter Description type Configure a particular type of trigger atmf Manage AMF feature join AMF node join event leave AMF node leave event User Exec - Privilege level 15 To configure trigger 5 to activate at an AMF node leave event, use the following commands.
AMF Commands Enter the name of the script to run at the trigger event. AMF-Net[3](config-trigger)# script 1 email_me.
AMF Commands undebug atmf This command is an alias for the no variant of the debug atmf command on page 78. AMF Software Reference Supplement for Allied Telesis x-Series Switches C613-50031-01 REV B AlliedWare PlusTM Operating System - Software Version 5.4.3-1.
AMF Commands AMF Software Reference Supplement for Allied Telesis x-Series Switches 110 AlliedWare PlusTM Operating System - Software Version 5.4.3-1.
