2. Initial Setup — TrueNAS® User Guide 9.10.2-U1 Table of Contents

# 2. Initial Setup

Depending on the degree of pre-configuration you requested from iXsystems, much of the initial TrueNAS® setup may already be complete.

Note

Always perform the initial TrueNAS® setup in consultation with your iXsystems Support Representative. You can contact iXsystems Support at truenas-support@ixsystems.com. Be sure to have all of your TrueNAS® hardware serial numbers on hand, which are located on the back of the chassis.

This section covers these initial setup steps:

- Packing List: provides an overview of the hardware components.
- Hardware Setup: how to install the TrueNAS® hardware into a rack and connect all necessary expansion shelves.
- Out-of-Band Management: connect and configure the TrueNAS® out-of-band management port.
- Console Setup Menu: access the TrueNAS® console setup menu to configure network interfaces.

## 2.1. Packing List

The TrueNAS® Storage Array supports two expansion shelf models: the E16/E16F Expansion Shelf and the E24 Expansion Shelf. Each is designed to be straightforward to set up.

The TrueNAS® Storage Array comes with a number of necessary accessories. If anything is missing or your TrueNAS® Storage Array arrived in less than pristine condition, immediately take pictures and contact iXsystems support.

Check that your shipment includes these items:

- TrueNAS® Storage Array

- Up to 16 Populated 3.5” drive trays

- One pair of outer rails, left and right

- Eight thumbscrews

- Two short screws

- Two long screws

- Two power cables

- One serial to 3.5mm cable

- One faceplate

- One printed guide

Since network cables are highly configuration-dependent, contact your iXsystems Sales Representative if you have any questions regarding the included cables.

Any unused drive bays are populated with drive tray blanks to maintain proper airflow.

The layout of the storage controller will vary by configuration. Figure 2.1.1 provides an example of the front view of the TrueNAS® Storage Array.

Fig. 2.1.1 Front View

Note the two control panels on either side of the front of the array. The one on the left controls the primary storage controller, and the one on the right controls the secondary storage controller in High Availability models.

Figure 2.1.2 shows the layout of the front panel buttons and indicators.

Fig. 2.1.2 Front Panel Buttons and Indicators

Figure 2.1.3 shows the rear view of the array. If the TrueNAS® Storage Array is configured for High Availability, both storage controller slots are populated. In a single-controller model, the bottom controller slot contains a controller slot cover panel.

Fig. 2.1.3 Rear View

Figure 2.1.4 shows a drive tray and the meanings for the LED colors.

Fig. 2.1.4 Drive Tray

## 2.2. Hardware Setup

TrueNAS® Storage Array slide rails support racks with both square and circular hole types. Set the mounting brackets into the correct position for your rack type by pressing the button on the mounting bracket and rotating them in place, as shown in Figure 2.2.1. The square rack style brackets are the default. The circular hole style is the one with a flat surface and screw holes.

Fig. 2.2.1 Rotate Rackmount Bracket

Before installing the TrueNAS® Storage Array, confirm that the rails included with your TrueNAS® Storage Array are long enough for your rack. Examine each rail to find the sides labeled Front and Rear.

For racks with square holes, snap the mounting brackets into the holes at either end of the rail into the mouting holes. Make sure to install the rails with the end labeled Front toward the front of the rack. Refer to Figure 2.2.2 for a detailed view.

Fig. 2.2.2 Installing Rails in Racks with Square Holes

For racks with round holes, secure the rails into the rack at the desired position using the eight thumbscrews included with the rails. Make sure to install the rails with the end labeled Front toward the front of the rack. Refer to Figure 2.2.3 for a detailed view.

Fig. 2.2.3 Installing Rails in Racks with Round Holes

You are now ready to install the TrueNAS® Storage Array into the rack.

Warning

Two people are required to lift a TrueNAS® Storage Array.

Carefully align the TrueNAS® Storage Array inner rail with the notches in the outer rail. Once the rails are aligned, slide the array toward the rack. When the array stops moving, move the pin-lock laches to allow the array to slide the rest of the way into the rack. Refer to Figure 2.2.4 for a detailed view.

Fig. 2.2.4 Push Array into Rack and Release pin-lock Latches

Next, install all of the populated drive trays into the front of the array. Refer to Figure 2.2.5 for a detailed view.

Note

to avoid personal injury, do not install drives into the TrueNAS® Storage Array before racking.

