Tip

This is the documentation for the v21.03 version. Looking for the documentation of the latest version? Have a look here.

Installation

Use the following instructions to install TNSR 21.03 from an .ISO image. Ensure that the target hardware meets the minimum specifications for a TNSR Supported Platform.

  1. Obtain the TNSR .iso image file from Netgate®.

  2. Write the .iso image to bootable media (DVD or USB drive) for hardware installations, or copy the .iso image to a location readable by the hypervisor for virtual machine installations.

  3. Connect to the system or VM console.

    Note

    The installer supports both VGA and serial console output, with VGA as the default.

  4. Check the TNSR Supported Platform documentation for notes about options which must be set before booting, for example in the system BIOS/EFI, Hypervisor, or VM guest settings.

  5. Insert or attach the boot media to the target system.

  6. Boot the system using the TNSR image.

    Note

    If the optical drive or removable media is not set as the primary boot device for the hardware, then use the system boot menu to manually select the boot device.

  7. After a few seconds, the installer displays a TNSR 21.03 screen.

    ../_images/tnsr-install-1.png

    TNSR 21.03 Installation Menu

  8. Press any key, such as space, to stop the 60-second timer. The menu contains, at minimum, the following two choices:

    • Install TNSR (serial-console) <version>: Select this option for hardware that uses serial port 0 for its console.

    • Install TNSR <version>: Select this option for installation via VGA console

  9. Highlight the correct option for this hardware and press Enter to begin the installation of TNSR. It may take a few seconds for the installer to display output to the console.

    Note

    If the console does not display a visual indication of which item is selected, reboot the device and use the BIOS boot selection menu to choose UEFI as the boot method. For example, on the SG-5100, press Esc during POST to access this menu, and of the two entries in the menu for the USB drive, choose the line that starts with UEFI:.

  10. Once the installer launches, it displays a menu labeled Installation with nine choices. All options marked with [!] must be configured to resolve all installation requirements.

    Note

    Some items marked with a ! will resolve on their own a few moments after the installer launches, such as options 3 and 4. Wait a few moments and enter r to refresh the screen.

    ../_images/tnsr-install-2.png

    TNSR 21.03 Setup Menu

    At a minimum, configure 2) Time Settings, 5) Installation Destination, and an administrator account with 9) User creation to allow the installer to proceed. These are covered next.

  11. Configure the time zone

    • Enter 2 to start the time zone configuration process.

    • Enter 1 to enter the time zone selection screen.

    • Continue through the available options until the correct zone is located.

      For example, Enter 3 for America, then 36 for Chicago.

    • Enter the number corresponding to the region and zone, or type out the zone name.

    After selecting a zone, the installer will return to the main menu.

  12. Configure the installation destination.

    • Enter 5 to start the installation destination configuration process.

    • Select the correct target disk on the next screen.

      The installer will select the disk automatically when only one is present.

    • Enter c to continue.

    • Choose how to partition the disk.

      The default Use All Space is the best practice.

    • Enter c to continue.

    • Choose the partition scheme.

      The default LVM is the best practice.

    • Enter c to finish and return to the main menu.

  13. Add an administrator account.

    Note

    Security best practices dictate that it is best not to enable interactive logon for the root account. As such, the root account will be locked out after the installation. Use this process to add at least one alternate administrator account.

    • Enter 9 to start the user configuration process.

    • Enter 1 to create a new user.

    • Enter 3 to enter the username.

    • Enter 4 to configure the account to use a password.

    • Enter 5 to set and confirm the password for the user.

    • Enter 6 to mark the user as an Administrator.

    • Enter c to finish and return to the main menu.

  14. Optionally configure a Host OS interface.

    This will enable a network interface in the host OS for use as a management interface. This interface can then be used to access the system for troubleshooting or maintenance.

    Warning

    Though this is technically optional, using a management interface is the best practice.

    • Enter 7 to start the interface configuration.

    • Choose one of the listed network interfaces.

    • Configure interface parameters on this screen as needed, such as a static IP address.

      Note

      The default behavior is to use DHCP to obtain the interface address. If this is the desired behavior, then leave the address options as-is.

    • Enter 7 to enable Connect automatically after reboot.

    • Enter 8 to enable Apply configuration in installer.

    • Enter c to complete the interface configuration and continue back to the interface list.

    • Enter c again to exit the network configuration.

  15. Once all options with [!] have been resolved, enter b from the main menu to begin the installation. Messages are displayed indicating the progress of the installation. When the installer finishes its tasks, it displays message that says Installation complete. Press return to quit. At that point, press Enter and the system will reboot.

    Note

    The installer may spend several minutes displaying the message Performing post-installation setup tasks, but it will eventually continue.

  16. When the system is restarting, remove the DVD or USB drive while the system reboots. CentOS 7 will start up automatically from the disk to which it was installed. If the installation media remains inserted, the system may boot into the installer again.

    Note

    The boot options in the system BIOS may need changed if it does not boot automatically into CentOS 7.

  17. After the system finishes rebooting, log in with the user and password chosen during the installation.

Note

Once the system reboots, network interfaces not configured in the installer will be disabled in CentOS. Depending on the hardware, these interfaces may automatically be enabled in TNSR. If TNSR does not see any interfaces, they will need to be manually configured in TNSR. See Setup NICs in Dataplane for details.

Tip

One network interface should be enabled in the host OS as a management interface to allow access to the system for troubleshooting or maintenance. This can be configured in the installer, as mentioned above, or afterward.

Warning

Once the Host OS is capable of reaching the Internet, check for updates (Updating TNSR) before proceeding. This ensures the security and integrity of the router before TNSR interfaces are exposed to the Internet.

Before continuing on, check the next section for hardware-specific installation guidance. Certain hardware may require additional configuration before it is usable by TNSR.