TrueNAS® 11.3-U5 User Guide Note: Starting with version 12.0, FreeNAS and TrueNAS are unifying (https://www.ixsystems.com/blog/freenas- truenas-unification/.) into “TrueNAS”. Documentation for TrueNAS 12.0 and later releases has been unified and moved to the TrueNAS Documentation Hub (https://www.truenas.com/docs/). Warning: To avoid the potential for data loss, iXsystems must be contacted before replacing a controller or upgrading to High Availability. Copyright iXsystems 2011-2020 TrueNAS® and the TrueNAS® logo are registered trademarks of iXsystems. CONTENTS Welcome .................................................... 8 Typographic Conventions ................................................ 9 1 Introduction 10 1.1 Contacting iXsystems ............................................... 10 1.2 Path and Name Lengths ............................................. 10 1.3 Using the Web Interface ............................................. 12 1.3.1 Tables and Columns ........................................... 12 1.3.2 Advanced Scheduler ........................................... 12 1.3.3 Schedule Calendar ............................................ 13 1.3.4 Changing TrueNAS® Settings ...................................... 13 1.3.5 Web Interface Troubleshooting ..................................... 14 1.3.6 Help Text ................................................. 14 1.3.7 Humanized Fields ............................................ 14 1.3.8 File Browser ................................................ 14 2 Initial Setup 15 2.1 Hardware Setup .................................................. 15 2.2 Console Setup Menu ............................................... 15 2.3 Accessing the Web Interface ........................................... 17 2.3.1 Web Interface Troubleshooting ..................................... 19 3 Settings 20 3.1 Change Password ................................................. 20 3.2 Preferences .................................................... 20 3.2.1 Web Interface Preferences ....................................... 20 3.2.2 Themes .................................................. 21 3.2.2.1 Create New Themes ....................................... 21 3.3 API Documentation ................................................ 23 3.4 About .................................................... 23 3.5 Legacy Web Interface ............................................... 23 4 Accounts 24 4.1 Groups .................................................... 24 4.2 Users .................................................... 27 5 System 32 5.1 General .................................................... 32 5.2 NTP Servers .................................................... 35 5.3 Boot .................................................... 37 5.3.1 Operating System Device Mirroring .................................. 38 5.4 Advanced .................................................... 39 5.4.1 Autotune ................................................. 41 5.4.2 Self-Encrypting Drives .......................................... 41 3 5.4.2.1 Deploying SEDs ......................................... 42 5.4.2.2 Check SED Functionality .................................... 43 5.4.2.3 Managing SED Passwords and Data .............................. 44 5.5 View Enclosure .................................................. 45 5.6 Email ................................................... 47 5.7 System Dataset .................................................. 48 5.8 Reporting ................................................... 50 5.9 Alert Services ................................................... 50 5.10 Alert Settings ................................................... 52 5.11 Cloud Credentials ................................................. 53 5.12 SSH Connections ................................................. 57 5.12.1 Manual Setup ............................................... 59 5.12.2 Semi-Automatic Setup .......................................... 60 5.13 SSH Keypairs ................................................... 61 5.14 Tunables ................................................... 61 5.15 Update ................................................... 64 5.15.1 Preparing for Updates .......................................... 64 5.15.2 Updates and Trains ........................................... 65 5.15.3 Checking for Updates .......................................... 65 5.15.4 Saving the Configuration File ...................................... 67 5.15.5 Applying Updates ............................................. 68 5.15.6 Manual Updates ............................................. 68 5.15.7 Update in Progress ............................................ 69 5.15.8 Updating from the Shell ......................................... 69 5.15.9 Updating an HA System ......................................... 69 5.15.10If Something Goes Wrong ........................................ 71 5.15.11Upgrading a ZFS Pool .......................................... 71 5.16 CAs ................................................... 72 5.17 Certificates ................................................... 76 5.18 Failover ................................................... 81 5.19 Support ................................................... 84 5.19.1 License Information ........................................... 85 5.19.2 Proactive Support ............................................ 85 5.19.3 Contact Support ............................................. 86 6 Tasks 87 6.1 Cron Jobs ................................................... 87 6.2 Init/Shutdown Scripts ............................................... 89 6.3 Rsync Tasks ................................................... 90 6.3.1 Rsync Module Mode ........................................... 93 6.3.2 Rsync over SSH Mode .......................................... 93 6.4 S.M.A.R.T. Tests .................................................. 96 6.5 Periodic Snapshot Tasks ............................................. 97 6.5.1 Snapshot Autoremoval ......................................... 99 6.6 Replication ................................................... 100 6.6.1 Replication Creation Wizard .......................................100 6.6.2 Advanced Replication Creation .....................................103 6.6.3 Replication Tasks .............................................107 6.6.4 Limiting Replication Times ........................................107 6.6.5 Replication Topologies and Scenarios .................................108 6.6.5.1 Star Replication .........................................108 6.6.5.2 Tiered Replication ........................................108 6.6.5.3 N-way Replication ........................................108 6.6.5.4 Disaster Recovery ........................................108 6.6.6 Troubleshooting Replication ......................................109 6.6.6.1 SSH ................................................109 6.6.6.2 Compression ...........................................109 6.6.6.3 Manual Testing ..........................................109 6.7 Resilver Priority ..................................................110 6.8 Scrub Tasks ................................................... 111 6.9 Cloud Sync Tasks .................................................113 6.9.1 Cloud Sync Example ...........................................116 7 Network 119 7.1 Global Configuration ...............................................119 7.2 Interfaces ................................................... 121 7.2.1 Network Bridges .............................................124 7.2.2 Link Aggregations ............................................124 7.2.2.1 LACP, MPIO, NFS, and ESXi ...................................125 7.2.2.2 Creating a Link Aggregation ..................................125 7.2.2.3 Link Aggregation Options ....................................125 7.2.3 VLANs ................................................... 126 7.3 IPMI ................................................... 126 7.4 Network Summary ................................................128 7.5 Static Routes ................................................... 128 8 Storage 130 8.1 Swap Space ................................................... 130 8.2 Pools ................................................... 130 8.2.1 Creating Pools ..............................................131 8.2.2 Managing Encrypted Pools .......................................133 8.2.2.1 Encryption and Recovery Keys .................................135 8.2.2.2 Encryption Operations .....................................135 8.2.3 Adding Cache or Log Devices ......................................136 8.2.4 Removing Cache or Log Devices ....................................137 8.2.5 Adding Spare Devices ..........................................137 8.2.6 Extending a Pool .............................................137 8.2.7 Export/Disconnect a Pool ........................................137 8.2.8 Importing a Pool .............................................139 8.2.9 Viewing Pool Scrub Status ........................................141 8.2.10 Adding Datasets .............................................142 8.2.10.1 Compression ...........................................145 8.2.11 Adding Zvols ...............................................145 8.2.12 Setting Permissions ...........................................147 8.2.13 ACL Management .............................................148 8.3 Snapshots ..................................................