Using AlliedWare Plus TM How To | Get Started With The AlliedWare PlusTM Operating System Introduction This How To Note introduces a number of commonly-used management features of the AlliedWare PlusTM operating system (OS), the next generation operating system for Allied Telesis, Inc’s high performance layer 3 managed switches. Contents Introduction ............................................................................................................................. Contents ....................
Introduction How to set system parameters ............................................................................................... How to change the telnet session timeout ....................................................................... How to name the switch ................................................................................................. How to display a text banner at login .............................................................................
Important differences between the AlliedWare OS and the AlliedWare Plus OS Important differences between the AlliedWare OS and the AlliedWare Plus OS The most noticeable differences between the AlliedWare Plus OS and the AlliedWare OS are: The command mode hierarchy. With the AlliedWare Plus OS, you go into an appropriate mode before entering configuration or monitoring commands. For details of the modes, see "How to work with command modes" on page 9. The style of the commands.
How to log in How to log in 1. Set the console baud rate Set the baud rate of your terminal emulator to 115200. For bootloader version 1.0.8 and earlier, this is the switch’s default value. You can use a bootloader menu option to change it, but the first time you access the switch, you must use 115200. Note that in bootloader version 1.0.9, the default baud rate will change to 9600. 2.
How to get command help How to get command help The following kinds of command help are available: lists of valid parameters with brief descriptions (the ? key) completion of keywords (the Tab key) error messages for incomplete or incorrect syntax View a list of valid parameters To get syntax help, type ? after: Example the prompt, to list all commands available in the mode you are in one or more parameters, to list parameters that can come next in the partial command one or more
How to get command help Example To see which show commands that start with “i” are available in User Exec mode, enter “?” after show i: awplus>show i? This results in the following output: interface ip ipv6 Example Interface information Internet Protocol (IP) Internet Protocol version 6 (IPv6) To use the ? help to work out the syntax for the clock timezone command (page 26), enter the following sequence of commands: awplus(config)#clock ? summer-time Manage summer-time timezone Set clock timezone awpl
How to get command help Complete keywords To complete keywords, type Tab after part of the command. If only one keyword matches the partial command, the AlliedWare Plus OS fills in that keyword. If multiple keywords match, it lists them. Example To use Tab completion to enter the command show ip dhcp server summary, enter the following commands. We have included “” to show where to type the Tab key—it is not displayed on screen.
How to get command help View command messages The switch displays the following generic error messages about command input: % Incomplete command—this message indicates that the command requires more parameters. Use the ? help to find out what other parameters are available. awplus(config)#interface interface % Incomplete command. % Invalid input detected at '^' marker—this indicates that the switch could not process the command you entered.
How to work with command modes How to work with command modes The following figure shows the command mode hierarchy and the commands to use to move to lower-level modes. AlliedWare Plus CLI modes User Exec mode Command mode enable Command used to enter the next command mode Privileged Exec mode configure terminal Global Configuration mode interface [interface name] router [routing protocol ] Interface mode Router mode Other sub-modes cli-modes.
How to work with command modes Privileged Exec mode To change from User Exec to Privileged Exec mode, enter the command: awplus>enable Tip: en is a short-cut for enable Privileged Exec mode is the main mode for monitoring—for example, running show commands and debugging. From Privileged Exec mode, you can do all the commands from User Exec mode plus many system commands. For a list of commands available in this mode, see "Privileged Exec mode" on page 40.
How to work with command modes Lower-level configuration modes A number of features are configured by entering a lower-level mode from Global Configuration mode. The following table lists these features. Mode What it configures Command Default prompt Interface Switch ports, VLANs, the management Eth port. interface name awplus(config-if)# Class map QoS classes, which isolate and name specific traffic flows (classes) from all other traffic.
How to work with command modes Returning to higher-level modes The following figure shows the commands to use to move from a lower-level mode to a higher-level mode. AlliedWare Plus CLI modes - returning to higher-level modes User Exec mode Command mode disable Command used to return to this command mode Privileged Exec mode exit end or Ctrl+Z or Ctrl+C Global Configuration mode exit exit exit Interface mode Router mode Other sub-modes cli-modes-return.
How to work with command modes Entering Privileged Exec commands when in a configuration mode When you are configuring the switch, you are likely to want to enter show commands to confirm the configuration. This can mean you change often between configuration modes and Privileged Exec mode. However, you can run Privileged Exec commands without changing mode, by using the command: do However, you cannot use the ? help to find out command syntax when using the do command.
How to see the current configuration How to see the current configuration The current configuration is called the running-config. To see it, enter the following command in either Privileged Exec mode or any configuration mode: awplus#show running-config Tip: show running-config works in all modes except User Exec mode. To see only part of the current configuration, enter the command: awplus#show running-config |include This displays only the lines that contain word.
Default settings Default settings When the switch first starts up with the AlliedWare Plus OS, it applies default settings and copies these defaults dynamically into its running-config.
Default settings The default settings Most of the above default settings are in the form of commands, which the switch copies to its running-config when it first boots up. The switch stores a copy of the default configuration commands in the running and startup configs and uses that file as its default start-up file. For more information about start-up files, see "How to save and boot from the current configuration" on page 18. The following figure shows the contents of the default file.
How to change the password How to change the password To change the password for the manager account, enter Global Configuration mode and enter the following command: awplus(config)#username manager password The password can contain any printable character and is case sensitive. How to set a management IP address This section describes how to set an IP address on the eth0 management port. 1.
How to save and boot from the current configuration How to save and boot from the current configuration This section tells you how to save your configuration and run the saved configuration when the switch starts up. You can either: save the configuration to the switch’s default configuration file (called “default.cfg”). By default, the switch uses that file at start-up. create a new configuration file and set the switch to use the new configuration file at start-up.
How to save and boot from the current configuration 3. Display the new settings To see the files that the switch uses at startup, enter Privileged Exec mode and enter the command: awplus#show boot The output looks like this: Boot configuration -------------------------------------------------------------------Current software : r1-5.2.1.rel Current boot image : flash:/r1-5.2.1.rel Backup boot image : Not set Default boot config: flash:/.configs/default.cfg Current boot config: flash:/example.
How to save and boot from the current configuration How to return to the factory defaults The switch dynamically adds the default settings to the running-config at start-up if the default file is not present. This section describes how to use this feature to return to the factory defaults.
How to see system information How to see system information This section describes how to view the following system information: overview information details of temperature and voltage serial number Viewing overall system information To display an overview of the switch hardware, software, and system settings, enter User Exec or Privileged Exec mode and enter the command: awplus#show system The output looks like this: Switch System Status Tue Jun 12 16:41:17 2007 Board ID Bay Board Name Re
How to see system information Viewing temperature, voltage, and fan status The switch monitors the environmental status of the switch and its power supplies and fan. To display this information, enter User Exec or Privileged Exec mode and enter the command: awplus#show system environment The output looks like the following figure. This device has a power supply unit in the first PSU bay and a fan in the second PSU bay.
How to set system parameters How to set system parameters You can set system parameters to personalise the switch and make it easy to identify it when troubleshooting. This section describes how to configure the following system parameters: telnet session timeout switch name login banner How to change the telnet session timeout By default, telnet sessions time out after 10 minutes of idle time. If desired, you can change this.
How to set system parameters However, the name must be a single word, as the following example shows. awplus(config)#hostname switch1.mycompany.com more words hostname switch1.mycompany.com more words ^ % Invalid input detected at '^' marker. It also cannot be surrounded by quote marks, as the following example shows. awplus(config)#hostname "switch1.mycompany.com more words" % Please specify string starting with alphabet Removing the name To remove the hostname, enter the command: switch1.mycompany.
How to set the time and date How to set the time and date There are three aspects to setting the time and date: setting the current time and date ("How to set the time and date" on page 25) setting the timezone ("How to set the timezone" on page 26) configuring the switch to automatically change the time when summer-time begins and ends ("How to configure summer-time" on page 26) Instead of manually setting the time, you can use NTP to automatically get the time from another device.
How to set the time and date How to set the timezone To set the timezone, enter Global Configuration mode and enter the command: awplus(config)#clock timezone {plus|minus} 0-12 The timezone-name can be any string up to 6 characters long.
How to set the time and date Date-based To set summer-time for a single year, enter Global Configuration mode and enter the command: awplus(config)#clock summer-time date The zone-name can be any string up to 6 characters long. The start-time and end-time are in the form hh:mm, in 24-hour time.
How to add and remove users How to add and remove users Adding users To add a new user with administrative rights, enter Global Configuration mode and enter the command: awplus(config)#username privilege 15 password Both name and password can contain any printable character and are case sensitive. The AlliedWare Plus OS gives you a choice of 1 or 15 for the privilege level. Level 1 users are limited to User Exec mode so you need to set most users to level 15.
How to add and remove users Pre-encrypted passwords The running-config output above includes the number 8 after the password parameter. This indicates that the password is displayed in its encrypted form. You can enter the number 8 and a pre-encrypted password on the command line. You may want to pre-encrypt passwords if you need to load them onto switches via an insecure method (such as HTTP, or by emailing them to remote users).
How to undo settings How to undo settings There are two possibilities for undoing settings: the no parameter and the default parameter. How to use the no parameter To undo most settings, simply re-enter the first parameters of the configuration command with the parameter no before them.
How to work with files How to work with files The AlliedWare Plus OS lets you create directory trees for file storage.
How to work with files Seeing information about the file system To display information about the different memory types on the switch, enter Privileged Exec mode and enter the command: awplus#show file systems The output includes the amount of free memory and the prefix you type to access that memory type, and looks like this: Size(b) Free(b) Type Flags Prefixes S/D/V Lcl/Ntwk Avail ------------------------------------------------------------------31.0M 6.
How to work with files How to display the contents of configuration and text files To display the contents of a file, enter Privileged Exec mode and enter the command: awplus#show file Example To display the contents of the file called “example.cfg”, enter the command: awplus#show file example.
How to work with files Note that the prefix for the SD card is “card” not “sdcard”.
How to work with files How to copy files Copying within a file system Within a directory To copy a file within the same directory, enter Privileged Exec mode and enter the command: awplus#copy If the file already exists, the switch asks whether to overwrite it, with a message like this: Overwrite flash:/example.cfg? (y/n)[n]: To overwrite, press the “y” key then the Enter key.
How to work with files Copying to and from NVS or SD card To copy between file systems, you need to specify the file system prefix (nvs: or card:). For example, to copy from Flash to NVS when your current directory is the top-level Flash directory, enter Privileged Exec mode and enter the command: awplus#copy nvs: The switch prompts you for the filename, as described in the previous section.
How to work with files How to use the editor The inbuilt editor is JOE (Joe’s Own Editor). To edit an existing file, enter Privileged Exec mode and enter the command: edit To open the editor with a empty file, enter the command: edit When you save the new file, you may need to specify the file system to store it on. For Flash, use flash:. Using JOE To format and manipulate text in JOE, you use control-character sequences.
How to upgrade the firmware How to upgrade the firmware New releases of the AlliedWare Plus OS become available regularly. Contact your customer support representative for more information. 1. Put the new release onto your TFTP server 2. If necessary, create space in the switch’s Flash memory for the new release Note that you cannot delete the current release file. 3. Copy the new release from your TFTP server onto the switch Follow the instructions in "Copying to and from a TFTP server" on page 36. 4.
Appendix: Commands available in each mode Appendix: Commands available in each mode This appendix lists the commands available in the following command modes for software version 5.2.
Appendix: Commands available in each mode Privileged Exec mode awplus#? Exec commands: activate cd clear clock configure copy debug delete dir disable dot1x echo edit enable erase exit help license logout mail mkdir move mstat mtrace no ping platform pwd quit reboot reload remote-command restart rmdir show ssh stack telnet terminal test traceroute trigger undebug write 40 Activate a script Change the current working directory Reset functions Manage clock Enter configuration mode Copy from one file to an
Appendix: Commands available in each mode Global Configuration mode awplus(config)#? Configure commands: access-list arp auth-mac banner bgp boot class-map clock crypto debug default do dot1x enable epsr exception exit fib gvrp help hostname interface ip ipv6 key lacp line log mac mail max-fib-routes max-static-routes maximum-access-list maximum-paths mls no ntp ospf pam ping-poll platform policy-map radius-server rip rmon route-map router router-id --More-- 41 Add an access list entry Address Resolutio
service show snmp-server spanning-tree ssh stack system telnet trigger username virtual-server vlan vrrp Modify use of network based services Show running system information Manage snmp server Spanning tree commands Secure Shell Virtual Chassis Stacking (VCS) System properties Configure telnet Select a trigger to configure Establish User Name Authentication Virtual-server configuration Configure VLAN parameters Start VRRP configuration C613-16105-00 REV D North America Headquarters | 19800 North Creek Pa
