Appendix - Cyber-AI Appliance OS Remanufacture
On This Page
This section provides a step-by-step guide for deploying Cyber-AI (CAI) from an ISO file in case of unrecoverable issues. This guide provides instructions on how to remanufacture the Cyber-AI appliance and OS.
Run the following command to extract the ufm-cyberai-appliance-<version>-omu.tar to a temporary directory:
An ISO file and an upgrade script will be present inside 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
Burning ISO can be performed on Windows or Linux operating systems. Based on the desired installation method, follow the below instructions.
Download and open Rufus. Refer to Rufus - Create bootable USB drives the easy way.
Download and open the tar file ufm-cyberai-appliance-<version>-omu.tar.
On Rufus, click on "SELECT" and from the drop-down menu, select the ufm-cyberai-appliance-<version>.iso, then click "START".
An "isohybrid image detected" message will pop up. Choose "Write in DD mode" and click "OK".
A message will appear stating that all data on the usb device will be lost, click "OK and continue".
Wait for Rufus to finish.
Unplug the USB device.
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.
# 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
Copy the ufm-cyberai-appliance-<version>.iso to the USB using the following dd command:Warning
The USB drive is mapped to /dev/sdb.
if=/path/to/ufm-cyberai-appliance-<version>.iso of=/dev/sdb bs=4M status=progress oflag=
Verify that the USB is bootable:
# fdisk -l /dev/sdbDisk /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
Unplug the USB.
Plug the USB (prepared in the previous step) to one of the Cyber-AI server back USB ports.
Login to BMC web UI: https://<BMC_IP_ADDRESS>.
Navigate to "Remote Control" → "Server Power Control" and check the "Force-enter BIOS Setup" checkbox under the "Restart Server". Then, click "Perform Action".
Navigate to "Remote Control" → "iKVM over HTML5" and click "Launch iKVM over HTML5" button.
A new window will open.
In the BIOS menu, navigate to BOOT → "Boot Option #1" and check "USB Device:<NAME OF USB DEVICE>".
Navigate to "Save & Exit" → "Save Changes and Reset" and press enter.
At this point Cyber-AI installation should start automatically.
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).
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.
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".
Reboot the server. Click the "Power Control" menu and select "Power Reset".
After the server boots up a login screen will appear.
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.
To manually check the status, run:
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.
Cyber-AI is now successfully installed and can be started.