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:

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).

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.

TrueCommand 3.0 is tested and compatible with these TrueNAS versions:

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

Self-hosted Containers:

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

Container | Cloud

Previous

Stable

Next

TrueCommand 2.3

Latest:

2.3.3 Maintenance 20 June 2023

TrueCommand 3.0

Latest:

3.0.2 Maintenance 13 August 2024

TrueCommand Next

Anticipated:

Next Major Version TBD

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.

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.