Uploaded image for project: 'FreeNAS / TrueNAS'
  1. FreeNAS / TrueNAS
  2. NAS-102733

Improve exporting pool section of Guide

    XMLWordPrintable

    Details

      Description

      I've been working on using a big disk as an offsite backup, and have some suggestions from my experience:

      1) In the guide, Fig. 9.2.4 Export/Disconnect a Pool, no longer matches the actual GUI. The word "detach/detaching" in the figure has been changed to "Export/disconnect" in the GUI.

      2) when exporting/disconnecting a pool, a confirmation box with 3 checkboxes is shown, the middle one says "Delete configuration of shares that used this pool?".  It is ticked by default.  I think it would be preferable to be *un*ticked by default, since it's a descructive choice; better to be opt-in, not opt-out.

      3) the same confirmation box says "Back up any critical data before exporting/disconnecting a pool".  This gives me pause.  All I'm trying to do is eject a disk without deleting any data (this is my offsite backup disk).  Surely ejecting a disk is not an operation that is so risky it requires a backup first!  I suspect the sentence only means to apply if either of the destructive checkboxes are ticked.  Would be nice to reword somehow.

      4) no doubt the use of the word "export" and "import" are from the matching zpool commands, but, even though I've been using FreeNAS for months, and know a bit about ZFS, I find these verbs odd for my particular task, which is to merely connect a disk, copy some files, then eject the disk. To me, the verbs import/export conjure the idea of data being copied. The docs already have this sentence in section 9.2.7:

      "For example, when moving a pool from one system to another, perform this export/disconnect action first to flush any unwritten data to disk".

      perhaps add a second example about just wanting to eject a disk:

      "For example, when moving a pool from one system to another, or to just prepare a disk for physical removal, perform this export/disconnect action first to flush any unwritten data to disk".

       

        Attachments

          Activity

            People

            Assignee:
            aaron Aaron St. John
            Reporter:
            seanm Sean McBride
            Votes:
            0 Vote for this issue
            Watchers:
            5 Start watching this issue

              Dates

              Created:
              Updated:
              Resolved:

                Summary Panel