NVIDIA UFM Cyber-AI Documentation v2.9.0
NVIDIA UFM-SDN Appliance Command Reference Guide v4.17.0

Appendix - Deploying UFM Cyber-AI from an ISO File

This section provides a step-by-step guide for deploying Cyber-AI from an ISO file.

Extract the ufm-cyberai-appliance-<version>-omu.tar file to a temporary directory.

Extract TAR file

Copy
Copied!
            

tar xzf /path/to/ufm-cyberai-appliance-<version>-omu.tar -C /tmp

There is both an ISO file and an upgrade script located in the directory.

Extract TAR file

Copy
Copied!
            

ls -ltrh /tmp/ufm-cyberai-appliance-<version>-omu/ -rw-r--r-- 1 root root 7.5G Dec 31 17:49 ufm-cyberai-appliance-<version>.iso -rwxr-xr-x 1 root root 11K Dec 31 17:49 ufm-os-upgrade.sh

To burn the ISO onto a USB device, you can use either a Windows or Linux operating system. Follow the instructions below depending on your preferred installation method.

Windows

  1. Download and open Rufus. Refer to Rufus - Create bootable USB drives the easy way.

  2. Download and open the tar file ufm-cyberai-appliance-<version>-omu.tar.

  3. Click on "SELECT" and from the drop-down menu, select the ufm-cyberai-appliance-<version>.iso, then click "START".

    iso-deployment1-version-1-modificationdate-1723648301663-api-v2.JPG

  4. When the "ISOHybrid image detected" message appears, select "Write in DD mode" and then click "OK".

    iso-deployment2-version-1-modificationdate-1723648302227-api-v2.png

  5. You will see a message indicating that all data on the USB device will be erased. Click "OK and continue" to proceed.

    iso-deployment3-version-1-modificationdate-1723648302743-api-v2.png

  6. Wait for Rufus to finish.

  7. Unplug the USB device.

Linux

  1. Identify the USB drive by running the following command:

    Warning

    IMPORTANT!!! Ensure you are NOT running the following commands on a hard drive device but only on the USB (in the examples below it will be /dev/sdb).

    Note

    The USB drive is mapped to sdb in the following command snippet.

    Copy
    Copied!
                

    root@ubuntu18:~# ls -ltrh /dev/disk/by-id/usb* lrwxrwxrwx 1 root root 9 Jan 2 13:44 /dev/disk/by-id/usb-SanDisk_Cruzer_Glide_3.0_4C530000040724111091-0:0 -> ../../sdb lrwxrwxrwx 1 root root 10 Jan 2 13:44 /dev/disk/by-id/usb-SanDisk_Cruzer_Glide_3.0_4C530000040724111091-0:0-part1 -> ../../sdb1

  2. Copy the ufm-cyberai-appliance-<version>.iso to the USB using the following dd command:

    Copy
    Copied!
                

    dd if=/path/to/ufm-cyberai-appliance-<version>.iso of=/dev/sdb bs=4M status=progress oflag=sync

  3. Verify that the USB is bootable:

    Copy
    Copied!
                

    root@ubuntu18:~# fdisk -l /dev/sdb Disk /dev/sdb: 14.9 GiB, 16005464064 bytes, 31260672 sectors Units: sectors of 1 * 512 = 512 bytes Sector size (logical/physical): 512 bytes / 512 bytes I/O size (minimum/optimal): 512 bytes / 512 bytes Disklabel type: dos Disk identifier: 0x594ec03e   Device Boot Start End Sectors Size Id Type /dev/sdb1 * 64 15679439 15679376 7.5G 17 Hidden HPFS/NTFS

  4. Unplug the USB.

  1. Plug the USB (prepared in the previous step) to one of the Cyber-AI server USB ports on its rear panel.

  2. Log in to BMC web UI: https://<BMC_IP_ADDRESS>.

  3. Navigate to "Remote Control" → "Server Power Control" and check the "Force-enter BIOS Setup" checkbox under the "Restart Server". Then, click "Perform Action".

    iso-deployment4-version-1-modificationdate-1723648303467-api-v2.png

  4. Navigate to "Remote Control" → "iKVM over HTML5" and click "Launch iKVM over HTML5" button.

    iso-deployment5-version-1-modificationdate-1723648304177-api-v2.png

    A new window will open.

  5. In the BIOS menu, navigate to BOOT → "Boot Option #1" and check "USB Device:<NAME OF USB DEVICE>".

    iso-deployment6-version-1-modificationdate-1723648304797-api-v2.png

    iso-deployment7-version-1-modificationdate-1723648305320-api-v2.png

  6. Navigate to "Save & Exit" → "Save Changes and Reset" and press enter.

    iso-deployment8-version-1-modificationdate-1723648305857-api-v2.png

  7. At this point Cyber-AI installation should start automatically.

    iso-deployment9-version-1-modificationdate-1723648306303-api-v2.png

  8. The process takes ~50 minutes, "Running preseed..." will show ~14-16 percent and will remain on this percentage for most of the time. This does not mean that the process is stuck.

    The preseed file runs in the background and will take ~35-40 minutes to complete.

    a log can be viewed by switching to tty4 by click on "Virtual Media" → "Virtual Keyboard"

    iso-deployment10-version-1-modificationdate-1723648306700-api-v2.png

    On the virtual keyboard that appears, press ALT+F4 (do this on the virtual keyboard to switch to tty4, otherwise the window will close).

  9. When the OS installation is complete (if still on tty1 (purple screen)) the screen will be black and a "Sent SIGKILL to all processes" message will appear.

    iso-deployment11-version-1-modificationdate-1723648307313-api-v2.png

    On the tty4 (log screen), a messages with "finish-install:" will appear.

    iso-deployment12-version-1-modificationdate-1723648307790-api-v2.png

  10. At this point, remove the USB from the Cyber-AI server (or reboot to BIOS as seen in step #3 and change the "Boot option #1" which was set to USB earlier to "disabled".

  11. Reboot the server. Click the "Power Control" menu and select "Power Reset".

    iso-deployment13-version-1-modificationdate-1723648308160-api-v2.png

  12. After the server boots up a login screen will appear.

    iso-deployment14-version-1-modificationdate-1723648308780-api-v2.png

    Warning

    You can now log in to the server, however, the installation is not finished yet and Cyber-AI cannot be started.

  13. Additional software installation is triggered on the server's first boot. Once complete, a message will appear on all the connected terminals "UFM-OS-FIRSTBOOT-SUCCESS" in case of success, and FAILED in case the process failed.

    iso-deployment15-version-1-modificationdate-1723648309127-api-v2.png

    iso-deployment16-version-1-modificationdate-1723648309580-api-v2.png

  14. To manually check the status, run:

    Copy
    Copied!
                

    systemctl status ufm-os-firstboot

    if the installation is still running, the output provides a status.

    if the installation finished, ufm-os-firstboot will not be found and the log at /var/log/ufm-os-firstboot.log can be viewed.

    iso-deployment17-version-1-modificationdate-1723648310943-api-v2.png

  15. Cyber-AI is now successfully installed and can be started.

© Copyright 2024, NVIDIA. Last updated on Aug 14, 2024.