Edit page
TrueNAS SCALETrueCommand Version Documentation
This content follows TrueCommand 3.0 releases. Use the Product and Version selectors above to view content specific to TrueNAS software or major versions.

TrueCommand 3.0 Release Notes

TrueCommand 3.0 brings the latest feature development, stability fixes, and software compatibility updates together in a major version that is more functional and performant than ever before. Here are the major changes in this release:

  • An all-new Fleet Dashboard provides at-a-glance information for every system connected to TrueCommand.

  • New multi-system ZFS replication quickly backs up storage snapshots across connected TrueNAS systems.

  • The experimental clustering feature is deprecated and UI screens disabled in TrueCommand 3.0.2.

  • The experimental iSCSI management feature is permanently removed. iSCSI shares previously created by TrueCommand continue to live on the individual TrueNAS systems.

Obtaining the Release

TrueCommand is primarily offered as a Software as a Service (SaaS) solution from iXsystems, but can be self-hosted as a container deployment.

TrueCommand Cloud registrations are available from https://portal.ixsystems.com. A valid email address and credit card is required (sign up instructions).

A self-hosted TrueCommand container is available from https://hub.docker.com/r/ixsystems/truecommand/tags under the tag release-3.0.2 (deployment instructions).

Upgrade Notes

TrueCommand Cloud deployments are upgraded by iXsystems on an ongoing basis. Please use caution when upgrading production TrueCommand systems.

Self-hosted containers must be updated by a local TrueCommand administrator. As a best practice, TrueCommand administrators need to back up their instance data directory before deploying TrueCommand updates. Self-hosted containers are typically updated by backing up the container volume and pulling the latest available container version. See the container update tutorial for guidance.

Updating from TrueCommand v1.3 to v2.0 or later involves a database migration process. This preserves all configuration data, but does not preserve old performance statistics. Additionally, it is not possible to roll back to TrueCommand v1.3 from v2.1 or later.

An issue is found with High Availability (HA) TrueNAS SCALE 23.10.0.1 systems connected to TrueCommand 3.0. Update SCALE HA systems to TrueNAS SCALE version 23.10.1 or later before connecting to TrueCommand 3.0.

After upgrading to TrueCommand 3.0, you might need to edit and re-apply connected TrueNAS system passwords to ensure connectivity.

Starting in version 3.0.2, TrueCommand does not support STARTTLS or port 587 for SMTP email configuration. Users with SMTP configured on port 587 should use port 465 and select Enable TLS for full SSL/TLS encryption. See Configuring SMTP Email for more information.

In version 3.0.2 administrative users no longer appear on the list of users available to be assigned to a team. Administrative users have full admin permissions for all connected systems, so manual team assignment is not needed.

After updating, clear the browser cache (CTRL+F5) before logging in to TrueCommand. This ensures stale data doesn’t interfere the TrueCommand UI.

TrueNAS Compatibility

TrueCommand 3.0 is tested and compatible with these TrueNAS versions:

  • CORE 13.0
  • SCALE 22.12
  • SCALE 23.10
  • SCALE 24.04

Paths

Self-hosted Containers:

flowchart LR
A["Legacy (Pre 1.2)"] --> B
B["1.3"] --> C
C["2.3.3"] --> D
D["3.0.2"]

Release Schedule

The release names and dates provided here are tentative and can change at any time.

TrueCommand

Container | Cloud

Previous
Stable
Next

TrueCommand Next

Anticipated:

Next Major Version TBD
Software Lifecycle

TrueNAS Quality Lifecycle

TrueNAS releases follow a general adoption guideline for their lifetime. Starting with the NIGHTLY builds, each stage of a major release incorporates more testing cycles and bug fixes that represent a maturation of the release. With each version release stage, users are encouraged to install, upgrade, or otherwise begin using the major version, depending on the specific TrueNAS deployment and use case:

Release StageCompleted QA CyclesTypical UseDescription
NIGHTLY0DevelopersIncomplete
ALPHA1TestersNot much field testing
BETA2EnthusiastsMajor Feature Complete, but expect some bugs
RC4Home UsersSuitable for non-critical deployments
RELEASE6General UseSuitable for less complex deployments
U17Business UseSuitable for more complex deployments
U2+8Larger SystemsSuitable for higher uptime deployments

The Software Status page shows the latest recommendations for using the various TrueNAS software releases.

3.0.2 Changelog

August 13, 2024

iXsystems is pleased to release TrueCommand 3.0.2!

This is a maintenance release to address issues found in the 3.0.1 version.

Notable changes:

  • Fix Cloud SMTP email configuration for authentication (TC-3186).
  • Investigate detached NAS connections (TC-3188).
  • Disable TrueNAS UI proxy (TC-3190).
  • Do not try to decrypt text between 1 and 15 bytes (TC-3198).
  • UI refreshes token too often (TC-3200).
  • Job “config.save” does not finish and constantly yields error 32 (TC-3202).
  • User alert creator status reset on migration (TC-3177).
  • Stale sessions appear as active users (TC-3180).
  • Enable HSTS on web server (TC-3196).
  • Disable SWEET32 cipher suite support (TC-3195).
  • Increase temp password timeout for Cloud to 48 hours (TC-3187).
  • Do not check for upgrade_pending status if connected via the passive controller (TC-3182).
  • Paused internal alerts do not persist past reboot (TC-3181).
  • The deprecated Clusters screen has been disabled in the TrueCommand UI (TC-3223)