Fig. 2.2.5 Drive Installation Instructions

Connect both network and storage cabling before turning on the TrueNAS® Storage Array for the first time.

Network cabling is highly dependent on the exact TrueNAS® model and environment. If you need assistance connecting your TrueNAS® Storage Array to the network, contact your iXsystems Support Representative.

In order to configure and use Out-of-Band Management, you must connect the out-of-band management port before turning on the TrueNAS® Storage Array. Refer to Figure 2.2.6 or the sticker on the storage controller handle for the location of the out-of-band management port.

Fig. 2.2.6 Back Panel Layout

For storage cabling instructions, refer to the instructions in E16/E16F Expansion Shelf or E24 Expansion Shelf, depending upon the TrueNAS® expansion shelf.

Finally, each TrueNAS® Storage Array includes an optional faceplate. To attach the faceplate to the TrueNAS® Storage Array, insert the two tabs on the right side of the faceplate into the holes in the right side handle section. Push the left side of the faceplate down until it clicks into place.

Once all of the other hardware setup steps are complete, plug the power cords into the AC receptacles on the back of the TrueNAS® Storage Array and secure them in place with the wire locks.

Note

Be sure to power on all TrueNAS® storage expansion shelves before powering on the TrueNAS® Storage Array.

Power on the TrueNAS® Storage Array by pressing the top left button on the control panel for each storage controller. Wait thirty seconds after turning on the first storage controller before powering on the second storage controller. This will make it clear which controller is the active controller in High Availability configurations.

Once the TrueNAS® Storage Array is fully operational, the TrueNAS® logo will act as a global fault light. By default, it is backlit in white. If there are any issues that need to be addressed, the light will turn red. In this case, refer to the Alert section of the TrueNAS® administrative graphical interface for more details about the error condition.

## 2.3. E16/E16F Expansion Shelf

Note

This product is End Of Life (EOL). Support ends January 31, 2020.

The TrueNAS® E16 expansion shelf is a 3U, 16-bay storage expansion unit designed specifically to work with the TrueNAS® Storage Array. This section will cover setting up an E16 expansion shelf and connecting it to a TrueNAS® Storage Array.

The E16 expansion shelf comes with a number of necessary accessories. If anything is missing or your E16 expansion shelf arrived in less than pristine condition, immediately take pictures and contact iXsystems support.

- TrueNAS® E16 expansion shelf

- Up to 16 populated 3.5” drive trays

- Two power cables

- Two host expansion cables (SAS 8088)

- Inner and outer rails, left and right

- Two sets of screws

- One printed guide

Unused drive bays are populated with drive tray blanks to maintain proper airflow.

Figure 2.3.1 shows the front view of the TrueNAS® E16 expansion shelf.

Fig. 2.3.1 Front View

Figure 2.3.2 shows the rear view of the TrueNAS® E16 expansion shelf.

Fig. 2.3.2 Rear View

Figure 2.3.3 provides a detailed view of a drive tray and the possible statuses for the LED.

Fig. 2.3.3 Drive Tray

To attach the E16 expansion shelf inner rail to the chassis, remove the inner rail from both rails. Slide the inner and outer rails apart, and then push the pin-lock latch outward to allow the rails to separate completely, as shown in Figure 2.3.4.

Fig. 2.3.4 Separate Inner and Outer Rails

Align the inner rail keyholes to the two hooks near the front of the chassis, then slide the rails forward into place as shown in Figure 2.3.5.

Fig. 2.3.5 Attach Inner Rail to Chassis

Secure the inner rail in place with a small screw from the rail kit. Refer to Figure 2.3.6 for a detailed view.

Fig. 2.3.6 Secure Inner Rail in Place

The TrueNAS® E16 expansion shelf slide rails support racks with both square and circular hole types. Set the mounting brackets into the correct position for your rack type by pressing the button on the mounting bracket and rotating them in place, as shown in Figure 2.3.7. The square rack style brackets are the default. The circular hole style is the one with a flat surface and screw holes.

Fig. 2.3.7 Rotate Rackmount Bracket

Before installing, confirm that the rails included with the TrueNAS® E16 expansion shelf are long enough for your rack. Examine each rail to find the sides labeled Front and Rear.

For racks with square holes, snap the mounting brackets into the holes at either end of the rail into the mouting holes. Make sure to install the rails with the end labeled Front toward the front of the rack. Refer to Figure 2.3.8 for a detailed view.

