Reinstalling pfSense Plus Software

  1. Please open a TAC ticket to request access to the Plus firmware by selecting Firmware Access as the General Problem and then select Netgate 3100 for the platform. Include the Netgate Device ID (NDI) and serial number in the ticket to expedite access.

    Once the ticket is processed, the latest stable version of the firmware will be attached to the ticket, with a name such as:

    pfSense-plus-Netgate-3100-recovery-24.03-RELEASE-armv7.img.gz

    Note

    pfSense® Plus is preinstalled on Netgate appliances, which is optimally tuned for Netgate hardware and contains features that cannot be found elsewhere, such as ZFS Boot Environments, OpenVPN DCO, and the AWS VPC Wizard.

  2. Write the image to a USB memstick (8GB or larger).

    See also

    Locating the image and writing it to a USB memstick is covered in detail under Writing Flash Drives.

    Tip

    Remove and reinsert the memstick and the workstation will see a FAT partition on the drive. Place a configuration backup file on this drive as config.xml to restore later using the External Configuration Locator.

  3. Connect to the console port of the Netgate device.

  4. Insert the memstick into the USB port and boot the system.

    Tip

    The best practice is to connect to the console, turn off the device gracefully by using the Halt system option from the console and removing power once the shutdown procedure completes, then insert the USB memstick and boot the device.

    Starting the recovery process requires interrupting the boot process very soon after the boot process begins, so having an active console connection before booting is important.

  5. When prompted, press any key to stop the autoboot process.

    ../_images/3100-reinstall-01-autoboot.png
  6. Type run recovery at the Marvell>> prompt and press Enter.

    ../_images/3100-reinstall-02-runrecover.png

    Note

    If the device does not boot after issuing this command, enter usb reset and then try run recovery again. Some USB drives require an extra reset to fully initialize.

  7. Enter the destination device or press the Enter key to accept the default value.

    ../_images/3100-reinstall-03-device.png

    Note

    The onboard eMMC flash memory is always mmcsd0. If a M.2 SATA drive is installed in either slot, it will be ada0.

    Warning

    Only one M.2 SATA slot can be populated with a storage device. The device does not support two M.2 SATA drives installed simultaneously.

  8. Type y then press the Enter key to confirm the choice.

  9. Wait for the installation to complete.

    ../_images/3100-reinstall-04-wait.png
  10. Once the install has completed, remove the memstick, and cycle the power (unplug the Netgate 3100 and plug it back in) to reboot the Netgate 3100.

    Tip

    If the FAT parition on the memstick contains a configuration file to restore using the ECL method, leave the memstick plugged in while cycling the power.

    ../_images/3100-reinstall-05-reboot.png

See also

For information on restoring from a previously saved configuration, go to Backup and Restore.

Caution

If this device contains multiple disks, such as when adding an SSD to an existing system which previously used MMC, additional steps may be necessary to ensure the device boots from and uses the correct disk. Furthermore, having separate installations of the software on different disks is a known source of problems. For example, the kernel could boot from one disk while the root filesystem is loaded from another, or they could contain conflicting ZFS pools.

In some cases it is possible to adjust the BIOS boot order to prefer the new disk, but the best practice is to wipe the old disk to remove any chance of the previous installation causing boot issues or conflicts.

For information on how to wipe the old disk, see Multiple Disk Boot Issues.