Skip to main content
Cluster and storage switches

Install the EFOS software

Contributors netapp-maireadn netapp-yvonneo

Follow these steps to install the Ethernet Fabric OS (EFOS) software on the BES-53248 cluster switch.

EFOS software includes a set of advanced networking features and protocols for developing Ethernet and IP infrastructure systems. This software architecture is suitable for any network organizational device using applications that require thorough packet inspection or separation.

Prepare for installation

Before you begin

Install the software

Use one of the following methods to install the EFOS software:

Method 1: Install EFOS

Perform the following steps to install the EFOS software.

Steps
  1. Log in to the switch serial console port or connect with SSH.

  2. Use the ping command to verify connectivity to the server hosting EFOS, licenses, and the RCF file.

    Show example

    This example verifies that the switch is connected to the server at IP address 172.19.2.1:

    (cs2)# ping 172.19.2.1
    Pinging 172.19.2.1 with 0 bytes of data:
    
    Reply From 172.19.2.1: icmp_seq = 0. time= 5910 usec.
  3. Download the image file to the switch.

    Check the following table for information on supported copy protocols:

    Protocol

    Prerequisite

    Trivial File Transfer Protocol (TFTP)

    None

    SSH File Transfer Protocol (SFTP)

    Your software package must support secure management

    FTP

    Password required

    XMODEM

    None

    YMODEM

    None

    ZMODEM

    None

    Secure Copy Protocol (SCP)

    Your software package must support secure management

    HTTP

    CLI-based file transfers supported on selected platforms when a native WGET utility is available

    HTTPS

    CLI-based file transfers supported on selected platforms when a native WGET utility is available

    Copying the image file to the active image means that when you reboot, that image establishes the running EFOS version. The previous image remains available as a backup.

    Show example
    (cs2)# copy sftp://root@172.19.2.1//tmp/EFOS-3.10.0.3.stk active
    Remote Password:**
    
    Mode........................................... SFTP
    Set Server IP.................................. 172.19.2.1
    Path........................................... //tmp/
    Filename....................................... EFOS-3.10.0.3.stk
    Data Type...................................... Code
    Destination Filename........................... active
    
    Management access will be blocked for the duration of the transfer
    Are you sure you want to start? (y/n) y
    SFTP Code transfer starting...
    
    
    File transfer operation completed successfully.
  4. Display the boot images for the active and backup configuration:

    show bootvar

    Show example
    (cs2)# show bootvar
    
    Image Descriptions
    
     active :
     backup :
    
     Images currently available on Flash
    --------------------------------------------------------------------
     unit      active      backup      current-active    next-active
    --------------------------------------------------------------------
        1      3.7.0.4     3.7.0.4     3.7.0.4           3.10.0.3
  5. Reboot the switch:

    reload

    Show example
    (cs2)# reload
    
    The system has unsaved changes.
    Would you like to save them now? (y/n) y
    
    Config file 'startup-config' created successfully .
    Configuration Saved!
    System will now restart!
  6. Log in again and verify the new version of the EFOS software:

    show version

    Show example
    (cs2)# show version
    
    Switch: 1
    
    System Description............................. BES-53248A1, 3.10.0.3, Linux 4.4.211-28a6fe76, 2016.05.00.04
    Machine Type................................... BES-53248A1,
    Machine Model.................................. BES-53248
    Serial Number.................................. QTFCU38260023
    Maintenance Level.............................. A
    Manufacturer................................... 0xbc00
    Burned In MAC Address.......................... D8:C4:97:71:0F:40
    Software Version............................... 3.10.0.3
    Operating System............................... Linux 4.4.211-28a6fe76
    Network Processing Device...................... BCM56873_A0
    CPLD Version................................... 0xff040c03
    
    Additional Packages............................ BGP-4
    ...............................................	QOS
    ...............................................	Multicast
    ............................................... IPv6
    ............................................... Routing
    ............................................... Data Center
    ............................................... OpEN API
    ............................................... Prototype Open API
  7. Complete the installation. Follow these five steps to reconfigure the switch:

  8. Repeat steps 1 to 7 on the partner switch.

Method 2: Install EFOS in ONIE mode

