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

SevOne Documentation

All documentation is available from the IBM SevOne Support customer portal.

© Copyright International Business Machines Corporation 2023.

All right, title, and interest in and to the software and documentation are and shall remain the exclusive property of IBM and its respective licensors. No part of this document may be reproduced by any means nor modified, decompiled, disassembled, published or distributed, in whole or in part, or translated to any electronic medium or other means without the written consent of IBM.

IN NO EVENT SHALL IBM, ITS SUPPLIERS, NOR ITS LICENSORS BE LIABLE FOR ANY DAMAGES, WHETHER ARISING IN TORT, CONTRACT OR ANY OTHER LEGAL THEORY EVEN IF IBM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, AND IBM DISCLAIMS ALL WARRANTIES, CONDITIONS OR OTHER TERMS, EXPRESS OR IMPLIED, STATUTORY OR OTHERWISE, ON SOFTWARE AND DOCUMENTATION FURNISHED HEREUNDER INCLUDING WITHOUT LIMITATION THE WARRANTIES OF DESIGN, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.

IBM, the IBM logo, and SevOne are trademarks or registered trademarks of International Business Machines Corporation, in the United States and/or other countries. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on ibm.com/trademark.

About

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

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

Prerequisites/Assumptions

  • 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

using ISO

  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

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-v6.6.0-build.28'.

    Viptela 66 ISO 1
    Choose Troubleshooting option to Install SevOne-v6.6.0-build.28 in basic graphics mode, Rescue a CentOS system, Run a memory test, and Boot from local drive.
    Viptela 66 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.

Deploy SD-WAN OVA & Configure Network Settings

Please refer to SD-WAN Viptela Collector Pre-Deployment Guide for details.

Appendix - Obtain/Create Boot Media

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.)
You will require the latest .iso file. For example, sevone_solutions_sdwan_viptela-v6.6.0-build.28.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-v6.6.0-build.28.iso file.
  3. Click on Flash!
  4. When done, you will get a message Flash Complete!

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
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-v6.6.0-build.28.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-v6.6.0-build.28.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-v6.6.0-build.28.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-v6.6.0-build.28.iso file.
  3. Click on Flash!
  4. When done, you will get a message Flash Complete!

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
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-v6.6.0-build.28.iso of=/dev/YourUsbDevice &
while $(kill -USR1 $!);do sleep 1;done
DVD Windows Right click sevone_solutions_sdwan_viptela-v6.6.0-build.28.iso -> Burn Disc Image
OR
Right click sevone_solutions_sdwan_viptela-v6.6.0-build.28.iso -> Open With... -> Windows Disc Image Burner
DVD Mac Select the ISO file in Finder, and choose "Burn Disk Image sevone_solutions_sdwan_viptela-v6.6.0-build.28.iso to Disc..." from the File menu.
DVD Linux Right-click the ISO file and use Brasero or any other DVD writing utility.