TrueNAS Enterprise
This procedure only applies to TrueNAS Enterprise (HA) systems. If attempting to migrate from FreeBSD- to Linux-based TrueNAS versions, see TrueNAS Migrations.
If the system does not have an administrative user account, create the admin user as part of this procedure.
Installing TrueNAS on High Availability (HA) systems is complicated and should be guided by Enterprise-level support. Contact TrueNAS Enterprise Support for assistance whenever attempting to install TrueNAS on Enterprise HA hardware.
Contacting Support
Customers who purchase TrueNAS hardware or that want additional support must have a support contract to use TrueNAS Support Services. The TrueNAS Community forums provides free support for users without a TrueNAS Support contract.
Enterprise Migrations
TrueNAS Enterprise customers with High Availability (HA) or Non-HA TrueNAS Hardware should consult with TrueNAS Enterprise Support for assistance before attempting to migrate.
The process requires:
- Backing up critical data.
- An extended maintenance window.
- Executing the migration process in a precise order.
- Additional system configuration to update network interfaces and add new administrator accounts.
Review the Migration Preparation article to see detailed notes and caveats about the migration process.
Failover Screen
The System > Failover screen displays settings used on TrueNAS Enterprise (HA) systems to turn the failover function on or off, sync the primary and standby controllers, and allow administrator users to configure failover. The main menu option and screen only display on Enterprise (HA) systems with the correct license applied.
Setting Description Disable Failover Select to turn failover off. Leave clear to enable failover. Default TrueNAS controller Select to make the current active controller the default controller when both TrueNAS controllers are online and HA is enabled. To change the default TrueNAS controller, leave unselected on the default TrueNAS controller and allow the system to fail over. This process briefly interrupts system services. Network Timeout Before Initiating Failover Enter a number in seconds to wait after a network failure before triggering a failover. Default is 0 which means failover occurs immediately, or after two seconds when the system is using a link aggregate. Sync To Peer Initiates a sync operation that copies over the primary controller configuration to the standby controller. Opens the Sync To Peer dialog to confirm the operation. Sync From Peer Initiates a sync operation that copies over the standby controller configuration to the primary controller. Sync To Peer and Sync From Peer buttons each open a confirmation dialog before TrueNAS performs the operation requested.
Shutting Down TrueNAS Enterprise HA
If you need to power down your TrueNAS Enterprise system with HA enabled, this is the procedure:
