Automated Build / Rebuild (Customer) Instructions - SD-WAN Viptela

Edit online

About

Edit online

This document provides customer instructions for building / rebuilding SD-WAN. It will NOT restore any lost data.

Warning: This process can help recover a lost cluster node, but it will not recover any lost data.

Prerequisites/Assumptions

Edit online
  • Customer has obtained or created on boot media (USB, DVD, etc.) with the required SD-WAN recovery installation files. NOTE: For further details, see the appendix on boot media.
  • Customer must have physical access to the console of the target SevOne PAS hardware and a minimum USB stick size of 8GB.
  • Customer knows the required network settings to be installed:
    • Hostname
    • The network interface which should be used (e.g. eth0)
    • IP Address, in dotted decimal notation (e.g. 10.10.10.30)
    • Netmask, in dotted decimal notation (e.g. 255.255.255.0)
    • Broadcast address, in dotted decimal notation (e.g. 10.10.10.255)
    • Default Gateway, in dotted decimal notation (e.g. 10.10.10.1)

Installation

Edit online

using ISO

Edit online
  1. Insert boot media (or verify that SD card is present) with recovery installation files. (See Appendix section for boot media details.)
  2. Reset power on the server.
  3. When the option appears, press F11 to enter Boot Manager.
    System Setup
  4. In Boot Manager Main Menu, select One-shot BIOS Boot Menu.
    Boot Manager
  5. In Boot Menu, find and select the boot media (USB, DVD or SD card).
    Boot Manager 1

using ISO with iDRAC

