Migrating TrueNAS CORE to SCALE (Enterprise HA)
3 minute read.Last Modified 2023-11-30 10:15 EST
High Availability (HA) systems cannot migrate directly from CORE to SCALE.
Enterprise customers with HA systems should contact iXsystems Support before attempting any migration.
Customers who purchase iXsystems hardware or that want additional support must have a support contract to use iXsystems Support Services. The TrueNAS Community forums provides free support for users without an iXsystems Support contract.
Contact Method Contact Options Web https://support.ixsystems.com firstname.lastname@example.org Telephone Monday - Friday, 6:00AM to 6:00PM Pacific Standard Time:
US-only toll-free: 1-855-473-7449 option 2
Local and international: 1-408-943-4100 option 2
Telephone After Hours (24x7 Gold Level Support only):
US-only toll-free: 1-855-499-5131
International: 1-408-878-3140 (international calling
Migrating TrueNAS from CORE to SCALE is a one-way operation. Attempting to activate or roll back to a CORE boot environment can break the system.
Upgrade your CORE system to the latest publicly-available 13.0-Ux release before attempting to migrate from CORE to SCALE.
SCALE Bluefin deprecates and SCALE Cobia removes the built-in DDNS, OpenVPN server and client, rsync, S3, and TFTP services. The WebDAV service and share feature are also deprecated in Bluefin and removed in Cobia. New applications are available in SCALE Bluefin to serve as replacements for the functions provided by these services.
To avoid any potential service outages, Enterprise customers with licensed TrueNAS systems are prevented from upgrading from SCALE 22.12.3 (or later) to SCALE 23.10 unless the deprecated services have been replaced and/or disabled. Enterprise customers can contact iXsystems Support for assistance migrating from deprecated services.
Customers with CORE Enterprise High Availability (HA) systems that want to migrate to SCALE cannot directly migrate the system. Instead, the process is to clean install SCALE on the system and reimport the storage pools. Due to software differences between CORE and SCALE, an HA system with CORE installed cannot directly migrate to SCALE.
First, back up your data storage and export your pools to the server.
Review the list of preparation steps in Preparing for SCALE UI Configuration (Enterprise) and gather the information you need before you begin installing SCALE.
Next, do a clean install of SCALE using the
After installing SCALE, configure controller 1 using the SCALE UI, configure controller 1 to the point just before you sync to peer, then power up controller 2 with SCALE already installed and at the Console setup menu screen but not configured, then on controller 1 sync to peer.
After configuring network in controller 1, import all your pools. Creating a new pool before importing pools could result in accidentally wiping disks currently used with an exported pool.