Automated Build / Rebuild (Customer) Instructions - SevOne Data Insight

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 SevOne Data Insight. 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 SevOne Data Insight recovery installation files.
    NOTE: For further details, please refer to the appendix 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.
    NOTE: For further details on boot media, please refer to the appendix below.

  2. Reset power on the server.

  3. When the option appears, press F11 to enter Boot Manager.

    Boot Manager

  4. In Boot Manager Main Menu, select One-shot BIOS Boot Menu.

    Boot Manager BIOS

  5. In Boot Menu, find and select the boot media (USB, DVD or SD card).

    Boot Manager Boot Media

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 Versa / Viptela collector (where applicable) and allow installation to complete.

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

  1. Select 'Install SevOne DataInsight v6.6.0'.

    Installer
    Choose Support option to Test this media & install SevOne DataInsight v6.6.0 and Troubleshooting.
    Support Installer
    Recover SevOne DataInsight v6.6.0 capability will be available in a future release.

  2. You will now be able to enter your company's network settings onto the appliance. Please refer to SevOne Data Insight Pre-Installation Guide > section Configure Network Settings for details.

Deploy Data Insight OVA & Configure Network Settings

Please refer to SevOne Data Insight Pre-Installation Guide for details.

Appendix - Obtain / Create Boot Media

In order to perform a rebuild installation, you must first have bootable media with the correct SevOne Data Insight recovery installation files.

If your SevOne Data Insight hardware shipped during or since August 2016, it should have included an inserted SD card for this purpose. If this is the case, and if you have not upgraded to a more recent version of Data Insight, 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. (Refer to the grid below for instructions by media type and OS.)

You will require the latest .iso file. For example, sdi-v6.6.0-build.139.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 - Download and run the free utility "Etcher". https://etcher.io/
- Click on Select image and choose the downloaded sdi-v6.6.0-build.139.iso file.
- Click on Flash!
- 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!
Mac Command Line diskutil $ diskutil list
/dev/disk0 (internal, physical):
 #:          TYPE  NAME     SIZE    IDENTIFIER
 0: GUID_partition_scheme          *121.3 GB  disk0
 1:           EFI  EFI       209.8 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=sdi-v6.6.0-build.139.iso of=/dev/rdisk[DISKNUMBER] bs=1m &
Tip: 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:

$ sudo dd if=sdi-v6.6.0-build.139.iso of=/dev/disk1 bs=2m
421+1 records in
421+1 records out
883949568 bytes transferred in 781.193450 secs
(1131537 bytes/sec)

$ sudo dd if=sdi-v6.6.0-build.139.iso of=/dev/rdisk1 bs=2m
421+1 records in
421+1 records out
883949568 bytes transferred in 144.064811 secs
(6135777 bytes/sec)
User Interface - Download and run the free utility "Etcher". https://etcher.io/
- Click on Select image and choose the downloaded sdi-v6.6.0-build.139.iso file.
- Click on Flash!
- 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!
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 $ sudo dd if=sdi-v6.6.0-build.139.iso of=/dev/YourUsbDevice & while $(kill -USR1 $!);do sleep 1;done
DVD Windows Right click sdi-v6.6.0-build.139.iso -> Burn Disc Image

OR

Right click sdi-v6.6.0-build.139.iso -> Open With... -> Windows Disc Image Burner
Mac Select the ISO file in Finder, and choose Burn Disk Image sdi-v6.6.0-build.139.iso to Disc... from the File menu.
Linux Right-click the ISO file and use Brasero or any other DVD writing utility.