Merlin – v3.6.

1 - Quick Reference Guide

Description To Run Diagnostics: c. Batch mode allows you to pull diagnostics for an
assortment of IP addresses and unit types.
i. Select the “Create” button and hit Save on
Merlin is an executable program developed by DragonWave, for use on DragonWave products. It 1. In the Diagnostics Information tab, select the
the pop-up to generate the ipaddress.txt
offers a variety of functions, including Diagnostic Information, Equipment Discovery and Resetting items required. The image to the right shows the
ii. A txt file will open with default IPs, super user credentials and
and Defaulting your DragonWave device. A quick summary on how to use these functions can be 3 most commonly selected options, Diagnostic
connection methods. Ensure to remove the # from the start of the
found in this Quick Reference Guide. For assistance with the rest of Merlin’s functions, please use the Information, Event log and Performance log. If no
lines you are using, and enter the IPs, super user and passwords
Merlin Help File, found in Merlin, or contact Customer Support at support@dragonwaveinc.com or item is selected before pressing the ‘Start
necessary for all units you want to connect to. Save the txt file.
1 613 271 7010. Information Retrieval’ button all possible options
The example below shows a modified ipaddress.txt file, that will
will flash and a pop-up will be displayed.
connect to an HC+ at 172.16.33.81 with default super user
Downloading and Launching Merlin – v3.6.1 credentails. The 1st and 3rd units displayed in the example below
will not be connected to, as they have a “#” at the start of the
line.
Downloading
2. If an FTP server is required, please select
To download the latest version of Merlin, go to the ‘Use FTP Server’ option before you hit
http://support.dragonwaveinc.com/diagnostics/ ‘Start Information Retrieval’. You can
select either the Internal or External
options. Note: “Use FTP Server” is not iii. Ensure that the “IP Address Text File” field contains the location
Depending on the function you are using in Merlin, you may need to also ensure you have WinPcap
needed to pull the Diagnostic Information, of your saved txt file.
installed on your Windows machine. You can find the latest version of WinPcap at
Event logs or Performance logs, and can
https://www.winpcap.org/install/
be left unchecked for these 3 files. (See ‘FTP Server Section’ in the “Merlin Help File”
for more information).
Launching Merlin
Once Merlin has been downloaded, you will need to rename the file so that it ends with ‘.exe’ so that 3. Select the Connection Mode
Windows recognizes the file as an executable. You can do this by right clicking on the download in a. For Horizon; Compact, Compact+, Quantum, Duo, Airpair 5. All files created (except if using an External FTP Server) will be placed in the location
the directory where it is saved, and selecting “Rename”. Please ensure that your file extensions are and Harmony; Enhanced, Enhanced MC and Eband  indicated by the ‘Output Directory’ field.
not hidden. Use Telnet or SSH as the Connection Mode a. Note that the default location is a directory called ‘logdata’ below the
b. For Horizon Quantum, Duo and Airpair  You can also use directory from which Merlin was executed.
the Serial Connection Mode if you are connected to the unit b. If this directory does not exist a popup will be displayed asking if the
through the CNTL port directory should be created or a new one selected.
c. For Harmony Lite and Harmony Radio use SNMP as the
Connection Mode

4. Select the Collection Method (Single, Range, Batch).

a. Single mode allows you to pull diagnostics from just one IP (one unit) at a
You will need to ensure you run Merlin as an administrator. Doing this will allow you to access the time. This is the most commonly used Collection Mode. When using Single
Merlin Help File, which is available for in-depth help using all functions offered in Merlin – v3.6.1. Mode:
i. Enter the IP Address for the unit.
ii. Ensure you selected the protocol to use to connect to the unit.
[Telnet/SSH/SNMP/Serial] 6. To start the process, select the ‘Start
iii. If using Information Retrieval’ button in the upper
1. Telnet or SSH: Enter the authentication required left hand corner. Once the process starts
(Username/Password). successfully the button becomes disabled,
2. SNMP: Enter the SNMP Community String and SNMP greyed out and changes its name to
Version. ‘Retrieval Process Running.’
3. Serial: Enter the Com Port and Baud rate to use. a. The button will no longer be
Running Merlin Diagnostics Utilities greyed out once the Retrieval
Process finishes, and the name
Merlin Diagnostics creates 3 files that can be used to on the button will revert back to
determine the equipment configuration and status; the ‘Start Information Retrieval’.
Diagnostics, Event log and Performance log. Merlin will
also generate a 4th file, the Unit log. The Unit log is not used in troubleshooting the RF link, and does For additional Merlin Diagnostic features, reference the
not typically need to be sent in to Customer Support. The Unit log is used to assist Customer Support “Merlin Help File” located under the “Help” pull down menu.
if there is an issue with using Merlin. b. Range mode will pull diagnostics for every IP in between (and including)
the start and end IPs. Note: The units within the range need to have the
These 3 files can be produced by running Merlin Diagnostics when connected to the equipment. The same Username and Password. When using Range mode:
files are stored in a folder of your choosing. i. Enter the start and end IPs in the From and To fields
ii. Ensure you selected the protocol to use to connect to the unit.
Each time Merlin Diagnostics is run, it creates unique time stamped files. You may need to run Merlin Range mode does not support Serial connection.
as an Administrator depending on your Windows machine. iii. If using
1. Telnet or SSH: Enter the authentication required
(Username/Password)
2. SNMP: Enter the SNMP Community String and SNMP
Version.

Customer Support International Help Desk: +1 613 271 7010 email: support@dragonwaveinc.com web: http://support.dragonwaveinc.com DragonWave Inc. http://www.dragonwaveinc.com QRG-000009-01-EN Merlin – v3.6.1
 Merlin – v3.6.1 - Quick Reference Guide
