USB Drives

USB Ports

antsle one, antsle one Pro, antsle one Ultra

antsle back panel ports

antsle one XD, antsle one XD Pro, antsle one XD Ultra

antsle XD back panel ports Blue usb ports: usb 3.0.
Black usb ports: usb 2.0.

NOTE: You must change the boot options in the system BIOS after adding a USB device. Upon the next restart, the antsle will try to boot from the USB and fail. If you did not configure IPMI you can connect a keyboard and monitor to the antsle. Power up and hit <Del> at the SuperMicro splash screen to enter the bios settings. Arrow over to the 'Boot' menu and select 'USB Device BBS Priorities' and set the boot option to 'disable' for the usb device. Save settings and exit.

Configure External USB Drive

You can add additional external USB storage for antlets and virtual drives.

First ssh to the antsle

ssh root@myantsle.local 

To see the existing drives run

lsblk

The drives are named: sda, sdb...

Then plug in your usb drive and run 'lsblk' again to see the name of the new drive.
Now we want to create a partition on the drive.

parted -a optimal /dev/sdX

where 'sdX' is the name of your usb drive

Note: If 'parted' is not found, you can install it with the command:
emerge -av parted

at the 'parted' prompt enter

mklabel gpt

this will warn, any data on the drive will be destroyed. If this is ok with you, answer Yes.
then quit 'parted'

q

You do not need to update /etc/fstab. zfs will take care of mounting the zpool if the antsle is rebooted. No need to reboot.
Now lets create a zpool on the drive

zpool create POOL_NAME -m /POOL_NAME /dev/sdX
zfs set atime=off POOL_NAME

Replace POOL_NAME with a name to easily identify this drive.
Replace 'sdX' with the actual drive name
POOL_NAME must be the same in each part of the commands. ex:

zpool create myusbdrive -m /myusbdrive /dev/sde
zfs set atime=off myusbdrive

Now you can refresh antman and create a new antlet or virtual drive on this zpool. You will see your new zpool in the 'zpool' dropdown.

If you want mirrored usb disks repeat the 'parted' steps for the second drive but run the following zpool commands.

zpool create POOL_NAME -m /POOL_NAME mirror /dev/sdX /dev/sdY
zfs set atime=off POOL_NAME

sdX and sdY need to be replaced by the actual drive names displayed in 'lsblk' Replace POOL_NAME with the desired zpool name

Remove a device zpool

At the antsle's command line list the zpools

zpool list

Then destroy the zpool

zpool destroy POOL_NAME

Remove the directory the zpool was mounted to

rm -rf /POOL_NAME

Now if you refresh antman and try to create a new antlet, the zpool dropdown will no longer list the usb zpool.

USB Pass through

USB Passthrough allows you to assign an external USB drive to a specific antlet.

Note: Currently USB Pass through only works with KVM antlets

Enter the antlet details page by clicking the name of the antlet

click antlet name

Then choose the 'USBs' tab and select your device.

Select the USB device

Be sure to 'Stop' then 'Start' the antlet.