Edit online
Important: If the connection from the iDRAC to the hardware appliance is poor, loading files on the virtual media may suffer. For this case, a direct connection to the appliance is recommended.
  1. The latest ISO file can be downloaded from IBM Passport Advantage ( https://www.ibm.com/software/passportadvantage/pao_download_software.html ) via Passport Advantage Online . However, if you are on a legacy / flexible SevOne contract and do not have access to IBM Passport Advantage but have an active Support contract, please contact IBM SevOne Support for the file.
  2. Logon to iDRAC.
  3. Click the window for the virtual console on the lower-right corner to open the virtual console.
  4. Click Virtual Media button.
  5. Click Connect Virtual Media button.
  6. Under Map CD/DVD, click Choose File button and select the ISO file obtained from IBM Passport Advantage via Passport Advantage Online or IBM SevOne Support.
  7. Click Map Device button.
  8. Click Close button.
  9. Click Boot button and select Virtual CD/DVD/ISO.
  10. Click Yes button.
  11. Click Power button and then, click Power On System or Power Cycle System (cold boot) if the system was already on, click the Yes button if prompted.
  12. Install from the boot menu for Viptela collector and allow installation to complete.

After installing using ISO or using ISO with iDRAC, perform the steps below.

  1. Select 'Install SevOne-v7.0.0-build.<###>'.
    Viptela 70 ISO 1
    Note: Choose Troubleshooting option to Install SevOne-v7.0.0-build.<###> in basic graphics mode, Rescue a RHEL system, Run a memory test, and Boot from local drive.
    Viptela 70 ISO 2
  2. You will now be able to enter your company's network settings onto the appliance. Please refer to SD-WAN Viptela Collector Pre-Deployment Guide > section Configure Network Settings for details.

Appendix - Obtain/Create Boot Media

Edit online

In order to perform a rebuild installation, you must first have bootable media with the correct SD-WAN recovery installation files.

Your SD-WAN hardware for Viptela collector must have an inserted SD card included for this purpose. If this is the case, and if you have not upgraded to a more recent version of the collector, you can skip the rest of this appendix and start the Installation Steps using that SD card as your bootable media.

Otherwise, you must download a recovery installation ISO and use it to build boot media…

  1. Contact IBM SevOne support and request a download link.
  2. When you receive your download link, click it and download the ISO file. (NOTE: Download links expire and must be used within 24 hours of sending.)
  3. Create bootable media from this ISO. (See grid below for instructions by media type and OS.)
Important: You will require the latest .iso file. For example, sevone_solutions_sdwan_viptela-v7.0.0-build.<###>.iso file. Please obtain the latest file from IBM Passport Advantage via Passport Advantage Online or IBM SevOne Support
Medium OS How to create bootable from ISO...
USB Windows
  1. Download and run the free utility "Etcher". https://etcher.io/
  2. Click on Select image and choose the downloaded sevone_solutions_sdwan_viptela-v7.0.0-build.<###>.iso file.
  3. Click on Flash!
  4. When done, you will get a message Flash Complete!
Warning: Make sure you select the right device from the device drop down. If you select the wrong device, you can destroy data on other plugged in USB drives!
USB Mac (Command Line) diskutil and dd
diskutil

$ diskutil list
/dev/disk0 (internal, physical):
   #:                   TYPE  NAME          SIZE      IDENTIFIER
   0:  GUID_partition_scheme               *121.3 GB  disk0
   1:                    EFI  EFI           209.7 MB  disk0s1
   2:              Apple_HFS  Macintosh HD  120.5 GB  disk0s2
   3:             Apple_Boot  Recovery HD   650.0 MB  disk0s3
  
/dev/disk1 (external, physical):
   #:                   TYPE  NAME          SIZE      IDENTIFIER
   0:                         NONAME       *8.0 GB    disk1
  
$ diskutil unmountDisk /dev/disk1
 Unmount of all volumes on disk1 was successful
Warning: Do not destroy your OS!
Make sure you get the right device from diskutil list. If you enter the wrong device you can destroy your Operating System (macOS)!
dd
sudo dd if=sevone_solutions_sdwan_viptela-v7.0.0-build.<###>.iso of=/dev/rdisk[DISKNUMBER] bs=1m &
Raw paths!
If your disk is located at /dev/disk2, make sure you use of=/dev/rdisk2.

/dev/disk# is buffered, requiring extra processing when writing (extra
validations)
/dev/rdisk# is raw, which allows for much faster writing (this is okay
when doing a raw block-level copy using dd).
The difference is very noticeable. Testing with a linux iso gave over 5x
performance improvement:
sevoneuser@mac$ sudo dd if=sevone_solutions_sdwan_viptela-v7.0.0-build.<###>.iso of=/dev/disk1 bs=2m
421+1 records in
421+1 records out
883949568 bytes transferred in 781.193450 secs 
(1131537 bytes/sec)
sevoneuser@mac$ sudo dd if=sevone_solutions_sdwan_viptela-v7.0.0-build.<###>.iso of=/dev/rdisk1 bs=2m
421+1 records in
421+1 records out
883949568 bytes transferred in 144.064811 secs 
(6135777 bytes/sec)
USB Mac (User Interface)
  1. Download and run the free utility "Etcher". https://etcher.io/
  2. Click on Select image and choose the downloaded sevone_solutions_sdwan_viptela-v7.0.0-build.<###>.iso file.
  3. Click on Flash!
  4. When done, you will get a message Flash Complete!
Warning: Make sure you select the right device from the device drop down. If you select the wrong device, you can destroy data on other plugged in USB drives!
USB Linux Use Startup Disk Creator, Disks, Disk Utility, or dd
Warning: Make sure you get the right device from dmesg. If you enter the wrong device you can destroy your Operating System (OS)!
dd
dd if=sevone_solutions_sdwan_viptela-v7.0.0-build.<###>.iso of=/dev/YourUsbDevice &
while $(kill -USR1 $!);do sleep 1;done
DVD Windows Right click sevone_solutions_sdwan_viptela-v7.0.0-build.<###>.iso -> Burn Disc ImageORRight click sevone_solutions_sdwan_viptela-v7.0.0-build.<###>.iso -> Open With... -> Windows Disc Image Burner
DVD Mac Select the ISO file in Finder, and choose "Burn Disk Image sevone_solutions_sdwan_viptela-v7.0.0-build.<###>.iso to Disc..." from the File menu.
DVD Linux Right-click the ISO file and use Brasero or any other DVD writing utility.