Project

General

Profile

Correction #9089

ECL can't locate config.xml unless USB device is partitioned

Added by Adam Thompson 7 months ago. Updated 7 months ago.

Status:
Resolved
Priority:
Normal
Assignee:
Category:
Backup / Restore
Target version:
-
Start date:
11/02/2018
Due date:
% Done:

0%

Estimated time:
Affected Documentation:
pfSense Documentation site (Wiki)

Description

The glob() pattern in source:src/etc/ecl.php#L40 's get_disk_slices() implicitly limits the function to finding config.xml only on devices that have been formatted with a partition table (i.e. have slices).
In Microsoft Windows, smaller USB flash drives do not always have a partition table; the raw device is sometimes formatted, much like a floppy disk would be.
I can think of a few ways to handle this in the code, but frankly the easiest way to "fix" it is just to amend the documentation, especially given that it's no longer the common case.
I can attest that it's not all that rare, as the first two USB flash drives I tested with today, picked up out a pile of random drives, were both raw-device-formatted, not partitioned.

I'm not familiar with RST syntax, but I think the diff could look something like this (taken against HEAD today):


diff --git a/source/backup/automatically-restore-during-install.rst b/source/backup/automatically-restore-during-install.rst
index 354f4dd..26eb83f 100644
--- a/source/backup/automatically-restore-during-install.rst
+++ b/source/backup/automatically-restore-during-install.rst
@@ -39,6 +39,10 @@ target drive.

 * First, make sure to have a ``config.xml`` backup from the old firewall
 * On a DOS/FAT formatted USB drive, make a directory called ``conf``
+
+  .. note:: The USB device must have a partition table, and not formatted as
+   as raw device for this to function correctly.
+
 * Copy a backup configuration file to the ``conf`` directory
 * Rename the backup to ``config.xml``

History

#1 Updated by Jim Pingle 7 months ago

  • Tracker changed from Bug to Correction
  • Project changed from pfSense to pfSense Docs
  • Category changed from Installer to Backup / Restore
  • Assignee set to Jim Pingle
  • Affected Version deleted (2.4.4)
  • Affected Documentation pfSense Documentation site (Wiki) added

#2 Updated by Jim Pingle 7 months ago

  • Status changed from New to Resolved

Fixed.

Also available in: Atom PDF