Fig. 2.3.8 Installing Rails in Racks with Square Holes

For racks with round holes, secure the rails into the rack at the desired position using the eight thumbscrews included with the rails. Make sure to install the rails with the end labeled Front toward the front of the rack. Refer to Figure 2.3.9 for a detailed view.

Fig. 2.3.9 Installing Rails in Racks with Round Holes

You are now ready to install the E16 expansion shelf into the rack.

Warning

Two people are required to lift a TrueNAS® E16 expansion shelf.

Carefully align the TrueNAS® E16 expansion shelf inner rail with the notches in the outer rail. Once the rails are aligned, slide the array toward the rack. When the array stops moving, move the pin-lock laches to allow the array to slide the rest of the way into the rack. Refer to Figure 2.3.10 for a detailed view.

Fig. 2.3.10 Push Expansion Shelf into Rack and Release pin-lock Latches

Next, install all populated drive trays into the front of the expansion shelf as shown in Figure 2.3.11.

Note

to avoid personal injury, do not install drives into the E16 expansion shelf before racking.

Fig. 2.3.11 Drive Installation Instructions

Note the labels on the SAS ports on the back of the TrueNAS® Storage Array and the letter label on the back of the expansion shelf. Using the included SAS cables, connect the In SAS port of the top expander on the E16 expansion shelf to the SAS port with the same letter on the TrueNAS® Storage Array’s primary storage controller (the one in the top slot). If you have a secondary storage controller, connect the In SAS port of the bottom expander to the port with the same letter on the secondary storage controller. Refer to Figure 2.3.12 for a detailed view.

Fig. 2.3.12 Connecting an E16 Expansion Shelf to a TrueNAS® Storage Array

Once all the other hardware setup steps are complete, plug the power cords into the AC receptacles on the back of the E16 expansion shelf and secure them in place with the wire locks. Power on the E16 expansion shelf by pressing the top left button on the control panel.

If you are setting up a TrueNAS® Storage Array for the first time, wait two minutes after powering on all expansion shelves before turning on the TrueNAS® Storage Array.

## 2.4. E24 Expansion Shelf

The TrueNAS® E24 expansion shelf is a 4U, 24-bay storage expansion unit designed specifically for use with the TrueNAS® Storage Array. This section will cover setting up an E24 expansion shelf and connecting it to a TrueNAS® Storage Array.

The E24 expansion shelf comes with a number of necessary accessories. If anything is missing or your E24 expansion shelf arrived in less than pristine condition, immediately take pictures and contact iXsystems support.

- TrueNAS® E24 expansion shelf

- Up to 24 populated drive trays

- Two power cables

- Two host expansion cables (SAS 8088)

- One rail kit

- One printed guide

Unused drive bays are populated with drive tray blanks to maintain proper airflow.

Figure 2.4.1 shows the front of the TrueNAS® E24 expansion shelf.

Fig. 2.4.1 Front View

Figure 2.4.2 shows the rear view of the TrueNAS® E24 expansion shelf.

Fig. 2.4.2 Rear View

Figure 2.4.3 provides a detailed view of a 3.5” drive tray.

Fig. 2.4.3 Drive Tray

Two rails and three sets of screws are included in the rail kit. Use only the screws labeled for use in the type of rack you have. Take note of the engraved rails at either end of each rail specifying whether they are for the Left (L) or Right (R) and which end is the front and which is the back. With two people, attach each rail to the rack using the topmost and bottommost screw holes. The folded ends of the rails should be inside the corners of the rack. Figure 2.4.4 shows the front left attachments for an L-type rack.

Fig. 2.4.4 Front Left Rail

Figure 2.4.5 shows the rear right attachments for an L-type rack.

Fig. 2.4.5 Rear Right Rail

Next, install the E24 expansion shelf into the rack.

Note

To avoid personal injury, do not install drives into the E24 expansion shelf before racking.

With two people, place the back of the expansion shelf on the rack. Gently push it backwards until the front panels of the expansion shelf are pressed against the front of the rack.

Secure the expansion shelf to the rack by pushing down and tightening the two built-in thumbscrews as indicated in Figure 2.4.6.

Fig. 2.4.6 Secure E24 Expansion Shelf to the Rack

Once the E24 expansion shelf is secured into the rack, insert the included hard drives. To insert a drive, release the handle with the tab on the right side, push it into the drive bay until the handle starts to be pulled back, and then push the handle the rest of the way forward to secure the drive in place.

