Professional Documents
Culture Documents
Harmony Enhanced, 1 Plus 1 Configuration Method of Procedure - TN-000045-01-En-01-01
Harmony Enhanced, 1 Plus 1 Configuration Method of Procedure - TN-000045-01-En-01-01
Revision 1.1
Document Number: TN-000045-01-EN
Date: 12/05/2017
Supersedes: None
Issuer: DragonWave-X Customer Support
Harmony Enhanced 1+1 HSB Configuration MOP
NOTICE
This document contains DragonWave-X proprietary information. Use, disclosure, copying or distribution of any
part of the information contained herein, beyond that for which it was originally furnished, requires the written
permission of DragonWave-X.
The information in this document is subject to change without notice and relates only to the product defined in
the introduction of this document. DragonWave-X intends that information contained herein is, to the best of its
knowledge, correct and accurate. However, any/all liabilities associated with the use or accuracy of the
information contained herein must be defined in a separate agreement between DragonWave-X and the
customer/user.
DragonWave®, Horizon® and Avenue® are registered trademarks of DragonWave-X. ©2017 DragonWave-X.
All rights reserved
TABLE OF CONTENTS
1 HISTORY........................................................................................................... 4
2 PRE-INSTALLATION CONFIGURATION......................................................... 5
2.1 Software Confirmation ........................................................................................................................... 5
2.2 Licenses ................................................................................................................................................. 6
1 History
2 Pre-Installation Configuration
With the exception of software/license key upgrades and system type and system identifier configurations, all other
configuration changes are dynamic, and take event immediately.
Note: A “save” is still required after dynamic configuration changes to ensure that settings are maintained after a
system reset.
Verify that the TCF file is 2.12.00 or later. Verify that the TCF file is 2.12.00 or later.
2.2 Licenses
Licenses: Ensure required license for 1+1 feature support is installed.
Note – One license is required for 1+1: Diversity Support (includes HSB, SD, and FD).
Web GUI Commands CLI Equivalent Commands
1. Log into the Web GUI of all four radios, navigate to the “Configuration -> enhanced# show license features
System -> Licensing” menu. CLI will return the following:
2. Confirm that the “Diversity Support” feature is check marked (licensed). enhanced# show license feature
5. A system reset is required after the license keys are initially installed to
make the features active.
Note: The “System Type” and the “System Identifier” (next step) settings both require a reset system to
become active. It is recommended that these both be configured, followed by a single “reset system”,
to avoid unnecessary reboots.
Example:
enhanced# configure
(config)# system type 6
(config)# end
3. Click the “Submit” button (which will turn grey when the changes have been
applied) then proceed to the next step to set the “System Identifier”.
Note: The system type “1+1 1CR HSB” should turn red to indicate that it has been configured
but will not be applied until the system is reset.
Note: The “System Type” (previous step) and the “System Identifier” settings both require a reset system to
become active. It is recommended that these both be configured, followed by a single “save” and
“reset system”, to avoid unnecessary reboots.
enhanced# config
(config)# redundancy system identifier [primary | secondary]
(config)# end
Note: The system uses different criteria to independently determine which radio will be the active “wireless”
radio and which will be the active “ethernet” radio, so these two functions will often be separated
between the two radios depending on current and historical fault conditions.
Options include:
• Auto (recommended): Node can switch between active and standby state based on partner fault
conditions
• Force-active: The node always processes the user data (ethernet payload) and will NOT change for
any reason.
• Force-standby: The node does NOT process user data (ethernet ports will be in standby mode) and
will not change for any reason.
Switch Mode Configuration: Determine how the “active” ethernet port is controlled
Web GUI Configuration CLI Equivalent Commands
1. Once the radios have been reset following the previous
two configuration steps (System Type and System
Identifier), log back into the units and navigate to the
“Configuration -> System -> Redundancy” tab. enhanced# config
(config)# redundancy switch mode [auto | force-active | force-standby]
2. Under Switch Mode, select “Auto”.
(config)# end
Example:
enhanced# configure
(config)# redundancy switch mode auto
(config)# end
Depending on the connected 3rd party device, it may be preferable that only the member port(s) of the
active unit be on at any given time (standby interface mode “off”) thus aiding the connected switch in
determining traffic direction and reducing the need for advanced switch port configuration.
Options include:
• On: the payload Ethernet Link will remain "on" when the node transitions from active to standby
state.
• Off: the payload Ethernet Link will turn "off" when the node transitions from active to standby
state, and will remain "off" in the standby state.
• Pulse: the payload Ethernet link will be momentarily shutdown (turned off for ~6 seconds) when
the node changes its state from active to standby. After 6 seconds the node will re-establish the
connection on its Payload port while it has changed its state to standby.
Switch Mode Configuration: Determine the port status of the “standby” ethernet interface.
Web GUI Configuration CLI Equivalent Commands
1. Navigate to the “Configuration -> System -> Redundancy” tab.
2. Under Standby Interface Mode, select “On”, “Off” or “Pulse” as enhanced# config
desired. (config)# redundancy standby interface mode [on | off | pulse]
(config)# end
enhanced# configure
(config)# redundancy standby interface mode on
(config)# end
enhanced# configure
(config)# redundancy standby interface mode off
(config)# end
Note: All units should be configured the same. Read the mode enhanced# configure
descriptions above to determine which choice is the optimal (config)# redundancy standby interface mode pulse
choice for your network architecture. (config)# end
When this feature is enabled, the system will always use the “Main” radio to form the radio link, provided
there is no radio fault, the “Protection” radio will remain in standby mode unless a radio fault is detected on
the “main” radio.
When disabled, the “radio link priority” setting is ignored and the system will use either of the available
radios to form the link.
Note: In 2+0 and XPIC configurations, Revertive Radio Switching and Radio Link Priority settings are NOT used
and will be ignored. In a 1+1 HSB 2-wire configuration, either radio can handle the payload data. This is
determined independently of the radio link, and is NOT controlled by the Revertive radio switching.
(config)# end
3. Under Radio Link Priority:
• Select “main” if the System Identifier is “primary”
• Select “protection” if the System Identifier is
“secondary”.
Example:
enhanced# configure
(config)# redundancy revertive radio switching enable
(config)# redundancy radio link priority main
(config)# end
When multiple ports are selected (required for >1Gbps), a protection switch will only occur if a failure
condition is detected on ALL ports in the group.
• This will result in the ethernet data processing switching to the partner radio.
• The radio processing the wireless traffic (RF link) are not affected unless a failure condition is also
detected on a wireless link.
• OOB management ports should not be selected as a member of the interface group since OOB
management ports cannot pass payload traffic over the radio link.
enhanced# config
(config)# redundancy interface group gi0/1
(config)# end
enhanced# config
(config)# redundancy interface group gi0/1 gi0/2
(config)# end
4 Basic RF Configuration
Minimum RF configuration requirements - prior to alignment
Example:
enhanced# configure
2. Once the radio profile has been submitted, enter both transmit & receive
frequencies (as per link design documentation). Click “submit” to apply
changes. The “Radio Frequency” section is located directly below the Ensure that for 1+1 configurations, the Tx
“Radio Profile” configuration section. Ensure that the Tx Frequencies and Frequencies and Rx Frequencies are the same on
Rx Frequencies are exactly the same on both the Primary and Secondary the Primary and Secondary Links.
Links. See example below:
Example:
Primary Link (TxLow)
(config)# radio frequency 21500000 22750000
Primary Link (TxHigh)
(config)# radio frequency 22750000 21500000
Secondary Link Configuration: (TxLow)
Secondary Link (TxLow)
(config)# radio frequency 21500000 22750000
Secondary Link (TxHigh)
(config)# radio frequency 22750000 21500000
3. Navigate to the “Transmitter Settings” page, enable the transmitter and (config)# radio transmit state enable
(config)# radio transmit power [dB]
enter the transmit power (as per link design documentation). Click
“submit” to apply changes.
Example:
enhanced# configure
(config)# radio transmit state enable
(config)# radio transmit power 1.0
4. Once the transmitter has been enabled, save the configuration by selecting
the “Save” button in the upper left hand corner of the Web GUI. Click
“yes” in the subsequent pop-up window. The save will take approx. 10
seconds to complete. All RF configuration changes are dynamic so no reset
is required.
(config)# end
enhanced# save running-config
Example:
enhanced# config
IMPORTANT: Any port assigned as an out-of-band management port will not pass traffic.
Management IP Assignment: Defining the Management IP, Subnet Mask & Gateway
Web GUI Configuration CLI Equivalent Commands
NOTE: The Harmony Enhanced will arrive with the following
Factory default management settings:
IP address: 192.168.10.100
Netmask: 255.255.0.0
Gateway: 192.168.10.1
Example:
enhanced# configure
(config)# management ip 192.168.10.200 netmask 255.255.0.0 gateway
192.168.10.1
NOTE: Once the basic configuration has been completed, proceed with the link
alignment procedure and link verification as outlined in the “Installation
MOP”.
5 Post-Alignment Configuration
5.1 Reserved Management VLAN ID
The Enhanced ODU has a default reserved Management VLAN used to communicate between the two ODUs on
a link to support the WEB GUI Link View display, ACM, ATPC, and Redundancy communications. The default
Reserved Management VLAN ID is 4091.
If the default Reserved Management VLAN ID (eg. 4091) corresponds to the same VLAN ID required for use
by the end customer or service provider to transfer customer payload traffic, or customer/service provider non-
ODU management traffic over the deployed Enhanced ODUs, then the admin user can reconfigure the radios
to use a new different reserved VLAN ID between 2 and 4094 using CLI commands.
Note: Whatever alternative Reserved Management VLAN ID is selected, it is essential to ensure both
ends of the link are reconfigured to match the new Reserved Management VLAN ID, and that
the change is saved and committed to both banks on the ODUs at each end of the link.
The Reserved Management VLAN ID can be viewed, and configured only using the Enhanced Command Line
Interface (CLI) using the following steps:
A CLI session can be initiated from the Web GUI by clicking on enhanced# show system reserved vlan
the WebCLI link for the selected ODU on the Link View
Example:
graphics window as shown below: enhanced# show system reserved vlan
Reserved Vlans User Config Running Config
--------------------- ---------------- ---------------------
Res-vlan1 4091 4091
enhanced#
enhanced# configure
(config)# system reserved vlan update <vlan (2-4094)>
Note: By default, the Reserved Management VLAN = 4091. This value is configurable for any VLAN ID between 2 and 4094.
Recommendation: Always change the remote ODU first because after the change you may lose management access to the remote
ODUs until you change the Reserved Management VLAN on the local ODU.
Example:
enhanced# configure
(config)# system reserved vlan update 4093
% Requires ‘save running-config’ and ‘reset system’ for this change to take effect.
(config)# end
enhanced# save running-config
enhanced# reset system
If you pick an invalid VLAN ID the following error message will appear.
Example:
2. If the Reserved Management VLAN is changed from default, make sure the change to the new selected reserved VLAN is made
on all ODUs in the system. In 1+1 HSB, 2+0, or 2+0 XPIC systems make the configuration changes starting with the Remote
Secondary ODU, Local Secondary ODU, then the Remote Primary ODU, and lastly the Local Primary ODU.
Warning: IF only one ODU has the Reserved Management VLAN changed, ACM, and ATPC will stop working until the other peer
ODU has its Reserved Management VLAN changed to match Reserved Management VLAN on the other “Enhanced
ODU”.
Warning: IF only one ODU has the Reserved Management VLAN changed, Link View will stop displaying the remote ODU(s) until
the other peer ODU(s) have the Reserved Management VLAN changed to match Reserved Management VLAN on the
first ODU(s).
Payload VLAN Configuration: Define the range of VLANs that can pass on a given Ethernet port
Web GUI Configuration CLI Equivalent Commands
1. Under the “Configuration -> Packet Switch -> VLAN” tabs, either enter
the specific VLAN or select the “bulk” VLAN box and enter the desired To view the current VLAN config:
VLAN range (eg, VLAN 2-4094). enhanced# show switch vlan
3. Select the “Add/Modify” button and then Click “Submit” Example: (single VLAN on multiple GigE ports)
enhanced# configure
(config)# switch
(config-switch)# vlan 200
(config-switch-vlan)# port add gigabitethernet 0/1
gigabitethernet 0/5
(config-switch-vlan)# end
(config)# end
enhanced# config
Note : Adding the full VLAN range to a port can take upwards of several (config)# switch
minutes to complete. It is recommended to keep the VLAN range as (config-switch)# vlan range vlan [vid] – [vid]
small as conveniently possible to reduce reboot times. (config-switch-vlan-range)# port add gigabitethernet
[0/x]
enhanced# config
(config)# switch
(config-switch)# vlan range vlan 2 - 4090
(config-switch-vlan-range)# port add gigabitethernet 0/1
gigabitethernet 0/5
(config-switch-vlan-range)# end
(config)# end
If a management VLAN has been configured on the same port that If the Reserved management VLAN ID is 4091 and the
the VLANs are being been applied and it falls under the desired bulk previous VLAN range command is executed the
following CLI message will be displayed:
VLAN range, the following error message will be displayed.
Example:
In this example, if port 1 had been configured with a management
VLAN of 200, the following message would occur. enhanced# config
(config)# switch
(config-switch)# vlan range vlan 2 - 4094
%Configuration prohibited for Vlan4091
Note: This is simply a warning to inform the user of the conflict, but
it will not effect the creation of the remaining vlans. In this
example, VLAN’s 2-199 and 201-4090 will be successfully
added.
To verify the 1+1 configuration is correct requires a few checks either via Web GUI or CLI including:
1) Verification that the local primary and secondary radio can communicate via the ODU-ODU
interconnect cable.
2) Verification that the remote primary and secondary radio can communicate via the ODU-ODU
interconnect cable.
3) Verification that the primary link is operational and running error-free
4) Verification that the secondary link is operational and running error-free (separately).
5) Verification that the RSL, and SNR values are optimal.
Verification of primary to secondary communication would need to be done first at the local end, and then at the
remote end. If the link is already up and LinkView is up then verification can be done for both ends easily.
If the link is not yet up, then access to the remote radios is required possibly via a second person at the remote
end of the link.
Local Primary to Secondary Radio Communication Verification: Verify that the local primary and secondary
radios can communicate via the ODU-ODU cable.
Web GUI Verification of Primary to Secondary Communication CLI Equivalent Commands
1. Under the Link View “Graphic” or “Both” display window verify that the To verify that the Primary to Secondary Communication
ODU-to-ODU cable or line connecting the primary and secondary local radios is working in CLI, use the “show redundancy status”
is shown as “green” (see example below). command to successfully show the partner status.
Example:
enhanced# show redundancy status
Local:
System Identifier :primary
System Status :active
Radio Status :up
Interface cross Link Status : not active
Interface group status : gi0/1->up
Partner:
System Identifier :secondary
System Status :standby
Radio Status :up
Interface cross Link Status : active
Interface group status : gi0->down
Local Primary to Secondary Radio Communication Verification: Verify that the local primary and secondary
radios can communicate via the ODU-ODU cable.
Web GUI Verification of Primary to Secondary Communication CLI Equivalent Commands
2. If the cable between the ODUs is NOT connected or faulty, the ODU-to-ODU
link on the ODU will show up as “red” in the Link View – Graphic or Both If the radio fails to retrieve its partner status the
views as shown in the example below. connection between the primary and secondary radios
is not working. The ODU-to-ODU cable may be
disconnected or faulty.
Example:
enhanced# show redundancy status
Local:
System Identifier :primary
System Status :standby
Radio Status :up
Interface cross Link Status : not active
Interface group status : gi0/1->down
Partner:
Failure to retrieve partner redundancy status. Please
check your partner connection.
Peer:
System Identifier :invalid
System Status :standby
Radio Status :down
Interface cross Link Status : not active
Interface group status :
3. The ODU-ODU Connection Status can also be determined using the Web GUI To verify that the Primary to Secondary Communication
using the “List Active Alarms” display window, if the following alarms are is not working in CLI, use the “show system alarms”
listed then the ODU-to-ODU cable or line connecting the primary and command to show “Redundancy partner
communication lost” alarm.
secondary local radios is not properly connected (see example below).
Example:
enhanced# show system alarms
Once the local and remote ODU-ODU cable connectivity has been verified then verification of 1+1 radio link will
need to be verified as operational. If the 1+1 link is already up and LinkView is up then verification can be done
for both ends easily.
Once this has been verified, the TX can be muted on the Primary radios in order to verify that the Secondary
radios are also operational. After Secondary verification, unmute the Primary TX and the wireless link should
return to the Primary radios.
1+1 Link Verification – Revertive enabled: Verify that the primary and secondary links are up and
operational.
Web GUI Verification of 1+1 Links
1. Under the Link View “Graphic” or “Both” display window verify that the ODU-to-ODU cables or line connecting the primary
and secondary local radios is shown as “green” (see example below).
2. The status of the link can be verified as double rows of green arrows present between the active wireless radios when the
1+1 link is up and operational as shown in the screen capture below. When revertive mode is enabled and all transmitters
are on, the active wireless link should be displayed between the two Primary radios as shown below:
1+1 Link Verification – Revertive enabled: Verify that the primary and secondary links are up and
operational.
Web GUI Verification of 1+1 Links
The RSL values on the Primary radios should also be close to each other (typically within a 1-3 dBm) and consistent with the engineered link
design. The RSL of the Secondary radios will be 4-6dBm lower due to the added attenuation on the secondary side of the PSRM.
Link
RSL & SNR Status
3. Verify that no Rx Bad Frames are being displayed for ether of the active wireless radios (Primary-A and Primary-Z). The
radios that are currently carrying the ethernet traffic will display the Radio Port Statistics for both the Local and the
Partner radio.
1+1 Link Verification – Revertive enabled: Verify that the primary and secondary links are up and
operational.
Web GUI Verification of 1+1 Links
4. Verify operational status of Secondary radios.
a. Disable the TX of the Primary-A (172.16.35.81 in this example) and ensure wireless link successfully switches
to the Secondary-A radio. This will likely result in an “HSB crosslink” between Secondary-A and Primary-Z.
1+1 Link Verification – Revertive enabled: Verify that the primary and secondary links are up and
operational.
Web GUI Verification of 1+1 Links
b. Disable the TX of the Primary-Z radio (172.16.35.91 in this example), and ensure wireless link successfully
switches to the Secondary-Z radio. This should result in a link between Secondary-A and Secondary-Z.
1+1 Link Verification – Revertive enabled: Verify that the primary and secondary links are up and
operational.
Web GUI Verification of 1+1 Links
c. Unmute the transmitters on both Primary radios. Verify that the link reverts back to the Primary radios.
1+1 Link Verification – Revertive disabled: Verify that the primary and secondary links are up and
operational.
Web GUI Verification of 1+1 Links
1. Under the Link View “Graphic” or “Both” display window verify that the ODU-to-ODU cables or line connecting the
primary and secondary local radios is shown as “green” (see example below).
2. The status of the link can be verified as double rows of green arrows present between the active wireless radios when the
1+1 link is up and operational as shown in the screen capture below. When revertive mode is disabled and all transmitters
are on, the active wireless link could be between either of radios on the Local End (Primary-A or Secondary-A) and either of
the radios on Remote End (Primary-Z or Secondary-Z) depending on several acquisition timing factors.
Note: When revertive mode is disabled, “Main” and “Protection” will not appear above each radio in the Graphic View.
The RSL values on the Primary radios should also be close to each other (typically within a 1-3 dBm) and consistent with the
engineered link design.
The RSL of the Secondary radios will be 4-6dBm lower due to the added attenuation on the secondary side of the PSRM.
1+1 Link Verification – Revertive disabled: Verify that the primary and secondary links are up and
operational.
Web GUI Verification of 1+1 Links
3. Verify that no Rx Bad Frames are being displayed for ether of the active wireless radios (Primary-A and Primary-Z). The
radios that are currently carrying the ethernet traffic will display the Radio Port Statistics for both the Local and the
Partner radio.
Example:
Primary-A (active wireless, standby ethernet) Secondary-A (standby wireless, active ethernet)
enhanced# show radio status enhanced# show radio status
The RSL values should also be close to each other (typically within a 1-3 dBm) and consistent with the engineered link design,
and SNR values should be as high as the link will support.
“Partner” is the co-located local radio to the radio you are logged into.
“Peer” is the remote radio corresponding to the radio you are logged into. Only visible when “active ethernet” radio
(radio processing the ethernet traffic).
Example:
Primary-A (active wireless, standby ethernet) Secondary-A (standby wireless, active ethernet)
enhanced# show redundancy status enhanced# show redundancy status
Local: Local:
Partner: Partner:
Peer:
7 Firmware Commit
These memory banks are designed to contain the system firmware and configuration. The current running
configuration will only save to the active bank when selecting “save” from the top left corner of the Web GUI or
issuing the “save running-config” command via CLI.
To copy the contents of the active bank to the backup bank, the “firmware commit” command must be issued via
CLI. This will copy the configuration stored in the active bank to the backup bank, making both banks equal.
NOTE: It is very important to ensure the “firmware commit” command is issued after making changes to
the active bank configuration, and saving those changes. Failure to do a commit operation which
copies the active configuration to the backup configuration, may result in an undesired running
configuration if the backup bank becomes the active bank.
Firmware Commit
Web GUI Configuration CLI Equivalent Commands
The commit operation will copy the active OMNI and saved configuration to the backup bank. Click on
the “Firmware Commit” in the import SW window to copy the active configuration to the inactive enhanced# firmware commit
flash memory bank.
The commit operation will copy the
Repeat for each of the 4 radios in the 1+1 link. active OMNI and saved configuration
to the backup bank. You will not be
able to switch back to the previous
OMNI.
Would you like to save the running
config and commit? [y/n]: y