Creating a USB Key for Installing TufinOS On An Appliance

Overview

In order to install TufinOS on a Tufin appliance, you must boot from a USB key that has the TufinOS image on it.

Prerequisites

  • An empty USB flash drive with at least 32GB of space.

Download The TufinOS Image File

You need to download the TufinOS Image file from the download center. You can download it to your local computer or directly to the server using a link. If you download directly to the server make sure the server has permissions to download from https://tosportaldownloads.tufin.com.

  1. Go to the Download Center, click on TufinOS 4.40, and choose how you want to download the installation package:

    • Download to Computer

    • Copy link (valid for 10m)

  2. If you chose to copy a link, run the following command:

  3. curl -o [Name the file].run.gz  “<LINK>”
    curl -o [Name the file].run.gz  “<LINK>”

    Where <LINK> is the link you copied from the Download Center.

  4. Otherwise, copy the compressed image from your local computer to the server.

  5. Extract the run file from the archive.

    [<ADMIN> ~]$ sudo tar xzvf TufinOS-X.XX-XXXXXX-x86_64-Final.usb.img.tgz
    sudo tar xzvf TufinOS-X.XX-XXXXXX-x86_64-Final.usb.img.tgz

    The run file name includes the release, version, and build number.

    For example: TufinOS-4.40-4368238-x86_64-Final.usb.img

    After decompression, you will have two files - the main .img file and a .sha256 checksum file.

  6. Verify the integrity of the TufinOS image using the checksum file:

    [<ADMIN> ~]# sha256sum -c TufinOS-X.XX-XXXXXX-x86_64-XXXX-Final.usb.iso.sha256
    sha256sum -c TufinOS-X.XX-XXXXXX-x86_64-XXXX-Final.usb.iso.sha256

    The output should return OK.

Prepare the USB Key

  1. Connect the USB flash drive to the Linux server.

  2. Run the command:

    dmesg | tail
    dmesg | tail
  3. At the end of the output of this command you will find the USB drive device name. Usually it is /dev/sdb, or /dev/sdc. Copy that name.

  4. Erase the USB flash drive before burning the TufinOS image to the USB flash drive:

    dd if=/dev/zero of=/dev/<usb flash drive device name> bs=512
    dd if=/dev/zero of=/dev/<usb flash drive device name> bs=512
  5. Burn only the decompressed TufinOS image file to the USB flash drive:

    dd if=TufinOS-X.XX-XXXXXX-x86_64-Final.usb.img of=/dev/<usb flash drive device name> bs=512
    dd if=TufinOS-X.XX-XXXXXX-x86_64-Final.usb.img of=/dev/<usb flash drive device name> bs=512

    Where <usb flash drive device name> is the name copied in previous step. This step may take a while; about 60 seconds or less.

  6. Flush the data to the disk to make sure that all data is copied correctly.

    sync ; sync
    sync ; sync
  7. Remove the USB key from the machine.

After TufinOS is installed, you can transfer the TOS installation file to the appliance and install it.