Adding iSCSI Shares: Requires a "path to a Device (zvol or file) that doesn’t use capital letters or spaces"?

Reference: Adding iSCSI Block Shares | TrueNAS Documentation Hub

Before you Begin

Have the following ready before you begin adding your iSCSI block share:

  • Storage pool and dataset.
  • A path to a Device (zvol or file) that doesn’t use capital letters or spaces.

(Emphasis added).

So … my pool is called Tank, because YouTube is what seduced me into trying ZFS in the first place.

Does that mean I can’t use iSCSI block shares on this pool? Or is it talking about the IQN target name in the iSCSI share itself?

Good question.

The pool creation documentation recommends lower case letters:

However, it doesn’t enforce it.

You’ll have to try it out, but my guess is that it will work with a lower case zvol name. If not, its a bug in the software to allow the “Tank” name in the 1st place.

However, don’t create another pool named “tank”…

1 Like

Thanks! I’ll give it a try–probably later this week.

In case that doesn’t work, I’m just going to leave this here: HOWTO: Rename a ZFS pool

I need to make better (ZFS) mistakes.

EDIT: Re-reading your message, did you want me to file a bug report even if it lets me actually do this with a capital letter in the pool name? I’d be happy to do that.

No… its certainly a bug if you fail. If not, its a documentation issue.

1 Like