Merlin Discovery
If you are having problems discovering the unit:
3. Select ‘Submit Files to Support’ button and save
Note: Before using Merlin Discovery tool, ensure WinPcap is installed on your machine • Some equipment may require the configured management port to be the port connected to the file  Please send this file to DragonWave
(https://www.winpcap.org/install/). the PC  Try connecting to all ports, or try discovering during the boot up process Customer Support (contact info at the bottom of
• Certain versions of equipment software require Port 1 be connected to the PC (especially this page). Note: The ‘Submit File to Support’
true for Next Gen Harmony radios that are VLAN tagged)  Connect to Port 1, power cycle button will not appear unless a MAC Address is
There are two discovery options, a regular Discovery, and a Detailed Discovery. Discovering the unit the unit and start the discovery process after about 10 seconds. Timing is important, so if you populated (see Step 1).
will show the MAC Address, Serial Number, IP, Subnet, Gateway, etc. A Detailed Discovery will also are having trouble, watch your NIC while connected to the unit. It should connect, disconnect, 4. A window will pop up, asking you to save the file generated. The file
provide the management port, VLAN tagging on/off, any VLANs, firmware, etc. You will need to discover and then connect again. When it connects this 2nd time, start the Discovery or Detailed contains the information Customer Support needs to in order to provide
the unit first, before performing a Detailed Discovery. Discovery. a reset file. Save the file to your desired location, and then send it in to
• Verify WinPcap is installed. support@dragonwaveinc.com. If it is an emergency, please call our 24
hour support line at 1 613 271 7010.
• Certain firewalls may block the return packet from the DragonWave equipment. If possible,
To Discover a Unit: try disabling the firewall on your PC temporarily to see if this is the issue.
1. Select “Equipment Discovery” from the Merlin Home page. 5. DragonWave Customer Support will send back a ‘Key
2. Select the interface to use in the Reset Utility File’.
Interface drop-down field. If the list is a. Ensure the correct Reset Option is selected, otherwise
Merlin will complain the Key File is invalid.
empty, ensure WinPcap is installed. Reset Utility functions
To Reset a unit, you must discover it first (see previous section for Merlin Discovery). Once
discovered, you can move on to the Reset Utility tab. The Reset utility allows various reset functions
of the unit, including: b. Select the required interface for your computer from the ‘Discover Tab’ prior to
• Factory Default the unit (next Gen loading the Key File.
3. Select the ‘Discover Units – Start’ button. Harmony Units v3.1 and higher). c. Load the Key File with the ‘Load File’ button. Once the file has
(Button will grey out until discovery is done). • Default only the Management Interface been loaded, the Reset Key field will
(next Gen Harmony Units v3.1 and populate.
4. Once the process has completed, any units responding will have their information populated higher).
in the device grid. • Default the Management VLAN (next Gen Harmony Units v3.1 and higher). 6. Select the ‘Start Reset Process’ button.
• Reset the Web Services (next Gen Harmony Units). a. Note: Button will grey out and become disabled until you
• Reset the IP configuration and Super User account credentials (HC+, Harmony Enhanced, select OK on the second pop up (below).
Harmony Enhanced MC).
• Basic MGMT default (next Gen Harmony Units).
• Factory Default (Horizon Compact).
The ‘V2’ option allows for new process in Next Gen Radios of the following versions or higher. Note:
The V2 option is only available in Merlin – v3.6.2.
• Enhanced OMNI 3.1.1
• Enhanced MC OMNI 1.1.0
• Eband OMNI 1.1.0

How to use the Reset utility

5. For detailed discovery (ie discovery of VLANs, management port, etc), Right Click any row Note: The use of this section requires a ‘Key File’ be obtained from DragonWave Customer Support.
highlighted in Yellow and select the ‘Detailed Discovery’ menu option. The exception to this is the ‘Reset Web Services’ option.

1. Discover the unit using the instructions given in the ‘Merlin Discovery’ section above  7. PLEASE NOTE the pop-up messages. They are different for each option selected.
Ensure you select the unit from the ‘Discovery Grid’ so that the units MAC Address, Serial a. Factory Default – Requires Unit to be finished booting. (Do not attempt during a
Number and Reset Count are populated in the ‘Reset Utility’ fields. power cycle event).
b. Management Interface Default – Requires Unit to be finished booting. (Do not
attempt during a power cycle event).
c. Management VLAN Default – Requires unit to be finished booting. (Do not
attempt during a power cycle event).
d. Special Options
i. Harmony (Eband, Enhanced, EMC) – IPL Force Load (power cycle
unit. After 10 seconds select ‘OK’ from the PopUp message).
ii. Harmony (Eband, Enhanced, EMC) units only – MGMT Default (power
cycle unit. After 10 seconds select ‘OK’ from the PopUp message).
iii. Harmony (Eband, Enhanced, EMC) units only – Reset Web Services
(See Step 7)
iv. Eband, Enhanced, EMC, HC+ only – Reset SU Account and IP CFG
(Do not attempt during a power cycle event)
v. Horizon Compact Only – Factory Default (power cycle unit. After 10
seconds, select ‘OK’ from the PopUp message).
8. Reset Web Services (do not attempt during a power cycle event)
a. Enter the connection and authentication information for the device.
2. Select the process required (ie b. Select the ‘Start Process’ button and wait until the process finishes.
Factory Default, Management
Interface Default, Special
Options etc).

Customer Support International Help Desk: +1 613 271 7010 email: support@dragonwaveinc.com web: http://support.dragonwaveinc.com DragonWave Inc. http://www.dragonwaveinc.com QRG-000009-01-EN Merlin – v3.6.1