XTMSeries Upgrade Instruction
XTMSeries Upgrade Instruction
Rev A | 2021-06-24
Copyright
This Manual is the property of Infinera Corporation and is confidential. No part of this Manual may be reproduced for
any purposes or transmitted in any form to any third party without the express written consent of Infinera.
Infinera makes no warranties or representations, expressed or implied, of any kind relative to the information or any
portion thereof contained in this Manual or its adaptation or use, and assumes no responsibility or liability of any kind,
including, but not limited to, indirect, special, consequential or incidental damages, (1) for any errors or inaccuracies
contained in the information or (2) arising from the adaptation or use of the information or any portion thereof
including any application of software referenced or utilized in the Manual. The information in this Manual is subject to
change without notice.
Trademarks
Infinera, Infinera Intelligent Transport Networks, I-PIC, IQ NOS, FlexILS, DTN-X, DTN, ATN, FastSMP and logos that
contain Infinera are trademarks or registered trademarks of Infinera Corporation in the United States and other
countries. All other trademarks in this Manual are the property of their respective owners.
Infinera DTN-X, DTN, FlexILS, Cloud Xpress, XT and ATN Regulatory Compliance
FCC Class A
This device complies with Part 15 of the FCC rules. Operation is subject to the following two conditions: (1) this
device may not cause harmful interference, and (2) this device must accept any interference received, including
interference that may cause undesired operation. Modifying the equipment without Infinera's written authorization
may result in the equipment no longer complying with FCC requirements for Class A digital devices. In that event,
your right to use the equipment may be limited by FCC regulations, and you may be required to correct any
interference to radio or television communications at your own expense.
DOC Class A
This digital apparatus does not exceed the Class A limits for radio noise emissions from digital apparatus as set out in
the interference-causing equipment standard titled “Digital Apparatus," ICES-003 of the Department of
Communications.
Cet appareil numérique respecte les limites de bruits radioélectriques applicables aux appareils numériques de
Classe A prescrites dans la norme sur le matériel brouilleur: "Appareils Numériques," NMB-003 édictée par le
Ministère des Communications.
Class A ITE
This is a Class A product based on the standard of the VCCI Council. If this equipment is used in a domestic
environment, radio interference may occur, in which case, the user may be required to take corrective actions.
Warning
This is a class A product. In a domestic environment this product may cause radio interference in which case the user
may be required to take adequate measures.
FDA
This product complies with the DHHS Rules 21CFR 1040.10 and 1040.11, except for deviations pursuant to Laser
Notice No. 50,dated June 24, 2007.
CONTENTS
Contents
1 GENERAL ..........................................................................................................................1
1.1 Document Revision History.........................................................................................1
1.2 Versions....................................................................................................................1
2 IMPORTANT INFORMATION TO READ BEFORE UPGRADING............................................2
2.1 DNA-M Compatibility..................................................................................................2
2.2 Supported versions to upgrade from............................................................................2
2.3 Postpone Firmware Activation function ........................................................................3
2.3.1 General ...........................................................................................................3
2.3.2 Before an upgrade............................................................................................3
2.3.3 After an upgrade...............................................................................................5
2.4 Special Considerations...............................................................................................6
2.4.1 MS-MXP10G....................................................................................................8
2.4.2 FXP400GOTN .................................................................................................8
2.4.3 TRX100267/TC ...............................................................................................8
2.4.4 Ethernet Muxponder (EMXP).............................................................................8
2.4.5 MDU40 or VOA8CHII........................................................................................9
2.5 Notice .....................................................................................................................10
2.5.1 Upgrading FHAU/1, TM-FHAU1U–DC/1 and RFU-AC/1 to R36.0.1 ....................10
2.5.2 Upgrading to R35.0.1 or above changes SSH keys ...........................................10
2.5.3 Upgrading TM-EMXP-XH800/DC to R35.0.1 may raise minor alarm ...................10
2.5.4 Upgrading 1x2 ROADM to R36.0.1 may give warning........................................10
2.5.5 Upgrading a system with a NID........................................................................10
2.5.6 TPDDGBE and TPD10GBE with amplifiers....................................................... 11
2.5.7 TPQMR ......................................................................................................... 11
2.5.8 OA17C or OA2 17/17C ................................................................................... 11
2.5.9 CU/CUOSC/CU-SFP replacement with CU-SFPII/CU-SFPIII ............................. 11
3 UPGRADE INSTRUCTIONS..............................................................................................12
3.1 New units/products in this release .............................................................................12
3.2 Software upgrade using DNA-M (multiple nodes) .......................................................13
3.2.1 Preparations DNA-M ......................................................................................13
3.2.2 Upgrade instructions DNA-M (multiple nodes) ..................................................15
3.2.3 Upgrade issues – DNA-M................................................................................18
3.3 Software upgrade using ENM (individual node) ..........................................................20
3.3.1 Preparations ENM ..........................................................................................21
3.3.2 Upgrade instructions ENM (individual node) .....................................................22
3.3.3 Upgrade issues – ENM ...................................................................................24
3.4 Software upgrade using CLI (individual node) ............................................................26
3.4.1 Preparations CLI ............................................................................................27
3.4.2 Upgrade instructions CLI (individual node) .......................................................28
3.4.3 Upgrade issues - CLI ......................................................................................32
4 SOFTWARE VERSIONS ...................................................................................................33
4.1 Software versions for first generation of Control Units .................................................33
4.2 Software versions for second generation of Control Unit .............................................33
4.3 Software versions for third generation of Control Unit..................................................33
4.4 Software versions for fourth generation of Control Unit................................................34
4.5 Software versions for first generation of Traffic Units...................................................35
4.6 Software versions for second generation of Traffic Units .............................................36
4.7 Software versions for third generation of Traffic Units..................................................37
4.8 Software versions for fourth generation of Traffic Units................................................38
4.9 Software versions for fifth generation of Traffic Units...................................................38
4.10 Software versions for sixth generation of Traffic Units ...............................................39
4.11 Software versions for seventh generation of Traffic Units...........................................40
4.12 Software versions for eighth generation of Traffic Units .............................................40
4.13 Software versions for ninth generation of Traffic Units ...............................................40
4.14 Software versions for tenth generation of Traffic Units...............................................41
4.15 Software versions for eleventh generation of Traffic Units..........................................41
5 FALL BACK ......................................................................................................................42
5.1 Fall back Considerations ..........................................................................................42
5.1.1 Fall back from R36.0.1 and “Postpone Firmware Activation” function ..................42
5.1.2 ENM with ‘Server’ set to ‘local’.........................................................................42
5.2 Fall back procedure using ENM ................................................................................43
5.3 Fall back procedure using CLI — Alternative 1 ...........................................................45
5.4 Fall back procedure using CLI — Alternative 2 ...........................................................47
6 APPENDIX .......................................................................................................................49
6.1 FPGA revision history for boards supporting the ‘Postpone Firmware Activation’
function ...........................................................................................................49
6.2 Boards at End of Software Support (ESS)..................................................................50
6.2.1 End of Software Support (ESS) – R33.1 ...........................................................50
6.2.2 End of Software Support (ESS) – R32.1 ...........................................................50
6.2.3 End of Software Support (ESS) – R31.1 ...........................................................50
6.2.4 End of Software Support (ESS) – R31.0 ...........................................................51
6.3 Upgrade Analysis Tool..............................................................................................52
7 CONTACT INFORMATION ................................................................................................53
1 GENERAL
The purpose of this document is to provide step-by-step instructions of how to upgrade the In-
finera XTM Series software from R32.0.1, R32.1.1, R33.1.1, R34.0.2 and R35.0.1 to R36.0.1.
If an older software version than R32.0.1 is in use, a first upgrade to R32.0.1 is needed before
performing the steps to upgrade to R36.0.1 in this instruction. For information of how to up-
grade to R32.0.1, read the upgrade instructions for the relevant release.
Table 1 Upgrade towards R36.0.1 using CU-SFP/II, CU-SFP/III and CU-less systems in sec-
tion 2.2 Supported versions to upgrade from shows the number of upgrade steps that are
needed to be performed for different releases before upgrading to R36.0.1.
There are three possible ways of upgrading the software on a node: using DNA-M, ENM GUI
or CLI. If using the DNA-M you can upgrade the whole network with a few simple steps.
This instruction contains many upgrade steps. Please make sure to follow them in chronologi-
cal order. Command examples should be written exactly the way they are described in this
document. For example, if a command contains parameters in capital letters (e.g “swu +FS
upgrade……”) then they should be written in capital etc.
1.2 Versions
The new ENM-specification file is: enm001a-r36a-1.spec. Depending on board type different
files are used. For a list of all software files, see chapter 4 SOFTWARE VERSIONS in this
document.
Table 1 Upgrade towards R36.0.1 using CU-SFP/II, CU-SFP/III and CU-less systems
Please read the release notes and upgrade instructions on how to upgrade to R36.0.1 from
earlier releases described in this document.
By choosing not to update to new firmware, new released functions may not be available or
supported. A cold boot of a board will always activate the latest firmware.
Fig. 1 Marked boards will keep the old firmware after the upgrade.
Above is an example from ENM where an active choice has been taken to postpone activation
of firmware before an upgrade.
Upgrade to R36.0.1
SW level at R32.0.0, Traffic Combination Active choice needed before upgrading?
R32.0.1, R33.1.0,
R33.1.1, R34.0.0,
R34.0.1, R34.0.2,
R35.0.0, R35.0.1
MS-MXP gbex3stm4Oc12x1stm1Oc3x3Basic YES, if new FPGA in R23.1 has not been activated
gbex3stm4Oc12x1stm1Oc3x3 YES, if new FPGA in R23.1 has not been activated
gbex1stm16Oc48x1stm1Oc3x3 YES, if new FPGA in R23.1 has not been activated
gbeSyncEx3stm4Oc12x1stm1Oc3x1 NO. No new FPGA
gbeSyncEx3stm4Oc12x1stm1Oc3x1Basic NO. No new FPGA
MS-MXP10G gbEx4Stm16Oc48x2 YES, if new FPGA in R19.0.5 has not been activated
stm16Oc48x4 YES, if new FPGA in R19.0.5 has not been activated
syncEx14GLinex2 YES, if new FPGA in R32.1 has not been activated
MS-MXP40G N/A YES, if new FPGA in R22.0 has not been activated
MS-TP40G N/A NO. No new FPGA
TPD10GBE N/A YES, if new FPGA in R17.0.3 has not been activated
GBE9/MXP10GFEC N/A YES, if new FPGA in R21.0 has not been activated
TPQ10GFEC N/A NO. No new FPGA
TPQ10GFEC/I N/A NO. No new FPGA
TPQMS N/A YES, if new FPGA in R22.0 has not been activated
Fig. 2 Activation of new firmware. Traffic disturbance to follow for the marked boards.
In the new dialog window, the boards that should be activated with the latest firmware, mark
them in the check boxes and press the ’Apply’ button. The firmware upgrade procedure may
take up to 3 minutes to conclude.
Above is an example from the ENM GUI where activation of firmware is performed after an up-
grade. Activation of new firmware will cause a traffic disturbance.
Board Type
New R32.0.0 R32.1.0 R33.1.0 R34.0.0 R35.0.0
FPGA in- R32.0.1 R32.1.1 R33.1.1 R34.0.1 R35.0.1
troduced R34.0.2
in:
GBE10-EMXP10G/II No
N/A Yes Yes Yes Yes (HSU)
GBE22-EMXP10G/II
No
EMXP80G/II N/A Yes Yes Yes Yes (HSU)
EMXP48/IIE
EMXP62/IIE
No
EMXP120/IIE N/A Yes Yes Yes Yes (HSU)
EMXP220/IIE
EMXP240/IIE
No
TM-EMXP-1U-DC N/A Yes Yes Yes Yes (HSU)
No
EMXP/III N/A Yes Yes Yes Yes (HSU)
EMXP440/III No
N/A Yes Yes Yes Yes (HSU)
EMXP440-Q/III
MS-MXP
R23.1 1 1 1 1 1
TC: gbex3stm4Oc12x1st- Yes Yes Yes Yes Yes
R21.0
m1Oc3x3Basic
MS-MXP
TC: R23.1 1 1 1 1 1
Yes Yes Yes Yes Yes
gbex3stm4Oc12x1stm1Oc3x3 R21.0
Board Type
New R32.0.0 R32.1.0 R33.1.0 R34.0.0 R35.0.0
FPGA in- R32.0.1 R32.1.1 R33.1.1 R34.0.1 R35.0.1
troduced R34.0.2
in:
MS-MXP
TC: R23.1 1 1 1 1 1
Yes Yes Yes Yes Yes
gbex1stm16Oc48x1stm1Oc3x3 R21.0
MS-MXP10G 1 1 1 1 1
TC: gbEx4Stm16Oc48x2 R19.0 Yes Yes Yes Yes Yes
MS-MXP10G 1 1 1 1 1
R19.0 Yes Yes Yes Yes Yes
TC: stm16Oc48x4
MS-MXP10G 1 1 1 1 1
TC: syncEx14GLinex2 R32.1.1 Yes Yes Yes Yes Yes
1 1 1 1 1
TPD10GBE R17.0.3 Yes Yes Yes Yes Yes
NOTE: Board types not listed above do not have reported disturbances.
1. If new FPGA is activated
2.4.1 MS-MXP10G
2.4.1.1 Upgrade of MS-MXP10G
A new traffic FPGA was introduced in R32.1.1 for the board MS-MXP10G and the traffic com-
bination “syncEx14GLinex2”.
Upgrading from earlier releases to R36.0.1 an active choice needs to be taken before the up-
grade to avoid a firmware upgrade. This can be done by using the ‘Postpone Firmware Activa-
tion’ function. If no active choice is taken the firmware will be upgraded, which will cause a
traffic disturbance.
Performed tests indicates that the traffic disturbance will last less than one minute.
2.4.2 FXP400GOTN
2.4.2.1 Using the FXP400GOTN board with OCM/2p
If the FXP400GOTN board is intended to be used with the OCM/2p board, then the firmware
in the OCM/2p needs to be upgraded to revision 3.85 with a script that can be received from
the Infinera TAC support.
2.4.3 TRX100267/TC
2.4.3.1 Upgrading traffic units equipped with TRX100267/TC
Traffic units equipped with certain versions of TRX100267/TC may be causing a traffic disturb-
ance. Potentially affected traffic units are EMXP220/IIE, TP100GOTN, TP100GOTN/II and
MXP100GOTN. See product change notification 100025-PCN00224 for details.
Upgrade of boards will cause a traffic disturbance when the boards are restarted.
The downtime during a reboot is roughly 45 seconds, it is however strongly dependent on the
amount of configuration and can differ significantly from this value.
Upgrade of boards from release R35.0 to R36.0.1 are disturbance free (HSU).
Upgrade of boards from older releases than R35.0 will cause a traffic disturbance when the
boards are restarted
The downtime during a reboot is roughly 45 seconds, it is however strongly dependent on the
amount of configuration and can differ significantly from this value.
Upgrade of boards from release R35.0 to R36.0.1 are disturbance free (HSU).
Upgrade of boards from older releases than R35.0 will cause a traffic disturbance when the
boards are restarted.
The downtime during a reboot is roughly 45 seconds, it is however strongly dependent on the
amount of configuration and can differ significantly from this value.
Please see the Technical Description for the Ethernet Muxponders/II and NID for more infor-
mation about traffic disturbances.
If you are using optical control loops (OCL) together with MDU40 or VOA8CHII it is important
that the configuration is saved before an upgrade from previous releases to R36.0.1. If the
configuration is not saved before the upgrade there might be problems with the control loops if
a "fall back" of SW is executed.
2.5 Notice
2.5.1 Upgrading FHAU/1, TM-FHAU1U–DC/1 and RFU-AC/1 to
R36.0.1
Upgrading the boards FHAU/1, TM-FHA1U-DC/1 and RFU-AC/1 from older releases to
R36.0.1 will not be allowed. The last software release to use with old functionality (e.g CPRI/
OBSAI/GBE) is R35.0. If any of these boards are used in a network node it will no longer be
possible to upgrade the node to newer releases (e.g. R36.0.1) until the boards are deleted
from the configuration and a new backup has been saved. After the configuration change it will
be possible to upgrade the nodes to R36.0.1 and re-create these boards for use with new
functionality (LAN10GBE).
After upgrading from older releases than R35.0.1 to R35.0.1 or above ssh keys are changed
on the hosts. If re-generation of new ssh keys are wanted, please follow instructions in the
document "XTM Series Installation & Commissioning Configuration Guide" at chapter "Gener-
ating SSH Key Pair".
Upgrading the board TM-EMXP-XH800/DC to release R35.0.1 may raise the alarm “Manage-
ment ports blocking overridden due to loss of management connectivity” with severity “Minor”.
If the minor alarm is received, this is likely the cause of pre R35.0.1 software which has the
"Local Craft access" parameter set to "disabled" as default value. This alarm can be cleared
by setting the parameter "Local craft ETH access" to "enabled". In ENM browser this parame-
ter resides at path ”Configuration/System/Access Control/Security”.
When upgrading the boards 1x2ROADM/50G and 1x2ROADM/100G to release R36.0.1 the
alarm “Firmware Upgrade Available” with severity “Warning” may be raised. This warning indi-
cates that new firmware is available. If the warning is received, then a module on the ROADM
unit is using old firmware. It is recommended to proceed with the firmware upgrade to avoid
signal quality variations. Detailed information on how to obtain the firmware upgrade and re-
lated instructions can be found at Infinera Customer Support Portal. Upgrading the ROADM
firmware before upgrading to release R36.0.1 will avoid the warning.
When upgrading a node that has a NID (Network Interface Device) attached to an EMXP port,
the firmware on the NID has to be upgraded in order to support the new release. The NID can
be remotely upgraded from the EMXP by selecting the upgrade function and transferring a
new firmware to the NID. Detailed information on how to do NID firmware upgrade can be
found in the document “EMXP Installation & Commissioning Guide”. The NID firmware is in-
cluded in the XTM Series software delivery.
2.5.7 TPQMR
If using a TPQMR of version R1A or R1B that is running 1G FC or 2G FC traffic, the format
may be configured to “other” with speed “850” (when using 1G FC) or “other” with speed
“1700” (when using 2G FC). This format should in such case be changed to “1GFC” or
“2GFC” before the upgrade to avoid future problems with board replacements of TPQMR to
revision R2A. The change of traffic format from “other/850” to “1GFC” or “other/1700” to 2GFC
will not cause any traffic disturbances on TPQMR’s of revision R1A. Do not forget to save the
changes!
3 UPGRADE INSTRUCTIONS
It is recommended to reduce the number of backup files before an upgrade. With more
stored backup files the risk for time-out in DNA-M, ENM or CLI during an upgrade in-
creases. The reason for that is that the activation phase of the upgrade will take longer
time. Backup handling in ENM can be found by entering the ‘Backup Control’ link. A
system may normally have a primary and a secondary backup file.
All systems that should be upgraded to R36.0.1 must first be upgraded to R32.0.1 or lat-
er. If upgrading from older SW release then please follow the recommendations in
chapter ‘2.2 Supported versions to upgrade from’.
Please read the ‘Release Notes’, chapter ‘2.3 Postpone Firmware Activation function’
and chapter '‘2.4 Special Considerations’ before upgrading to this release.
Since the node uses ftp to download the software it is important that the network connection
between the ftp-server and node is not too poor. If the network connection is poor, e.g. when
using ADSL modems etc you might get timeouts when downloading the software.
The allowed set of characters from which backup filenames should be constructed are the
following:
ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvw
xyz0123456789._-
The last three characters are the <period>, <underscore>, and <hyphen> characters,
respectively.
It is important that the DNA-M SW is of release R36.0 or later and with the latest patch level
when upgrading the nodes.
Fig. 3 DNA-M
Step 1 Check that your DNA-M server is of version R36.0 or later and with the lat-
est patch level. This is done by choosing ‘Help’ and then ‘About’ in DNA-
M Client or DNA-M Server.
Step 2 Copy the ‘Downloadables’ directory from the ENM Software to the tftp
subdirectory. This directory is usually located by default in:
For Windows operating systems:
‘C:\Program Files\transmode\tnm\var\tftproot\enmsw’
For Linux operating systems:
‘/var/tnm/tftproot/enmsw’
Step 6 Check active alarms in all nodes and save the printouts by right-clicking in
the subnet area and then choosing ‘Active Alarms->Including Alarms
from Sub-Subnets’ . Press the `Save as´ button to save the alarm list in
an optional directory on your computer. This alarm list will be used after
the upgrade to compare with the alarm list after the upgrade.
Step 7 Check that "Postpone Firmware Activation” settings are set as wanted.
This can only be performed from the ENM. See chapter '2.3 Postpone
Firmware Activation function' for details.
Step 3 Verify in the subnet that none of the nodes that you want to upgrade is
grey.
Step 4 In the subnet, check the `Active Alarms´. Verify for the nodes that you
want to upgrade, that there are no alarms saying ‘Configuration not
saved’.
Step 5 Right-click in the subnet area and select `Maintenance->Software Up-
grade->Including Nodes from Sub-Subnets´.
Step 6 Enter a new task name in ‘New name’ edit field, e.g. ‘Subnet-A-check’.
Step 9 Verify that all selected nodes say ‘Upgrade needed’ in the status field.
Step 12 Select ‘Upgrade’ in the `Operation´ field and press the ‘Apply’ button.
A confirmation box will appear with `The operation will now be started!` or
`Reboot will cause traffic disturbance!´ and the question `Do you want to
continue?´ Press the `OK´ button.
Step 13 Wait until all the nodes are upgraded. Verify that the `Status´ field shows
`OK´ for all the nodes.
NOTE:: If the upgrade of some nodes fails, identify and solve the source
of the problem and repeat steps 5 to 7 again. Possible upgrade issues that
can occur for DNA-M are listed further below.
Configuration changes made after the upgrade part (steps above) and before the node re-
starts (steps below) will not be used after the restart, even if a 'Save' is performed.
Step 18 In the ‘Task field’ select the first task made in these instructions, e.g.
‘Subnet-A-Check’.
Step 19 In the ‘Task field’ select ‘New Task’.
Note: If you did not upgrade some of the nodes in the list seen in the ‘Soft-
ware Upgrade’ window, un-check those nodes in the `Selected´ field.
Step 20 Select ‘Check’ in the `Operation´ field and press the ‘Apply’ button.
Step 21 Verify that all the selected nodes say ‘Up to date’ in the `Status´ field.
Press the `Close´ button to finish the upgrade procedure.
When a "timeout" occurs, the upgrade is still ongoing in the background. One of the final steps
of the upgrade procedure is to ensure that the saved backup files are compatible with the new
release. To do this, a "backup conversion" process is started to go through all the current re-
lease backup files and convert these to the new release backup file structure.
The backup conversion will take longer if there are a large number of backup files or a
lot of configuration in a backup file, or a combination of both.
This requires a certain waiting time before the system will be responsive again to receive com-
mands. Control of the system is given back to the user when the backup conversion takes
more than 15 minutes.
When the control of the system is given back to the user, create a new task and perform a
check/upgrade command on the node again.
Delete the application using CLI: (Syntax: ‘swu delete appl <chassis> <slot> <file>’)
swu delete appl 1 1 cuappl01a-r31a-36
Fault message in CLI:
It is important that only the user that performs the upgrade is logged in to the ENM GUI.
• Go through the numbered items below for all the nodes that need to be upgraded.
• Work with one node at a time and finish the upgrade for that node before starting with the
next node.
• Be aware that the IP address used below is just an example and that it should be changed
to the IP address of the ‘TFTP’ server computer.
• The ‘show’ command responses are examples as well.
• The nodes can be upgraded in any order, as long as you work with one node at a time.
However, Infinera recommends that you start with the far end nodes and work towards the
node where the ‘TFTP’ server computer is connected to minimize the risk of losing the con-
nectivity to the whole network.
Step 1 Create a new folder and name it ‘tftp’ on your tftp server computer. Make
sure that you choose a computer that can be reached from all the nodes
that you want to upgrade.
Step 2 Put all R36.0.1 software files and the tftp program called ‘tftpd32.exe’ in
that folder. The files and the program can be found under the directory
‘downloadables’ in the ENM software package.
Step 3 Start the tftp server, by clicking on the file named ‘tftpd32.exe’.
Step 9 Check active alarms in all nodes and save the printouts. This is done in
the following way on a PC:
1. Select ‘Alarms and events’ then ‘Current’ in left pane of the ENM
GUI.
2. Mark all the alarm text.
3. Click on the right mouse button.
4. Choose ‘Copy’.
5. Open ‘Notepad’ or ‘Wordpad’.
6. Select ‘Edit’ in the menu of Notepad or Wordpad.
7. Select ‘Paste’. Save the file
Step 10 Check that "Postpone Firmware Activation” settings are set as wanted.
This can only be performed from the ENM. See chapter '2.3 Postpone
Firmware Activation function' for details.
Step 1 Login to the node as user “oper”, using the web-browser (ENM GUI).
Step 2 Check that you have a R32.0.1 release or later. If not, then follow instruc-
tions at chapter 2.2 (supported versions to upgrade from). The information
about software version could be read at the lower left corner of the ENM
GUI, see Figure 5. (includes r29a).
Step 3 Save the configuration before continuing, this is done by pressing the
“Save” button in the ENM GUI, see Figure 7. Then enter a file name in
the dialogue that appears and press the “Save” button.
In order to eliminate problems during the upgrade one should empty the cache and remove
temporary information from the used web browser before starting the upgrade. Then refresh
the page. Close down all tabs that are not used at the moment. To have only one session is
strongly recommended. After the upgrade similar measures may be needed.
Step 6 In the ’Select ENM spec’ pop-up window, select ’Remote’ in the Server
field.
Step 7 Enter the IP address to your TFTP server in the IP edit field.
Step 8 Fill in your server path e.g. ‘/enm001a-r36a-1.spec’ in the Path edit field
and press the Apply button.
Step 9 Select ’Check’ in the last row of the Action field and press the Apply but-
ton at the bottom of the ENM GUI.
Step 10 In the ‘Confirm action’ pop-up window, press the ’Execute’ button.
Step 11 Verify in the tab SW Status that it shows lines of: “Needs upgrading to...”
Step 12 Select ’Upgrade’ in the last row of the Action field and press Apply but-
ton at the bottom of the ENM GUI.
Step 13 In the ‘Confirm action’ pop-up window, press the ’Execute’ button. Now
the software will be downloaded and installed.
Step 14 When the upgrade procedure is done, verify that SW status field says:
Software update on reboot
If the SW status is not correct, then repeat the upgrade steps from step 5.
Possible upgrade issues that can occur for ENM are listed further below.
Step 15 When the correctness of the SW status is verified then a reboot of all
boards are needed in order to set the new software in use.
Select ’Reboot ’ in the last row of the Action field and press Apply button
at the bottom of the ENM GUI.
In the ‘Confirm action’ pop-up window, press the ’Execute’ button. Now all
boards will be rebooted.
It will be impossible to log in to the node before it has started again, this could take 1-2
minutes.
Step 16 Login to the node again using ENM GUI. Login as user ‘oper’ or ‘root’.
Step 19 Go back to ‘Step 1’ and start with the next node in the network.
The recommended remedy is to remove older unused backup files. Using ENM browser the
location of backup files can be found at path “Configuration/Backup Control/ Backup Files”.
After removal of old backup files, re-try the upgrade procedure.
Deletion of the application is done in the CLI for the failed node. E.g. with the above error mes-
sage would be:
swu delete appl 1 1 cuappl01a-r31a-36
Upgrade issue:
Lack of CU memory can result in a failed upgrade state with no additional information
If the upgrade procedure fails on a multiple subrack node with CU-SFP/II as master CU with
no additional information, it could be due to lack of available memory on the main CU causing
the CU to perform a reboot before the upgrade is complete. If this happens, the upgrade pro-
cedure will most likely fail and continue to fail on consecutive upgrade attempts.
Please contact Infinera TAC support for further information.
• Go through the numbered items below for all the nodes that need to be upgraded.
• Work with one node at a time and finish the upgrade for that node before starting with the
next node.
• Be aware that the IP address used below is just an example and that it of course should be
changed to the IP address for the tftp server computer.
• The show command responses are examples as well. The actual printouts depend on the
node configuration, the type and amount of boards can vary. The printouts below corre-
spond to a basic configuration containing one control unit (CU) and only one traffic unit
(TU).
• The nodes can be upgraded in any order, as long as you work with one node at a time.
However, Infinera recommends you to start with the far end nodes and work towards the
node where the tftp server computer is connected.
Step 1 Create a new folder and name it “tftp” on your “tftp server computer”. Make
sure that you choose a computer that can be reached from all the nodes
you want to upgrade.
Step 2 Put all R36.0.1 software files and the tftp program called tftpd32.exe in
that folder. The files and the program can be found under the directory
“downloadables” in the ENM software package.
Step 3 Start the tftp server, by clicking on the file named tftpd32.exe.
Step 9 Check active alarms in all nodes and save the printouts. These printouts
should be compared with the alarm printouts after the upgrade. Use the
command:
activeAlarms
Step 10 Check that "Postpone Firmware Activation” settings are set as wanted.
For example:
show ::eq::board::<boardtype>:<subrack>:<slot>::postponeFwUpgrade
or:
show ::eq::board::*::postponeFwUpgrade
Step 1 Login to the node as an oper user, using the Command Line Interface (CLI).
Step 2 Check that you have at least a R32.0.1 release. This is done by verifying that all the
softwares in the ‘Application’ column when performing ‘swu show executing’
includes r31a or later. If not then follow instructions at chapter 2.2 (supported
versions to upgrade from).
Use the command:
swu show executing
Expected printout (for CU systems):
Infinera::> save
saving to config.xml
File exists, overwrite? (yes or no) (no) yes
.......................................................
Saving backup on central unit.
Invalidating backup copies on traffic units.
Slot 5: done
Slot 3: done
Transferring backup to traffic units.
Slot 5: done
Slot 3: done
Transferring additional persistent files to traffic units.
Slot 5: snmpd.conf passwd done
Slot 3: snmpd.conf passwd done
Infinera::>
Step 5 Upgrade application, boot, kernel and file system SW. Use the command:
swu +FS upgrade all all 172.16.15.80/enm001a-r36a-1.spec
Expected printout:
If the upgrade fails for any reason at this stage, then one should repeat
‘Step 4’ and ‘Step 5’ again. Possible upgrade issues that can occur
for CLI are listed further below.
Step 6 Check that all boards have the expected software. Use the commands:
swu show next
Expected printout (for CU systems):
Step 7 Check that all boards have the right file system installed. Use the command
swu show filesystem all
Expected printout:
Step 8 Compare the software information in ‘Step 6’ and ‘Step 7’ with ‘Table 2’ to ‘Table 7’
at ‘Chapter 4’.
Make sure that all the software’s are correctly installed and acti-
vated for each board (i.e. Check that both CU and TUs have the
same software release) before rebooting the node.
If not all of the above expected software are correct, go back and per-
form the upgrade procedure again.
NOTE: Configuration changes made after the upgrade part (steps
above) and before the node reboots (steps below) will not be used
after the reboot, even if a 'Save' is performed.
Expected printout:
We are done
Infinera::> Rebooting...
The system is going down NOW!
Step 11 Check the active alarms, compare with the active alarms before the SW upgrade.
Use the command:
activeAlarms
If there are alarms saying “Interwork failed” then probably the SW is not correctly in-
stalled. Then repeat the steps in this description.
Step 12 Check that all boards have the right R36.0.1 software installed. Use the command:
swu show executing
Expected printout (for CU systems):
We are done.
See ‘Step 6’ for information about what the software should be.
Step 13 Check that all boards have the right file system installed. Use the command
swu show filesystem all
Expected printout:
The recommended remedy is to remove older unused backup files. Using CLI the location of
backup files can be found using command “::backup::file::”. After removal of old backup files,
re-try the upgrade procedure.
4 SOFTWARE VERSIONS
The software versions for R36.0.1 are shown in this chapter.
Application CU-less
Board Type TU1 1 Software in Application Boot Kernel File System Released
CU systems Software 2 in
TP10GCLX /xxxx R1B tuappl01a- cu10gappl01a- tuboot01a- oskernel01a- osappl01a- 4.1.1 (ESS)
r33b-43 r27a-30.ppc_ r14a-1 r19a-2 r22a-1
8xx.rpm
Application CU-less
Board Type TU2 1 Software in Application Boot Kernel File System Released
CU systems Software 2 in
1x4ROADM–F/II 34.0
Application CU-less
Board Type TU3 1 Software in Application Boot Kernel File System Released
CU systems Software 2 in
EMXP80G/II 16.0
Application CU-less
Board Type TU4 1 Software in Application Boot Kernel File System Released
CU systems Software 2 in
Application CU-less
Board Type TU5 1 Software in Application Boot Kernel File System Released
CU systems Software 2 in
Application CU-less
Board Type TU6 1 Software in Application Boot Kernel File System Released
CU systems Software 2 in
EMXP120/IIE 21.0
EMXP220/IIE 23.0
EMXP240/IIE 25.0
Application CU-less
Board Type TU7 1 Software in Application Boot Kernel File System Released
CU systems Software 2 in
Application CU-less
Board Type TU8 1 Software in Application Boot Kernel File System Released
CU systems Software 2 in
Application CU-less
Board Type TU9 1 Software in Application Boot Kernel File System Released
CU systems Software 2 in
Application CU-less
Board Type TU10 1 Software in Application Boot Kernel File System Released
CU systems Software 2 in
Application CU-less
Board Type TU11 1 Software in Application Boot Kernel File System Released
CU systems Software 2 in
5 FALL BACK
If for any reason the upgrade failed and one wants to revert to the old SW, use ENM or CLI to
perform a downgrade of application, boot and kernel SW. The file system is backward compat-
ible and will work with an earlier version of the SW.
Boards with the function “Postpone Firmware Activation” set to ”disabled” during an upgrade
and with a traffic disturbance, will also have a traffic disturbance at fall back.
Fall back procedure using ENM with ‘Server’ set to ‘local’ is currently not supported.
Step 2 In the ‘SW Status’ tab, press the button ’Select ENM spec’.
Step 4 Enter the IP address to your TFTP server in the ‘IP’ edit field.
Step 5 Fill in your server path e.g. ‘/enm001a-r32a-1.spec’ in the ‘Path’ edit field.
Step 7 In the ‘SW Status’ tab at the field ‘Name’, click the top square box at the
left once or mark all boxes under the ‘Name’’ field next to the boards one
by one.
Step 8 In the ‘SW Status’ tab under the field ‘Action’, select ’Upgrade’ for all
boards.
Step 9 At the top of the page press the button ‘Apply’. In the dialog window, con-
firm the action by pressing the ‘Execute’ button. If the R32.0.1 application
software is still available on the board then it will be activated directly oth-
erwise the application, boot and kernel software will be downloaded and
installed.
Step 10 When the upgrade procedure is done, the ‘SW Status’ field says ‘Soft-
ware update on reboot’.
If the ‘SW Status’ state is not correct, then repeat the upgrade from ‘Step
2’.
Step 11 In the field ‘Action’, select ’Reboot’ for all boards.
At the top of the page press the button ‘Apply’
In the dialog window, confirm the action by pressing the ‘Execute’ button.
Now all boards will be rebooted.
It will be impossible to log in to the node before it has started again, this could take 1-2
minutes.
Step 12 Login to the node again using ENM GUI. Login as user ‘oper’ or ‘root’.
If there are alarms saying “Interwork failed” then probably the SW is not correctly installed. In
this case repeat ‘Step 1’ to ‘Step 14’.
Step 15 Go back to ‘Step 1’ and start with the next node in the network.
Step 1 Login to the node as an oper user, using the Command Line Interface (CLI).
Step 3 Downgrade application, boot and kernel to original SW release, In this case
R32.0.1. Use the command:
swu upgrade all all 172.16.15.80/enm001a-r32a-1.spec
Expected printout:
We are done
Wait until all software are activated for each board.
Step 4 When the upgrade procedure is done. Make sure that the correct software is
installed and activated by using following commands at CLI:
swu show next
Expected printout:
Step 5 If the software is not correctly installed or activated for any board then repeat the
upgrade 'Step 2' and 'Step 3'.
Step 6 When the correctness of the activated application software is verified (compare to
enm001a-r32a-1.spec) then a reboot of all boards are needed in order to set the
new software in use. Use the command:
swu reboot all
If there are alarms saying 'Interwork failed' then probably the SW is not
correctly installed. In this case repeat steps 'Step 1' to 'Step 6'.
Step 7 Log in to the node and check the active alarms. Note that it will be impossible to log
in to the node before it has started again, this could take 1-2 minutes. Compare with
the active alarms before the SW upgrade. Use the command:
activeAlarms
If using OAR-450C a 'Configuration' error might appear after the 'fall back'. Then
make a 'swu reboot cu' and the alarm will disappear.
If you have done a 'fall back' and then upgrades to the same version of CU-application that
was used before the 'fall back', the backup that was used before the 'fall back' will be used
again. Please, contact Infinera support before doing the second upgrade.
Step 1 Login to the node as an oper user, using the Command Line Interface (CLI).
Step 2 Check if a valid fallback check point exists. Use the command:
swu show fallback
If the reply printout is “No fallback check point exists” this fallback method can-
not be used. Please use other fallback methods.
Expected printout:
Fallback check point created Tue May 29 09:42:50 CEST 2020 at upgrade
from enm001a-r34a-1 to enm001a-r35a-0
Run 'swu -n fallback all all' to see effect of fallback.
We are done
Step 3 Check which software parts that will be affected by the fallback. Use the command:
swu -n fallback all all
Expected printout:
Fallback check point created Tue May 29 09:42:50 CEST 2020 at upgrade
from enm001a-r34a-1 to enm001a-r35a-0
1.3 appl tuappl01a-r36a-30 Needs activation of ... 10:29:24
1.3 tuappl01a-r34a-39 is expected 10:29:24
1.5 boot tuboot02a-r36a-2 Needs activation of ... 10:29:24
1.5 tuboot02a-r34a-1 is expected 10:29:24
1.5 kernel oskernel02a-r36a-1 Needs activation of ... 10:29:24
1.5 oskernel02a-r34a-1 is expected 10:29:24
1.5 appl tuappl02a-r36a-30 Needs activation of ... 10:29:24
1.5 tuappl02a-r34a-39 is expected 10:29:24
1.1 boot cuboot02a-r35a-1 Needs activation of ... 10:29:24
1.1 cuboot02a-r32b-2 is expected 10:29:24
1.1 kernel oskernel02a-r36a-1 Needs activation of ... 10:29:24
1.1 oskernel02a-r34a-1 is expected 10:29:24
1.1 appl cuappl03a-r36a-32 Needs activation of ... 10:29:24
1.1 cuappl03a-r34a-40 is expected 10:29:24
We are done
If all affected software to fallback are the same as what was upgraded, proceed to
the next step.
Step 4 Perform the fallback to the previous installed software version. Use the command:
swu fallback all all
Expected printout:
Fallback check point created Tue May 29 09:42:50 CEST 2020 at upgrade
from enm001a-r34a-1 to enm001a-r35a-0
1.3 appl tuappl01a-r36a-30 Needs activation of ... 10:57:07
1.3 tuappl01a-r34a-39 is expected 10:57:07
1.5 boot tuboot02a-r36a-2 Needs activation of ... 10:57:07
1.5 tuboot02a-r34a-1 is expected 10:57:07
1.5 kernel oskernel02a-r36a-1 Needs activation of ... 10:57:07
1.5 oskernel02a-r34a-1 is expected 10:57:07
1.5 appl tuappl02a-r36a-30 Needs activation of ... 10:57:07
1.5 tuappl02a-r34a-39 is expected 10:57:07
1.1 boot cuboot02a-r35a-1 Needs activation of ... 10:57:08
1.1 cuboot02a-r32b-2 is expected 10:57:08
1.1 kernel oskernel02a-r36a-1 Needs activation of ... 10:57:08
1.1 oskernel02a-r34a-1 is expected 10:57:08
1.1 appl cuappl03a-r36a-32 Needs activation of ... 10:57:08
1.1 cuappl03a-r34a-40 is expected 10:57:08
1.1 '/etc/lumentis/cuappl03a-r34a-40' is not empty - no files copied
(this version might have been active before?)
1.3 appl tuappl01a-r34a-39 Activate done 10:57:27
1.5 boot tuboot02a-r34a-1 Activate done 10:57:31
1.5 kernel oskernel02a-r34a-1 Activate done 10:57:59
1.5 appl tuappl02a-r34a-39 Activate done 10:58:02
1.1 boot cuboot02a-r32b-2 Activate done 10:59:46
1.1 kernel oskernel02a-r34a-1 Activate done 11:00:01
1.1 appl cuappl03a-r34a-40 Activate done 11:00:03
1.1 '/etc/lumentis/cuappl03a-r34a-40' is not empty - no files copied
(this version might have been active before?)
We are done
Wait until all software are activated for each board.
Step 5 When the correctness of the activated application software is verified (compare to
the previous ‘.spec’ file) then a reboot of all boards are needed in order to set the
new software in use. Use the command:
swu reboot all
If there are alarms saying 'Interwork failed' then probably the SW is not
correctly installed. In this case please contact Infinera support.
Step 6 Log in to the node and check the active alarms. Note that it will be impossible to log
in to the node before it has started again, this could take 1-2 minutes. Compare with
the active alarms before the SW upgrade. Use the command:
activeAlarms
NOTE: After this fallback procedure has been executed, it cannot be used again to
return back to the newer SW release. A new upgrade procedure will be needed.
6 APPENDIX
6.1 FPGA revision history for boards supporting the
‘Postpone Firmware Activation’ function
Table 19 FPGA revision history for ‘Postpone Firmware Activation’ supported boards
To be able to upgrade to the latest software release the boards that are no longer supported
need to be deleted from the configuration before upgrading and a new backup saved. If the
node has several backup files, the unused backup files need to be deleted as well.
undefined behavior. Therefore it is important to remove those boards before upgrading a sys-
tem from R31.0.0, R31.1.0 or R31.1.2 to a higher release.
7 CONTACT INFORMATION
To get in contact with support personal at Infinera regarding upgrade, please use the contact
information below: