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.

            

            
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.

            

            
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".

   

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

   

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

   

6. Wait for Rufus to finish.

7. Unplug the USB device.

Linux

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

   Important

   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).

   Warning

   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".

   

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

   

   A new window will open.

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

   

   

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

   

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

   

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"

   

   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.

   

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

   

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".

    

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

    

    Important

    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.

    

    

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.
    

    

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