UFiber GPON - How to Recover the UFiber OLT


Overview


In this article we will provide the necessary steps to recover the UFiber OLT. This process will completely restore the UF-OLT to factory default settings and erase all custom configuration.

NOTES & REQUIREMENTS: 
The recovery image is different than the OLT update firmware. The recovery images can be found on the UFiber download page.
 
Devices used in this article:

Table of Contents


  1. Console and Management Port Settings
  2. Connecting to Serial Console
  3. Setting up a TFTP Server
  4. Starting the Recovery Process
  5. Related Articles

Console and Management Port Settings


Back to Top

In rare cases when an OLT becomes unresponsive, these instructions may be suggested by our support team to recover the OLT back to its default state. This is typically not the first step in troubleshooting issues, but rather a last resort recovery method.

The default serial port settings are listed below:

  • Baud rate: 57600
  • Data bits: 8
  • Parity: NONE
  • Stop bits: 1
  • Flow control: NONE 

Connecting to Serial Console


Back to Top

topology.png

A USB-to-Serial adapter will be used to connect to the console port of the UFiber OLT.

NOTE: In order to connect to the console we will need to use the following items/programs:
  • RJ45 to DB9 serial console cable (rollover cable)
  • USB to DB9 adapter
  • Terminal emulation program, such as PuTTY or the macOS/Linux terminal

1. Open the terminal emulator and specify the serial COM line and the baud rate/speed.


   Windows Client


Enter the following information in the PuTTY window.

putty.png 


applelogo.png   macOS Client


Open Terminal Application and find the serial interface ID.

ls -ltr /dev/*usb*

The serial interface will display as tty. Example output below:

ls -ltr /dev/*usb*
crw-rw-rw-  1 root  wheel   21,   3 Feb  8 15:48 /dev/cu.usbserial-AI038TPF
crw-rw-rw-  1 root  wheel   21,   2 Feb  9 08:56 /dev/tty.usbserial-AI038TPF

Use the screen command to connect to console by pasting in the path to the serial interface.

screen /dev/tty.usbserial-AI038TPF 57600
ATTENTION: Replace /dev/tty.usbserial-AI038TPF with the value given when using the ls -ltr /dev/*usb* command.

2. Connect to the OLT management port with a separate Ethernet cable.

3. Assign a static IP address to your computer's network interface, for example 192.168.1.10/24.

4. Leave the console window opened and both cables plugged in while continuing on to the next section.


Setting up a TFTP Server


Back to Top

The next step is to set up a TFTP server on the workstation to allow the UFiber OLT to boot from TFTP.

1. Download the latest OLT recovery file from the UFiber Downloads page here.

2. Install a TFTP server. 


   Windows Client


In this example we are using Tftpd32 as the TFTP server.


applelogo.png   macOS Client


 Open a new terminal window to load and start the TFTP service.

sudo launchctl load -F /System/Library/LaunchDaemons/tftp.plist 
sudo launchctl start com.apple.tftpd

Change the file permissions for the TFTP folder.

sudo chmod 777 /private/tftpboot
sudo chmod 777 /private/tftpboot/*

2. Place the OLT recovery file in the base TFTP directory.


Starting the Recovery Process


Back to Top

CLI: Access the UFiber OLT Command Line using the console connection.

1. Log in using your credentials. 

2. Reboot the UFiber OLT.

reboot

3. Hold down the 1 (number one) key as the OLT reboots.

4. When holding the 1 key, the bootloader will be interrupted and bring you to a prompt similar to the one below.

Please choose the operation: 
1: Load system code to SDRAM via TFTP.
2: Load system code then write to Flash via TFTP.
3: Boot system code via Flash (default).
4: Entr boot command line interface.
7: Load Boot Loader code then write to Flash via Serial.
9: Load Boot Loader code then write to Flash via TFTP.
default: 3

5. Select option 1 and enter the required IP address and filename recovery information.

  • Device IPThis is the IP address that the OLT should use for the TFTP session.
  • Server IPThis is the IP address of the TFTP server (computer).
  • Linux Kernel FilenameExact name of the OLT recovery image in the base TFTP directory.

An example output is: 

1: System Load Linux to SDRAM via TFTP. 
Please Input new ones /or Ctrl-C to discard
Input device IP (172.16.3.211) ==:192.168.1.1
Input server IP (172.16.3.210) ==:192.168.1.11
Input Linux Kernel filename (vme600) ==:OLT.recovery.1.1.0.5055308.180122.0341.ed83a5d40.img

After entering the recovery image file name and pressing the enter key, the OLT will scroll though showing the # symbol many times as it it loads the file to the OLT. This is expected behavior.

Next the OLT will the remove and re-install the image, then reboot. As this occurs, you may also notice the fans spinning at full speed until the process completes.

6. A successful recovery will allow management access by logging in via the web UI or CLI using the default 192.168.1.1 IP address.


Related Articles


Back to Top

UFiber GPON - Getting Started


We're sorry to hear that!