To connect the E24 expansion shelf to the TrueNAS® Storage Array, note the labels on the SAS ports on the back of the TrueNAS® Storage Array and the letter label on the back of the expansion shelf. Using the included SAS cables, connect the left In SAS port of the left side expander on the E24 expansion shelf to the SAS port with the same letter on the TrueNAS® Storage Array’s primary storage controller (the one in the top slot). If you have a secondary storage controller, connect the left In SAS port of the right side expander to the port with the same letter on the secondary storage controller. Refer to Figure 2.4.7 for a detailed view.

Fig. 2.4.7 Example connection between E24 Expansion Shelf and TrueNAS® Storage Array

Note

If you only have one storage controller, retain your second SAS cable. If you later upgrade TrueNAS® with a second storage controller, you will need it to connect to the E24 expansion shelf.

Before you plug in and power on the E24 expansion shelf, make sure the power switches on both power supplies are set to the Off (Circle) position shown in Figure 2.4.8. Using the power cables provided, connect both power supplies to appropriate power sources. Secure the power cables in place with the plastic locks.

Fig. 2.4.8 E24 Power Supply

Once all the power and storage connections are set up, turn on the expansion shelf by moving the power switches on both power supplies to the On (line) position.

If you are setting up a TrueNAS® Storage Array for the first time, wait two minutes after powering on all expansion shelves before turning on the TrueNAS® Storage Array.

## 2.5. Out-of-Band Management

Before attempting to configure TrueNAS® for out-of-band management, ensure that the out-of-band management port is connected to an appropriate network. Refer to the guide included with your TrueNAS® Storage Array for detailed instructions on how to connect to a network.

Make sure to connect the out-of-band management port before powering on the TrueNAS® Storage Array.

In most cases, the out-of-band management interface will have been pre-configured by iXsystems. This section contains instructions for configuring it from the BIOS if needed. Alternately, if you have already have access to the TrueNAS® administrative graphical interface, the same settings can be configured using the instructions in IPMI.

To access the system BIOS, press `F2` at the splash screen when booting the TrueNAS® Storage Array. This opens the menu shown in Figure 2.5.1.

Fig. 2.5.1 Initial BIOS Screen

Navigate to the Server Mgmt menu and then BMC LAN Configuration, as shown in Figure 2.5.2.

Fig. 2.5.2 Navigate to BMC LAN Configuration

If you will be using DCHP to assign the out-of-band management IP address, leave the Configuration Source set to Dynamic in the screen shown in Figure 2.5.3. If an IP has been assigned by DHCP, it will be displayed.

Fig. 2.5.3 Configuring a Dynamic IP Address

To instead assign a static IP address for out-of-band management, set the Configuration Source to Static, as seen in the example shown in Figure 2.5.4. Enter the desired IP Address into the IP Address setting, filling out all four octets completely.

Fig. 2.5.4 Configuring a Static IP Address

Next, enter the Subnet Mask of the subnet within which you wish to have access to out-of-band management. An example is seen in Figure 2.5.5.

Fig. 2.5.5 Entering the Subnet Mask

Finally, set the Default Gateway Address for the network to which the out-of-band management port is connected. An example is seen in Figure 2.5.6.

Fig. 2.5.6 Entering the Default Gateway Address

Save the changes you have made, exit the BIOS, and allow the system to boot.

To connect to the TrueNAS® Storage Array using the out-of-band management port, input the configured IP address into a web browser from a computer that is either within the same network or which is directly wired to the array. As seen in Figure 2.5.7, a login prompt will appear.

Fig. 2.5.7 Connecting to the IPMI Graphical Interface

Login using the default Username of admin and the default Password of password.

You can change the default administrative password using the instructions in IPMI.

Once logged in, click the vKVM and Media button at the top right to download the Java KVM Client. Run the client by clicking the Launch Java KVM Client button shown in Figure 2.5.8.

Fig. 2.5.8 Launching the Java KVM Client

When prompted for a program to open the file with, select the Java Web Start Launcher shown in Figure 2.5.9.

Fig. 2.5.9 Configure the Launch Program

When asked if you want to run a program by an unknown publisher, check the box indicating that you understand the risks and press Run. An example is seen in Figure 2.5.10.

Fig. 2.5.10 Respond to Warning

When prompted that the connection is untrusted, as seen in Figure 2.5.11, press Continue.

Fig. 2.5.11 Continue Through this Screen

When the out-of-band console opens, the TrueNAS® Storage Array can be controlled as if you were using a directly-connected keyboard and monitor.

## 2.6. Console Setup Menu

After setting up the hardware for the TrueNAS® Storage Array, boot the system. The Console Setup menu, shown in Figure 2.6.1, appears at the end of the boot process. If access to the TrueNAS® system’s keyboard and monitor is available, this Console Setup menu can be used to administer the system if the administrative GUI is not accessible.

Note

The Console Setup menu can be accessed from within the TrueNAS® GUI by typing /etc/netcli from Shell. The Console Setup menu can be disabled by unchecking the Enable Console Menu in `System → Settings → Advanced`.

Fig. 2.6.1 Console Setup Menu

This menu provides these options:

1) Configure Network Interfaces: provides a configuration wizard to configure the system’s network interfaces. If the system has been licensed for for High Availability (HA), the wizard will prompt to set the IP address for both (This Node) and (Node B).

2) Configure Link Aggregation: allows you to either create a new link aggregation or to delete an existing link aggregation. If the system has been licensed for for High Availability (HA), you will be prompted to set the VHID when creating the link aggregation.

3) Configure VLAN Interface: used to create or delete a VLAN interface.

4) Configure Default Route: used to set the IPv4 or IPv6 default gateway. When prompted, input the IP address of the default gateway.

5) Configure Static Routes: prompts for the destination network and the gateway IP address. Re-enter this option for each route to be added.

6) Configure DNS: will prompt for the name of the DNS domain then the IP address of the first DNS server. To enter multiple DNS servers, press `Enter` to input the next one. When finished, press `Enter` twice to leave this option.

7) Reset Root Password: if you are unable to login to the graphical administrative interface, select this option and follow the prompts to set the root password.

8) Reset to factory defaults: to delete all of the configuration changes made in the administrative GUI, select this option. Once the configuration is reset, the system will reboot. It will be necessary to go to `Storage → Volumes → Import Volume` to re-import volumes.

9) Shell: starts a shell to run FreeBSD commands. To leave the shell, type exit.

10) System Update: if any system updates are available, they will automatically be downloaded and applied. The functionality is the same as described in Update, except that the updates will be applied immediately and access to the GUI is not required.

11) Create volume backup: used to backup the TrueNAS® configuration and ZFS layout, and, optionally, the data, to a remote system over an encrypted connection. The only requirement for the remote system is that it has sufficient space to hold the backup and it is running an SSH server on port 22. The remote system does not have to be formatted with ZFS as the backup will be saved as a binary file. When this option is selected, it will prompt for the hostname or IP address of the remote system, the name of a user account on the remote system, the password for that user account, the full path to a directory on the remote system to save the backup, whether to also back up all of the data, whether to compress the data, and a confirmation to save the values, where y will start the backup, n will repeat the configuration, and q will quit the backup wizard. If the password field is left empty, key-based authentication is used instead. This requires that the public key of the root user is stored in `~root/.ssh/authorized_keys` on the remote system. That key should not be protected by a passphrase. Refer to Rsync over SSH Mode for instructions on generating a key pair.

12) Restore volume from a backup: if a backup has already been created using 11) Create volume backup or `System → Advanced → Backup`, it can be restored using this option. Once selected, it will prompt for the hostname or IP address of the remote system holding the backup, the username that was used, the password (leave empty if key-based authentication was used), the full path of the remote directory storing the backup, and a confirmation that the values are correct, where y will start the restore, n will repeat the configuration, and q will quit the restore wizard. The restore will indicate if it could log into the remote system, find the backup, and indicate whether or not the backup contains data. It will then prompt to restore TrueNAS® from that backup. Note that if you press y to perform the restore, the system will be returned to the database configuration, ZFS layout, and optionally the data, at the point when the backup was created. The system will reboot once the restore is complete.

Warning

The backup and restore options are meant for disaster recovery. A restored system is returned to the point in time that the backup was created. If the option to save the data is selected, any data created after the backup was made will be lost. If the option to save the data is not selected, the system is recreated with the same ZFS layout, but with no data.

Warning

The backup function IGNORES ENCRYPTED POOLS. Do not use it to back up systems with encrypted pools.

13) Toggle automatic support alerts to iXsystems: controls whether emails are sent to iXsystems support when a problem is detected. When selected, the current setting is shown and an opportunity to change it is provided.

14) Reboot: reboots the system.

15) Shutdown: halts the system.

During boot, TrueNAS® automatically attempts to connect to a DHCP server from all live interfaces. If it successfully receives an IP address, the address is displayed so it can be used to access the graphical user interface. In the example seen in Figure 2.6.1, the TrueNAS® system is accessible at http://192.168.1.119.

Some TrueNAS® systems are set up without a monitor, making it challenging to determine which IP address has been assigned. On networks that support Multicast DNS (mDNS), the hostname and domain can be entered into the address bar of a browser. By default, this value is truenas.local.

If the TrueNAS® server is not connected to a network with a DHCP server, the console network menu can be used to manually configure the interface as seen in Example: Manually Setting an IP Address from the Console Menu. In this example, the TrueNAS® system has one network interface, em0.

Manually Setting an IP Address from the Console Menu

    Enter an option from 1-14: 1
    1) em0
    Select an interface (q to quit): 1
    Reset network configuration? (y/n) n
    Configure interface for DHCP? (y/n) n
    Configure IPv4? (y/n) y
    Interface name: (press enter as can be blank)
    Several input formats are supported
    Example 1 CIDR Notation: 192.168.1.1/24
    Example 2 IP and Netmask separate: IP: 192.168.1.1
    Netmask: 255.255.255.0, or /24 or 24
    IPv4 Address: 192.168.1.108/24
    Saving interface configuration: Ok
    Configure IPv6? (y/n) n
    Restarting network: ok
    You may try the following URLs to access the web user interface:
    http://192.168.1.108

## 2.7. Accessing the Administrative GUI

After the system has an IP address, enter that address into a graphical web browser from a computer on the same network as the TrueNAS® system. A prompt appears to enter the password for the root user, as shown in Figure 2.7.1.

Fig. 2.7.1 Enter the Root Password

Enter the default password of abcd1234.

Note

The default root password can be changed to a more secure value by going to `Account → Users → View Users`. Highlight the entry for root, click the Modify User button, enter the new password in the Password and Password confirmation fields, and click OK to save the new password to use on subsequent logins.

On the first login, the EULA found in Appendix A is displayed, along with a box where the license key for the TrueNAS® array can be pasted. Read the EULA, paste in the license key, then click OK. The administrative GUI appears, as shown in the example in Figure 2.7.2.

Note

Entering the license key for a High Availability pair is not allowed unless both the active and standby computers are up. The key is entered on the active computer.

Fig. 2.7.2 TrueNAS® Graphical Configuration Menu

Note

If the storage devices have been encrypted, a prompt appears for the passphrase. It must be correctly entered for the data on the disks to be accessible. If the system has also been licensed for High Availability (HA), the passphrase will be remembered as long as either node in the HA unit remains up. If both nodes are powered off, the passphrase must be re-entered when the first node powers back up.

If the user interface is not accessible by IP address from a browser, check these things:

- Are proxy settings enabled in the browser configuration? If so, disable the settings and try connecting again.
- If the page does not load, make sure that a ping reaches the TrueNAS® system’s IP address. If the address is in a private IP address range, it is only accessible from within that private network.
- If the user interface loads but is unresponsive or seems to be missing menu items, try a different web browser. IE9 has known issues and will not display the graphical administrative interface correctly if compatibility mode is turned on. If the GUI cannot be accessed with Internet Explorer, use Firefox instead.
- If “An error occurred!” messages are shown when attempting to configure an item in the GUI, make sure that the browser is set to allow cookies from the TrueNAS® system.

This blog post describes some applications which can be used to access the TrueNAS® system from an iPad or iPhone.

The rest of this Guide describes all of the configuration screens available within the TrueNAS® graphical administrative interface. The screens are listed in the order that they appear within the tree, or the left frame of the graphical interface.

Note

iXsystems recommends that you contact your iXsystems Support Representative for initial setup and configuration assistance.

Once the system has been configured and you are familiar with the configuration workflow, the rest of this document can be used as a reference guide to the features built into the TrueNAS® Storage Array.

Note

It is important to use the graphical interface (or the console setup menu) for all non-ZFS configuration changes. TrueNAS® uses a configuration database to store its settings. If changes are made at the command line, they will not be written to the configuration database. This means that these changes will not persist after a reboot and will be overwritten by the values in the configuration database during an upgrade.