Edit page
TrueNAS SCALETrueNAS SCALE Version Documentation
This content follows the TrueNAS SCALE 23.10 (Cobia) releases. Use the Product and Version selectors above to view content specific to different TrueNAS software or major version.

Preparing for SCALE UI Configuration (Enterprise)

  5 minute read.

Last Modified 2024-03-19 08:38 EDT
TrueNAS Enterprise

SCALE Enterprise customers, or those that purchased systems and service contracts from iXsystems, should use the information in this article to prepare for their SCALE system deployments.

The iXsystems Support department provides assistance with the configuration areas documented in this section.

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.

iXsystems Customer Support
Support Portalhttps://support.ixsystems.com
Emailsupport@ixsystems.com
Telephone and Other Resourceshttps://www.ixsystems.com/support/

Required Access and Information

Because there are many possible scenarios for network configurations, this section covers the basics of the access and information required to configure SCALE to work in your network environment. If you are the individual tasked with installing and configuring the TrueNAS SCALE server but are not responsible for network services in your company, contact your network administrator to request they provision and verify new IP address assignments and provide the other information for access.

Physical Access

When in the same location as the hardware designated for the TrueNAS installation, you can connect a monitor and keyboard to the system to do the initial installation and configuration. An additional USB port is required when using a USB storage device to install TrueNAS from .iso file.

IPMI Access

The Intelligent Platform Management Interface (IPMI) provides a way for system administrators to remotely access their TrueNAS system. Through this remote access, administrators can install software, and configure or administer systems at the console level as though they are in the room with the server. TrueNAS Enterprise systems sold by iXsystems provide IPMI network ports, but other hardware might not have IPMI ports.

iXsystems requires access through your IPMI server to access the TrueNAS server to provide remote administration support. To make this possible:

  • Assign an IP address to the IPMI port of each controller in the TrueNAS array. If you have a High Availability (HA) system, the server is equipped with two controllers so assign two IP addresses, one for each controller.
  • Create and provide administrator credentials (user name and password) for access to the TrueNAS IPMI connections. Configure the administrator credentials to access both IP addresses assigned to the HA system controllers.

Network Access

TrueNAS uses DHCP to assign the IP address to the primary system network interface. DHCP only provisions one IP address. You can use this DHCP-provided address or you can assign a static IP address. You must assign each network interface cards (NICs) installed in your system and wired to your network an IP address if you want to communicate over your network using the interfaces. To configure your TrueNAS server to work with your network, you need:

  • DHCP broadcast messages enabled on the network or the subnet(s) in your network where TrueNAS is installed
  • DNS name sever IP addresses in your network (SCALE can accommodate up to three name server IP addresses)
  • IP address for the Network Time Protocol (NTP) server you use to synchronize time across your servers and network
  • Main domain name or the domain name for the portion of your network where the TrueNAS SCALE server is deployed
  • Host name you want to use if not using the default-assigned host name in SCALE (truenas is the default host name in SCALE)
  • IP address for each additional network interface added in your system and connected to your network (static IP not provided by DHCP)
  • IP address assigned to the controller. Either allow DHCP to assign the IP address or assign a static IP.
TrueNAS Enterprise

The failover feature on TrueNAS SCALE Enterprise platforms with High Availability (HA) is currently incompatible with the network Spanning Tree Protocol (STP). Please validate that STP is disabled on the network switch ports connected to the TrueNAS SCALE HA platform before enabling the failover feature.

If you have an HA system with two controllers, you must assign a total of three IP addresses:

  • A virtual IP for access to the UI no matter which controller is active
  • An IP address for the primary network port on controller A
  • An IP address for the primary network port on controller B

iXsystems Support can assist you with any questions you have with these network requirements. Provide the information listed to iXsystems when requested to expedite configuring your system network settings.

SMTP Access

Simple Mail Transfer Protocol (SMTP) service or servers allow for the transfer of electronic mail across an Internet connection. TrueNAS uses either SMTP to send mail from SCALE to either administrator or designated individual email addresses for system alert notifications.

Have your network administrators provide the SMTP addresses to allow TrueNAS to send emails from your network.

Directory Service Access

TrueNAS SCALE works with either Active Directory or LDAP directory servers, and it can also work with Kerberos and IDmap. Active Directory and LDAP configuration settings have similar requirements.

Provide the following information to configure SCALE Active Directory access:

  • Domain name for where the Active Directory server is located
  • Authentication credentials for access to the Active Directory server (admin user name and password to allow SCALE to communicate with the server)
  • List of trusted domains SCALE should allow

Provide the following information to configure SCALE LDAP access:

  • Host name where the LDAP sever is located and where SCALE accesses it
  • Base and bind distinguished names (DN) and the bind password which are the authentication credentials
  • Kerberos realm and keytab information if used in your directory server deployment for SCALE to use for authentication

Not all companies uses Kerberos or IDmap but if your company does you might be asked to provide:

  • Kerberos realm and keytab information
  • IDmap schema information

Related Installation Articles

Related Migration Articles