Click here for the full changelog of completed tickets that are included in the TrueCommand 3.0.2 release.

To switch between detail and list views for the changelog, press t. Open the changelog in Jira to see the Export menu to print or download the changelog in various file formats.

3.0.2 Ongoing Issues

TrueNAS Enterprise

We recommend that TrueNAS Enterprise High Availability (HA) systems be updated from the TrueNAS UI.

If TrueCommand 3.0.2 is used to upgrade HA systems, the standby controller might fail to activate the updated boot environment, resulting in a version mismatch error between the controllers. If you encounter this issue, manually activate the updated boot environment on the active controller and then failover to complete the upgrade.

  • The Explore > Snapshots tab can timeout when selected for datasets with high numbers of stored snapshots (TC-3078).

  • Changes made to SMTP email configuration after initial setup might not apply for new users created after created after the configuration updates. If you have previously updated your SMTP configuration, create new user accounts as described in Creating User Accounts. Log in as the new user and review settings in Alert Services > SMTP Email to confirm they are correct.

  • Removing all the systems from a group doesn’t automatically delete the group. However, the system group is still manually removable.

Click here to see the latest Jira tickets about known issues in 3.0.2 that are being resolved in a future TrueCommand release.

3.0.1 Changelog

Click to Expand

March 12, 2024

iXsystems is pleased to release TrueCommand 3.0.1!

This is a maintenance release to address issues found in the 3.0.0 version.

Notable changes:

  • The Legacy Dashboard is now the default landing page (TC-3145).
  • Further scrub passwords from audit logs and NAS user page (TC-3134, TC-3151.
  • Alert level field in Administration settings does not update bugfix (TC-3140).
  • NAS database backup pruning now reads the correct file time (TC-3146).
  • NAS RRD metrics are now archived on deletion (TC-3147).

Click here for the full changelog of completed tickets that are included in the TrueCommand 3.0.1 release.

To switch between detail and list views for the changelog, press t. Open the changelog in Jira to see the Export menu to print or download the changelog in various file formats.

3.0.1 Ongoing Issues

TrueNAS Enterprise

We recommend that TrueNAS Enterprise High Availability (HA) systems be updated from the TrueNAS UI.

If TrueCommand 3.0.1 is used to upgrade HA systems, the standby controller might fail to activate the updated boot environment, resulting in a version mismatch error between the controllers. If you encounter this issue, manually activate the updated boot environment on the active controller and then failover to complete the upgrade.

  • The Explore > Snapshots tab can timeout when selected for datasets with high numbers of stored snapshots (TC-3078).

Click here to see the latest Jira tickets about known issues in 3.0.1 that are being resolved in a future TrueCommand release.

3.0.0 Changelog

Click to Expand

December 19, 2023

iXsystems is pleased to release TrueCommand 3.0.0!

Notable changes:

  • Fleet Dashboard improvements (TC-3076 and TC-3075).
  • Audit logs are updated to protect potentially sensitive user information by excluding certain fields (TC-3012).
  • The Administration page allows configuring when idle user account sessions are automatically timed out.
  • TrueCommand 3.0 has not passed validation for Clustering and that feature is expected to be highly unstable in this release. With the current unmaintained state of the upstream Gluster project, consider this functionality deprecated. The clustering feature is scheduled for removal in a future TrueCommand revision.

Click here for the full changelog of completed tickets that are included in the TrueCommand 3.0.0 release.

To switch between detail and list views for the changelog, press t. Open the changelog in Jira to see the Export menu to print or download the changelog in various file formats.

3.0.0 Ongoing Issues

Click here to see the latest Jira tickets about issues discovered in 3.0.0 that are being resolved in a future TrueCommand release.

3.0.0-BETA.1 Changelog

Click to Expand
Early releases are intended for testing and feedback purposes only. Do not use early release software for mission critical tasks.

November 9, 2023

iXsystems is pleased to release TrueCommand 3.0.0-BETA.1! This is the first public release of TrueCommand 3.0 for early testing and review of features included in this major version.

Notable changes:

  • Allow reusing IP address/hostname for TrueNAS connections (TC-2672).
  • Additional warnings on cluster feature (TC-2630)
  • Default ports updated: 443 on TrueCommand Cloud deployments and 80 on self-hosted containers (TC-2573)
  • Bug fixes for SAML user creation (TC-2532)
  • Polish update availability notices on system cards (TC-2511)

Click here for the full changelog of completed tickets that are included in the TrueCommand 3.0.0-BETA.1 release.

To switch between detail and list views for the changelog, press t. Open the changelog in Jira to see the Export menu to print or download the changelog in various file formats.

3.0.0-BETA.1 Ongoing Issues

Click here to see the latest Jira tickets about issues discovered in 3.0.0-BETA.1 that are being resolved in a future TrueCommand release.