Migrating from TrueNAS Core to Scale: uids below 1000?

OpenZFS TrueNAS
1

I am trying to migrate my home TrueNAS box to Scale (Community Edition). The TrueNAS 25.04 (Fangtooth) Preparing to Migrate document says this:

User-created accounts with UID or GID less than 1000 - The UID/GID range below 1000 are reserved for built-in system accounts. User-created accounts in this ID range can cause conflicts and undefined behavior after migration, including duplicate accounts with the same ID. Recreate any non-builtin accounts in this range to assign an ID of 1000 or higher, then delete the previous account and reconfigure ACLs as needed before migrating.

I have a couple of accounts with UIDs below 1000. One is my admin account and is the only way I can currently log in to a shell.

Questions:

  • How do you actually recreate an account?

  • Is “find $POOL -user $OLD | xargs chown $NEW” sufficient to repossess all the files? Will that do anything reasonable with existing snapshots? N.B., 99% of the files on the NAS are owned by these users.

  • Do I need to create a temporary admin account to keep from locking myself out?

  • These accounts access via SMB. Do I have to do something to make SMB continue to work with a recreated account? Will clients have to reauthenticate?

Thanks for any suggestions!

2

Following up, this is what I did. AFAICT, it worked.

  1. Create a second adminstrator account. Give it a UID high enough not to conflict with the UIDs to be renumbered.

  2. Stop SMB service.

  3. Take a recursive snapshot of the entire pool. (I called it about-to-renumber-${datestamp}.)

  4. For each user,
    rename $user to ${user}old.
    Create account $user with unused UID >= 1000.
    Copy old user’s settings to new user.
    $ find ${pool_root} -user ${olduser} -exec chown ${newuser} ‘{}’ ‘;’

  5. For each dataset in pool,
    Edit dataset permissions, find any ${olduser} and change to ${newuser}.
    Don’t forget to check the “edit user” box.

  6. Restart SMB service.

  7. Test ssh, smb, backups, whatever

  8. Delete accounts for old users.

I did all this on TrueNAS CORE 13.0.something. I haven’t migrated to SCALE yet.

1 Like