Using BaseOS with BMC (Remote Media)

IGX BMC has the support of USB remote media based on openbmc virtual media - docs/designs/virtual-media.md at master · openbmc/docs · GitHub

The IGX Developer Kit BMC enumerates USB virtual media devices to the Orin USB host, which helps to install BaseOS using the UEFI menu. IGX BMC can work as virtual media over CIFS transfer protocol.

CIFS samba server configuration in Ubuntu Desktop.

Install SAMBA and configure it on the Ubuntu Desktop. Place BaseOS into the SAMBA server path to initiate the BMC virtual media for the BaseOS image:

Copy
Copied!

            
            sudo apt update

Copy
Copied!

            
            sudo apt install samba

Now that Samba is installed, we need to create a directory for it to share.

Copy
Copied!

            
            mkdir /home/<username>/sambashare/

Add samba configuration for sambashare directory

Copy
Copied!

            
            sudo vim /etc/samba/smb.conf

Add block to samba configuration to end of the smb.conf

Copy
Copied!

            
            [sambashare]
  comment = Samba on Ubuntu
  path = /home/username/sambashare
  read only = no
  browsable = yes

Update firewall settings and restart the samba service

Copy
Copied!

            
            sudo ufw allow samba

Copy
Copied!

            
            sudo service smbd restart

Set up user and password

Copy
Copied!

            
            sudo smbpasswd -a username

Enumerate BMC USB Virtual Media

Get the BaseOS release and copy the BaseOS image to the sambashare folder.

Copy
Copied!

            
            cp <BaseOS image> /home/username/sambashare/

Provide the BMC username and password to get the token.

Copy
Copied!

            
            export bmc=<BMC IP>

Copy
Copied!

            
            export token=`curl -k -H "Content-Type: application/json" -X POST https://${bmc}/login -d '{"username" : "<BMC Username>", "password" : "<BMC Passowrd>"}' | grep token | awk '{print $2;}' | tr -d '"'`

Fill the Samba username, password, and BaseOS file to enumerate the USB virtual media using the Redfish.

Copy
Copied!

            
            curl -k -H Content-Type:application/json -H "X-Auth-Token:$token" -X POST https://${bmc}/redfish/v1/Managers/IGX_BMC_0/VirtualMedia/USB1/Actions/VirtualMedia.InsertMedia -d '{"Image":"smb://<Ubuntu Desktop IP>/sambashare/<BaseOS filename>","WriteProtected":true,"UserName":"<SAMBA Username>","Password":"<SAMBA Password>","Inserted":true,"TransferMethod":"Stream","TransferProtocolType":"CIFS"}'

Copy
Copied!

            
            Ex: curl -k -H Content-Type:application/json -H "X-Auth-Token:$token" -X POST https://${bmc}/redfish/v1/Managers/IGX_BMC_0/VirtualMedia/USB1/Actions/VirtualMedia.InsertMedia -d '{"Image":"smb://192.168.1.1/sambashare/IGX-r36v0.1-2023-10-04-12-32-47.iso","WriteProtected":true,"UserName":"nvidia","Password":"nvidia","Inserted":true,"TransferMethod":"Stream","TransferProtocolType":"CIFS"}'

Confirm the USB Virtual Media entry in the Orin host lsusb.

Install BaseOS from UEFI
1. Reboot the Orin, wait until UEFI starts, then press ESC to enter the UEFI menu
2. Select the Boot Manager with the down arrow(↓) key. USB Virtual media will be seen on the menu.
3. Select the UEFI 0penBMC Virtual Media, and install the BaseOS, or edit options using the ‘e’ key before installation.
4. Eject current media using the below command if want to mount a new ISO
  Copy
  
  Copied!
```
            
            curl -k -H Content-Type:application/json -H "X-Auth-Token:$token" -X POST https://${bmc}/redfish/v1/Managers/IGX_BMC_0/VirtualMedia/USB1/Actions/VirtualMedia.EjectMedia -v
        
```

Previous BMC Management Network Interface

Next Manage your BMC from the command line