Netgate Discussion Forum
    • Categories
    • Recent
    • Tags
    • Popular
    • Users
    • Search
    • Register
    • Login

    Clarification on using USB stick during installation to restore backup.

    Problems Installing or Upgrading pfSense Software
    11
    35
    4.8k
    Loading More Posts
    • Oldest to Newest
    • Newest to Oldest
    • Most Votes
    Reply
    • Reply as topic
    Log in to reply
    This topic has been deleted. Only users with topic management privileges can see it.
    • jimpJ
      jimp Rebel Alliance Developer Netgate @SteveITS
      last edited by

      @steveits said in Clarification on using USB stick during installation to restore backup.:

      The recover from existing installation didn't work either. "Choose Recover config.xml when the option appears" did not appear that I saw so the installer just overwrite the drive. (which had a valid config file but the OS was broken from a failed upgrade). At what point does that appear? (https://docs.netgate.com/pfsense/en/latest/solutions/sg-3100/reinstall-pfsense.html, "run recovery," choose the (only) eMMC disk, and it finishes)

      The ARM recovery images are not an "installer" in the same way that works for amd64 systems. The ARM recovery images lack config.xml recovery features as they use a completely different mechanism to get the OS onto the target disk.

      The ECL method still works there, however, you need to leave the USB drive with the FAT partition plugged in while it boots off its internal disk: https://docs.netgate.com/pfsense/en/latest/backup/restore-during-install.html#restore-using-the-external-configuration-locator-ecl

      Remember: Upvote with the ๐Ÿ‘ button for any user/post you find to be helpful, informative, or deserving of recognition!

      Need help fast? Netgate Global Support!

      Do not Chat/PM for help!

      N S 2 Replies Last reply Reply Quote 0
      • N
        NRgia @jimp
        last edited by

        @jimp said in Clarification on using USB stick during installation to restore backup.:

        @steveits said in Clarification on using USB stick during installation to restore backup.:

        The recover from existing installation didn't work either. "Choose Recover config.xml when the option appears" did not appear that I saw so the installer just overwrite the drive. (which had a valid config file but the OS was broken from a failed upgrade). At what point does that appear? (https://docs.netgate.com/pfsense/en/latest/solutions/sg-3100/reinstall-pfsense.html, "run recovery," choose the (only) eMMC disk, and it finishes)

        The ARM recovery images are not an "installer" in the same way that works for amd64 systems. The ARM recovery images lack config.xml recovery features as they use a completely different mechanism to get the OS onto the target disk.

        The ECL method still works there, however, you need to leave the USB drive with the FAT partition plugged in while it boots off its internal disk: https://docs.netgate.com/pfsense/en/latest/backup/restore-during-install.html#restore-using-the-external-configuration-locator-ecl

        For AMD64 USB memstick images it should work? Or only for ISO images only. Right now in my example it's ignoring the config.xml if it's on the same drive. It works only if the config.xml it's on another separate USB drive.

        jimpJ 1 Reply Last reply Reply Quote 0
        • jimpJ
          jimp Rebel Alliance Developer Netgate @NRgia
          last edited by

          @nrgia It should work from the extra FAT partition on the amd64 installer memstick (VGA, serial, or ADI). The ISO is for optical media or VMs and doesn't have a FAT partition.

          Remember: Upvote with the ๐Ÿ‘ button for any user/post you find to be helpful, informative, or deserving of recognition!

          Need help fast? Netgate Global Support!

          Do not Chat/PM for help!

          N 1 Reply Last reply Reply Quote 0
          • N
            NRgia @jimp
            last edited by

            @jimp said in Clarification on using USB stick during installation to restore backup.:

            @nrgia It should work from the extra FAT partition on the amd64 installer memstick (VGA, serial, or ADI). The ISO is for optical media or VMs and doesn't have a FAT partition.

            Ok, then it's ignoring the config.xml from the extra FAT partition. I tried it yesterday with pfSense 2.7.0 memstick image.

            1 Reply Last reply Reply Quote 0
            • S
              SteveITS Galactic Empire @jimp
              last edited by

              @jimp said in Clarification on using USB stick during installation to restore backup.:

              ARM recovery images lack config.xml recovery features

              Ah, that explains not seeing the option. Netgate might add a note to that section saying it doesn't apply to ARM. In my case I had backups so it wasn't a big deal, but it sounds like if one has SSH access it's best to grab the config file contents before reinstall.

              ECL method still works there, however, you need to leave the USB drive with the FAT partition plugged in while it boots off its internal disk

              Hmm, that sounds awfully similar to the "during install" process:

              • Boot the install media (Memstick, disc, etc)
              • Install to the target disk
              • Reboot the firewall
              • Remove the USB drive only AFTER the firewall has begun to reboot

              So I did leave the stick in place. However this last bullet makes it sound like it does need a second USB stick:

              • Remove the install media as well at this point

              Pre-2.7.2/23.09: Only install packages for your version, or risk breaking it. Select your branch in System/Update/Update Settings.
              When upgrading, allow 10-15 minutes to restart, or more depending on packages and device speed.
              Upvote ๐Ÿ‘ helpful posts!

              jimpJ 1 Reply Last reply Reply Quote 0
              • N
                NRgia @chrcoluk
                last edited by

                @chrcoluk said in Clarification on using USB stick during installation to restore backup.:

                Hi

                So changed storage in my home pfSense, and I made config backup before I started, made install usb stick using img with rufus, this had a visible fat32 partition with the efi folder inside it.

                I made a conf folder and placed the backup config in there named config.xml.

                I proceeded to install pfSense with this usb stick as the installer, and on first bootup could see it didnt restore the config.

                Documentation here.

                https://docs.netgate.com/pfsense/en/latest/backup/restore-during-install.html

                I then noticed further down it says you can also restore during any bootup, but using a config folder instead of conf, this one did actually work.

                So is it possible its a typo for the during install and should be config for that as well? or did I hit another problem?

                From the OP's signature I see that he has a Qotom Q355G4 with an Intel I5. His steps refers to Amd64 boxes, and he refers that he cannot restore the config during the install process, as it's described in the documentation. I followed the same steps, and I confirm that it's not working. So either the code needs to be changed or the documentation.

                1 Reply Last reply Reply Quote 0
                • S
                  SteveITS Galactic Empire @chrcoluk
                  last edited by

                  @chrcoluk said in Clarification on using USB stick during installation to restore backup.:

                  using a config folder instead of conf

                  Ah, I read right over that. That would explain why the ECL method didn't work for me, and the "during install" with the /conf directory doesn't work on ARM.

                  Pre-2.7.2/23.09: Only install packages for your version, or risk breaking it. Select your branch in System/Update/Update Settings.
                  When upgrading, allow 10-15 minutes to restart, or more depending on packages and device speed.
                  Upvote ๐Ÿ‘ helpful posts!

                  1 Reply Last reply Reply Quote 0
                  • jimpJ
                    jimp Rebel Alliance Developer Netgate
                    last edited by

                    Do not use Rufus, use Etcher. The EFI partition is NOT the FAT partition used to read config.xml.

                    The correct FAT partition would be labeled PFSENSE and it would contain LICENSE.txt and README.txt.

                    I just wrote out a 2.6.0 memstick with Etcher and it had the correct partition present.

                    Remember: Upvote with the ๐Ÿ‘ button for any user/post you find to be helpful, informative, or deserving of recognition!

                    Need help fast? Netgate Global Support!

                    Do not Chat/PM for help!

                    N C 3 Replies Last reply Reply Quote 1
                    • jimpJ
                      jimp Rebel Alliance Developer Netgate @SteveITS
                      last edited by

                      @steveits said in Clarification on using USB stick during installation to restore backup.:

                      @jimp said in Clarification on using USB stick during installation to restore backup.:

                      ARM recovery images lack config.xml recovery features

                      ECL method still works there, however, you need to leave the USB drive with the FAT partition plugged in while it boots off its internal disk

                      Hmm, that sounds awfully similar to the "during install" process:

                      • Boot the install media (Memstick, disc, etc)
                      • Install to the target disk
                      • Reboot the firewall
                      • Remove the USB drive only AFTER the firewall has begun to reboot

                      ECL runs on every boot, not just install. It also has slightly different naming requirements, which are outlined in the doc I linked.

                      So I did leave the stick in place. However this last bullet makes it sound like it does need a second USB stick:

                      • Remove the install media as well at this point

                      It works both ways during install, it checks every FAT partition it can find.

                      Remember: Upvote with the ๐Ÿ‘ button for any user/post you find to be helpful, informative, or deserving of recognition!

                      Need help fast? Netgate Global Support!

                      Do not Chat/PM for help!

                      1 Reply Last reply Reply Quote 0
                      • N
                        NRgia @jimp
                        last edited by

                        @jimp said in Clarification on using USB stick during installation to restore backup.:

                        Do not use Rufus, use Etcher. The EFI partition is NOT the FAT partition used to read config.xml.

                        The correct FAT partition would be labeled PFSENSE and it would contain LICENSE.txt and README.txt.

                        I just wrote out a 2.6.0 memstick with Etcher and it had the correct partition present.

                        Indeed I used Rufus, and it created another FAT partition containing what you said. I will try again with Etcher. At least nobody will do that mistake again. I will confirm later. Thanks

                        1 Reply Last reply Reply Quote 0
                        • jimpJ
                          jimp Rebel Alliance Developer Netgate
                          last edited by

                          Another possible sticking point is after you write the USB drive you may have to remove it from the system and plug it back in before it sees all of the partitions.

                          Remember: Upvote with the ๐Ÿ‘ button for any user/post you find to be helpful, informative, or deserving of recognition!

                          Need help fast? Netgate Global Support!

                          Do not Chat/PM for help!

                          N 1 Reply Last reply Reply Quote 0
                          • N
                            NRgia @jimp
                            last edited by

                            @jimp said in Clarification on using USB stick during installation to restore backup.:

                            Another possible sticking point is after you write the USB drive you may have to remove it from the system and plug it back in before it sees all of the partitions.

                            If you where responding to me I don't understand what you meant. After the FAT partition is also created, I copy the config.xml file to that partition. So if I can copy something to it, it sees it. Also from the boot manager I can see 2 partitions, and I can choose either of them. Normally it only from one of them. But the information is there. I will try with Etcher instead.

                            1 Reply Last reply Reply Quote 0
                            • jimpJ
                              jimp Rebel Alliance Developer Netgate
                              last edited by

                              On some operating systems it won't refresh the disk partitions after writing, depending on how it was written. Unplug the USB drive and plug it back in and you will know for certain it's re-reading the partition table properly. You might think you are seeing the right one, but the list may not be complete.

                              Remember: Upvote with the ๐Ÿ‘ button for any user/post you find to be helpful, informative, or deserving of recognition!

                              Need help fast? Netgate Global Support!

                              Do not Chat/PM for help!

                              N 1 Reply Last reply Reply Quote 0
                              • N
                                NRgia @jimp
                                last edited by NRgia

                                @jimp said in Clarification on using USB stick during installation to restore backup.:

                                On some operating systems it won't refresh the disk partitions after writing, depending on how it was written. Unplug the USB drive and plug it back in and you will know for certain it's re-reading the partition table properly. You might think you are seeing the right one, but the list may not be complete.

                                Ok, just tried it.

                                OS: Manjaro Linux (previously Win 10)
                                Flashing tool: balenaEtcher v.1.7.7 (previously Rufus)

                                1. I unmounted and remounted the USB stick.
                                2. Created a conf directory where I copied the config.xml
                                3. Booted the pfSense box from USB installation media.
                                4. Installed pfSense.
                                5. Selected Reboot at the end of the installation.
                                6. During POST I removed the installation media, otherwise we have the ECL case.

                                Actual: No configuration has been restored, and pfSense asks me to reconfigure the Networks, define which interface is WAN, LAN, the user/password is set to default.

                                Expected:
                                The user configuration from /conf/config.xml should be restored during installation phase.

                                MrPeteM 1 Reply Last reply Reply Quote 0
                                • MrPeteM
                                  MrPete @NRgia
                                  last edited by

                                  @nrgia said in Clarification on using USB stick during installation to restore backup.:

                                  Ok, just tried it.
                                  ...
                                  6) During POST I removed the installation media, otherwise we have the ECL case.

                                  Actual: No configuration has been restored, and pfSense asks me to reconfigure the Networks, define which interface is WAN, LAN, the user/password is set to default.

                                  Expected:
                                  The user configuration from /conf/config.xml should be restored during installation phase.

                                  So, this IS a point of at least confusion or uncertainty.

                                  @jimp QUESTION: are we SURE that autoconfig-during-install is NOT at all dependent on the ECL process?

                                  Here's how I do my installs:

                                  • Set system to boot from internal drive if possible
                                  • Do a one-time boot from install USB (or if not available, wipe the internal boot drive)
                                  • Do the USB install
                                  • Leave USB stick in for at least the first reboot.

                                  Even the ECL process link shared by @jimp says "If this is the first boot post-installation, then this process also triggers reinstallation of packages listed in the restored configuration."

                                  I suspect pfSense does NOT self-reconfigure based on reading config.xml during the install-time boot, but instead during the next boot. But I'm not certain of that.

                                  S 1 Reply Last reply Reply Quote 0
                                  • S
                                    SteveITS Galactic Empire @MrPete
                                    last edited by

                                    @mrpete Do you copy the config file to both /conf/config.xml and /config/config.xml? The two procedures use different locations.

                                    Pre-2.7.2/23.09: Only install packages for your version, or risk breaking it. Select your branch in System/Update/Update Settings.
                                    When upgrading, allow 10-15 minutes to restart, or more depending on packages and device speed.
                                    Upvote ๐Ÿ‘ helpful posts!

                                    MrPeteM 1 Reply Last reply Reply Quote 0
                                    • stephenw10S
                                      stephenw10 Netgate Administrator
                                      last edited by

                                      I've done this many times and I expect it to boot into the recovered config. You should not have to reboot again unless you had a package that required it after install.

                                      Steve

                                      noplanN 1 Reply Last reply Reply Quote 0
                                      • noplanN
                                        noplan @stephenw10
                                        last edited by

                                        @stephenw10

                                        OK gonna test it tomorrow cuz I am not able to remember if I disconnected the stick after the first reboot....

                                        Da mm n getting old sucks....

                                        1 Reply Last reply Reply Quote 0
                                        • C
                                          chrcoluk @jimp
                                          last edited by

                                          @jimp said in Clarification on using USB stick during installation to restore backup.:

                                          Do not use Rufus, use Etcher. The EFI partition is NOT the FAT partition used to read config.xml.

                                          The correct FAT partition would be labeled PFSENSE and it would contain LICENSE.txt and README.txt.

                                          I just wrote out a 2.6.0 memstick with Etcher and it had the correct partition present.

                                          I can confirm I am using AMD64.

                                          I will be installing 2.6.0 soon so I get the new ZFS layout, I will write the image with Etcher when I do this and report back. :)

                                          pfSense CE 2.7.2

                                          1 Reply Last reply Reply Quote 0
                                          • MrPeteM
                                            MrPete @SteveITS
                                            last edited by

                                            @steveits Actually I only place it in the root these days.

                                            1 Reply Last reply Reply Quote 0
                                            • First post
                                              Last post
                                            Copyright 2025 Rubicon Communications LLC (Netgate). All rights reserved.