-
Notifications
You must be signed in to change notification settings - Fork 189
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
1430 24.10 migration article updates (#3145)
* PD-1403 Remove 24.10 Migration Articles and Add MigrateCOREtoSCALE24_04.md Snippet to 24.10 Index This PR deletes the migration articles from the 24.10 branch, adds a new snippet with instructions on the only migration path and replaces the text in the /gettingStarted/Migrate/_index.md file with the new snippet. This snippet also goes into the Master branch file. * PD-1430 Fix broken links to deleted files * PD-1430 Add Aliases in 24.10 This commit adds the aliases for the deleted migration files. * PD-1430 Change Migration information in 24.10 This commit changes the content in the migration section of the 2410 getting started guide by adding back the deleted files, adds the new snippets MigrateCOREtoSCALE24_04.md and WhatDoesNotMigrate.md, and updates the content in the MigratePrep.md and MigrateCOREtoSCALE.md article. * PD-1430 Fix snippets in 24.10 * Update MigrateCOREtoSCALE24_04.md fix spelling * Update FirstTimeLogin.md revert to old links in to migration articles in the 24.10 branch * Update FirstTimeLogin.md revert line 97 to 24.10 migration links * Update FirstTimeLogin.md Revert changes in line 88 back to 24.10 article links instead of 24.04 * Update _index.md Revert link in like 39 back to 24.10 article instead of 24.04 * Update AFPMigration.md Revert reference in line 31 back to 24.10 instead of 24.04 * Update UpdateHASCALE.md Revert line 17 removing reference to 24.04 * PD-1430 Fix Link to MigratePrep.md. * Update MigratePrep.md - copy editing * Update MigratingFromCORE.md Copy edit and clean up the Migration Methods text. * Update MigrateCOREtoSCALE24_04.md update copy for 24.04 cutoff on update trains. * Update WhatDoesNotMigrate.md * Update MigratingFromCORE.md * Update MigratePrep.md --------- Co-authored-by: Tim Moore <Mrt134@users.noreply.github.com>
1 parent
493d3ce
commit 94af090
Showing
8 changed files
with
75 additions
and
206 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,6 @@ | ||

 | ||
|
||
TrueNAS users wanting to migrate from 13.0-U6 (latest) or 13.3 to TrueNAS 24.10 or later can migrate to 24.04 and earlier using the UI, but must clean install if migrating to later releases. | ||
Attempting to migrate directly to 24.10 or later releases fail and cannot be done. | ||
|
||
Download a copy of the <file>iso</file> for the latest maintenance release of 24.10 or earlier, then follow the migration instructions in this Getting Started section of the TrueNAS Documentation Hub to move from the FreeBSD-based version of TrueNAS to the Linux Debian-based version of TrueNAS. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,24 @@ | ||

 | ||
|
||
Although TrueNAS attempts to keep most of your 13.0-U6.x configuration data when upgrading to TrueNAS 24.04 and later releases, some 13.0-specific items do not transfer. | ||
These are the items that do not migrate from 13.0-U6.x: | ||
|
||
* Microsoft OneDrive Cloud Sync credentials and tasks. OneDrive compatibility is not available in TrueNAS. | ||
* FreeBSD GELI encryption. If you have GELI-encrypted pools on your system that you plan to import into TrueNAS 24.04 and later, you must migrate your data from the GELI pool to a non-GELI encrypted pool before migrating to TrueNAS. | ||
* Malformed certificates. TrueNAS validates the system certificates when a 13.0-U6.x system migrates to 24.04 or later. When a malformed certificate is found, TrueNAS generates a new self-signed certificate to ensure system accessibility. | ||
* 13.0-U6.x plugins and jails. Save the configuration information for your plugin and back up any stored data. | ||
After completing the TrueNAS 24.04 or later install, add the equivalent TrueNAS application using the **Apps** option. | ||
If your 13.0-U6.x plugin is not listed as an available application in TrueNAS, use the **Custom App** option to add it as an application and import data from the backup into a new TrueNAS dataset for the application. | ||
* NIS data. | ||
* System tunables. | ||
* ZFS boot environments. | ||
* SMB auxiliary parameters. As of TrueNAS 23.10 (Cobia), the **Auxiliary Parameters** option is no longer available in the UI as a configurable option. | ||
We recommend removing any auxiliary parameter settings in 13.-U6.x before migrating to TrueNAS 24.10. | ||
* AFP shares also do not transfer, but migrate into an SMB share with AFP compatibility enabled. | ||
* 13.0-U6.x `netcli` utility. A new CLI utility is used for the Console Setup Menu and other commands issued in a CLI. | ||
By default, any TrueNAS user account with `netcli` as the chosen Shell updates to use the `nologin` option instead. | ||
See the Users Screens reference article for descriptions of all Shell options. | ||
* SAS multipath is not supported in TrueNAS 24.04 and later. | ||
* TrueNAS 13 account names beginning with a number are not supported in TrueNAS 24.04 and later. | ||
Usernames in 24.04 and later must begin with a letter or an underscore. Before attempting a migration, review the local user accounts and rename or replace any accounts that begin with a numeric character (0-9). | ||
* VM storage and its basic configuration transfer over during a migration, but you need to double-check the VM configuration and the network interface settings specifically before starting the VM. |