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.

Systems

The Systems screen is only available to administrator users.

Connecting Systems to TrueCommand

To connect a system to TrueCommand, open the gear settings menu and click Systems. The Systems screen has two tabs: Systems and System Groups. The Systems and System Groups tabs contain all the options to connect and organize systems in TrueCommand. The Systems tab lists all added systems and their current connection statuses.

Systems List

Adding a System Manually

To connect a new system, click + NEW SYSTEM.

Enter the system IP address or DNS hostname, the nickname, and the password. If you make a mistake, you can reset the form by clicking RESET.

Systems Add

TrueCommand reconnects to systems after reboot or failover. In the event of invalid auth credentials after failover, reconnect after a few minutes by editing the system and re-authenticating. TrueCommand does not reconnect if it believes the credentials are invalid, which is the case if it tries to connect too soon to the controller undergoing failover before the Virtual IP has migrated to the other controller.

If the system has alerts or alarms, a blue circle with the number of current alerts displays to the right of the system name.

Adjusting Systems

Each TrueNAS system listed on the Systems screen has an options menu that allows you to edit, delete or modify configuration settings for that system. Click the for the system to display the options menu.

Systems Options Menu

Edit

Click Edit to open a panel on the right of the screen that displays the system setting fields you can edit. After making your changes, click SAVE CHANGES to update the system with the new values entered. Click RESET to clear the form and reset values to the previously saved settings for the NAS.

Systems Edit

Users and Groups

Click Users and Groups to display the list of users or groups for the selected system.

Systems Users and Groups

Update

If the system has updates ready to apply, a green Update displays on the system information screen.

UpdateNASWindow

Click Update on the systems option menu to open the Update NAS window with information on the update. Select Confirm, then click OK to update the system.
Click CANCEL to close the window without updating.

Launch TrueNAS Interface Use Launch TrueNAS Interface to open a new browser tab with the TrueNAS dashboard for the system selected on the System screen.
Services

Click Services to display the Services window with a list of services running or stopped for the selected system.

The options for services are adding it to start on boot-up, stopping, or starting/restarting. SelectSTART ON BOOT to add the selection to the services started at boot-up. Click the stop icon to stop a running service. Click the start/restart icon to start a stopped service.

Systems Services

Config Backups

Click Config Backups to display the Config Backups window.

SystemsConfigBackups

Click CREATE BACKUP to create a new system configuration backup.

Click (Download) next to a listed config to download that config locally.

Click next to a listed config to restore the system to that configuration.

Click next to a listed config to delete it.

If you want to delete config backups in bulk, click the checkbox next to each config you want to delete, then click DELETE SELECTED.

Delete

Click Delete to display a popup window and confirm you want to delete a selected system.

Systems Delete

Deleting a system purges all collected data from the database.

Organizing Systems into Groups

TrueCommand administrators can organize systems into collections called groups. Grouping systems allows you to efficiently manage system permissions and reporting.

It is possible to configure multiple permissions for the same user account and system in different screens within TrueCommand.

When this happens, TrueCommand follows a specific flow to check permission settings for the account:

flowchart TB

A(User settings for individual systems) --> B(User settings for system groups) --> C(Teams settings for individual systems) --> D(Teams settings for system groups)

When a user account has multiple permissions at the same level (user is a member of two teams that have different permissions to the same system), TrueCommand defaults to granting the user account the most permissive option between the conflicting permissions.

For example, user A is configured to have direct read and write access to system 1. This permission remains in place, even if user A joins a TrueCommand team that is configured with read only permission for system 1. If user A is configured to have read only access to system 1 and joins a TrueCommand team with read and write permission for system 1, the more permissive access is granted.

Open the System Groups tab to view the list of created groups and the systems they contain.

SystemsGroups

To create a group, click + NEW GROUP at the top of the Systems screen to open the New Group screen.. Enter a name for the new group, then click ADD SYSTEM to display a dropdown list of systems you can add to the group. After adding the system(s) to the group, click SAVE GROUP.

SystemsNewGroup

Managing Groups

Each group has two management options:

Edit

Clicking the edit button opens a sidebar menu. You can make adjustments to the group in this manner. Add or remove systems from the group by using the Add System button or the remove button. Click Save Changes when finished with your changes to update the group to the new group settings.

Groups Edit

Delete

Click opens a confirmation dialog.

Groups Delete

Select Confirm, then click DELETE GROUP to remove the TrueCommand group.