Skip to main content
Skip table of contents

Step 1: Preparing the XNAT Practical VM

Do you have an SSD?

Some of the instructions in this practical will differ depending on what kind of storage your laptop has. If you have an SSD, you will run certain commands that will rely on the speed of that kind of drive. If you have a spinning disk drive, the data speeds are not sufficient for some of the more intensive commands used in this practical, so you will run alternate commands.

If you aren't sure whether or not you have an SSD, you can find out.


Open a terminal. Execute the command

$ diskutil info disk0 | grep "Solid State"
   Solid State:              Yes

If the result is Solid State: "Yes", then you have an SSD. If not, you do not.


Open Windows Explorer and right-click your primary disks and click properties. Click the Hardware tab.


Set up the xnat-21 Virtual Machine


From terminal

$ cd xnat-workshop-vms
$ ./run xnat-21 setup
Starting XNAT build using 'configs/xnat-21' config...
<output snipped>
==> xnat-21: ===========================================================
==> xnat-21: Your VM's IP address is and your deployed
==> xnat-21: XNAT server will be available at
==> xnat-21: ===========================================================


Verify that the VM was set up correctly

On some machines, the Vagrant set up for this VM will not correctly create the ZFS disks. To verify that, open VirtualBox.

Click on the xnat-21 VM in the left side of the window. That will show you the properties for this VM. Look at the Storage section in the VM's properties.

If you see something like this:

then your VM was set up correctly, and you should continue to Step 2: Creating a ZFS Storage Pool .


If you see something more like

then your ZFS disks were not created. You will have to create them manually using the instructions on this page.

Creating ZFS disks

  1. Power off the VM


  2. Edit the settings of the VM. (Right click on the VM in the left pane and click "Settings...")

  3. Select Storage - Controller: SATA Controller


  4. Click the add hard disk icon.
    Windows: On the "Controller: SATA Controller" entry, click the a little spinning-disk drive with a "+". (The icon on the right)
    Mac: On the "Controller: SATA Controller" entry, click the a little spinning-disk drive with a "+". (The icon on the right)
    or, also Mac: Click the button at the bottom of the "Storage Tree" pane with the blue square and the "+". (The icon on the left, at the bottom) Then select "Add Hard Disk".
  5. Click "Create new disk"

  6. Leave the default option ("VDI (VirtualBox Disk Image)") selected.
    Windows: Click "Next"

    Mac: Click "Continue"

  7. Leave the default option ("Dynamically allocated") selected.
    Windows: Click "Next".

    Mac: Click "Continue"

  8. Change the name to ZFS01.

    If you have an SSD, leave the size at 8GB.

    If you have a spinning disk drive, make the size 24GB.

    Click "Create".


    If you have an SSD, repeat steps 4–8 to create more virtual disks named ZFS02, ZFS03, and ZFS04.

    If you have a spinning disk drive, do not create any more disks. You will not need them.

  9. Click OK to exit the Settings
  10. Confirm all for ZFS disks created:
  11. Power on the VM, click Start:


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.