You can perform the following steps if one EFOS version is FIPS compliant and the other EFOS version is non-FIPS compliant. These steps can be used to install the non-FIPS or FIPS compliant EFOS 3.7.x.x image from ONIE if the switch fails to boot.

Steps
  1. Connect to a console that is attached to the serial port of the switch.

  2. Boot the switch into ONIE installation mode.

    During boot, select ONIE when you see the prompt.

    Show example
    +--------------------------------------------------------------------+
    |EFOS                                                                |
    |*ONIE                                                               |
    |                                                                    |
    |                                                                    |
    |                                                                    |
    |                                                                    |
    |                                                                    |
    |                                                                    |
    |                                                                    |
    |                                                                    |
    |                                                                    |
    |                                                                    |
    +--------------------------------------------------------------------+

    After you select ONIE, the switch loads and presents you with several choices. Select Install OS.

    Show example
    +--------------------------------------------------------------------+
    |*ONIE: Install OS                                                   |
    | ONIE: Rescue                                                       |
    | ONIE: Uninstall OS                                                 |
    | ONIE: Update ONIE                                                  |
    | ONIE: Embed ONIE                                                   |
    | DIAG: Diagnostic Mode                                              |
    | DIAG: Burn-In Mode                                                 |
    |                                                                    |
    |                                                                    |
    |                                                                    |
    |                                                                    |
    |                                                                    |
    +--------------------------------------------------------------------+

    The switch boots into ONIE installation mode.

  3. Stop the ONIE discovery and configure the Ethernet interface.

    When the following message appears, press Enter to invoke the ONIE console:

    Please press Enter to activate this console. Info: eth0:  Checking link... up.
     ONIE:/ #
    Note The ONIE discovery continues and messages are printed to the console.
    Stop the ONIE discovery
    ONIE:/ # onie-discovery-stop
    discover: installer mode detected.
    Stopping: discover... done.
    ONIE:/ #
  4. Configure the Ethernet interface of the switch management port and add the route using ifconfig eth0 <ipAddress> netmask <netmask> up and route add default gw <gatewayAddress>

    ONIE:/ # ifconfig eth0 10.10.10.10 netmask 255.255.255.0 up
    ONIE:/ # route add default gw 10.10.10.1
  5. Verify that the server hosting the ONIE installation file is reachable:

    ping

    Show example
    ONIE:/ # ping 50.50.50.50
    PING 50.50.50.50 (50.50.50.50): 56 data bytes
    64 bytes from 50.50.50.50: seq=0 ttl=255 time=0.429 ms
    64 bytes from 50.50.50.50: seq=1 ttl=255 time=0.595 ms
    64 bytes from 50.50.50.50: seq=2 ttl=255 time=0.369 ms
    ^C
    --- 50.50.50.50 ping statistics ---
    3 packets transmitted, 3 packets received, 0% packet loss
    round-trip min/avg/max = 0.369/0.464/0.595 ms
    ONIE:/ #
  6. Install the new switch software:

    Show example
    ONIE:/ # onie-nos-install http://50.50.50.50/Software/onie-installer-x86_64
    discover: installer mode detected.
    Stopping: discover... done.
    Info: Fetching http://50.50.50.50/Software/onie-installer-3.7.0.4 ...
    Connecting to 50.50.50.50 (50.50.50.50:80)
    installer            100% |*******************************| 48841k  0:00:00 ETA
    ONIE: Executing installer: http://50.50.50.50/Software/onie-installer-3.7.0.4
    Verifying image checksum ... OK.
    Preparing image archive ... OK.

    The software installs and then reboots the switch. Let the switch reboot normally into the new EFOS version.

  7. Log in and verify that the new switch software is installed:

    show bootvar

    Show example
    (cs2)# show bootvar
    Image Descriptions
    active :
    backup :
    Images currently available on Flash
    ---- 	----------- -------- --------------- ------------
    unit 	active 	    backup   current-active  next-active
    ---- 	----------- -------- --------------- ------------
     1      3.7.0.4     3.7.0.4    3.7.0.4        3.10.0.3
    (cs2) #
  8. Complete the installation. The switch reboots with no configuration applied and resets to factory defaults. Follow these six steps to reconfigure the switch:

  9. Repeat steps 1 to 8 on the partner switch.