Differences

This shows you the differences between two versions of the page.

--- documentation:end-users_docs [2020/01/16 17:58] – [Enabling crash dump] olivier
+++ documentation:end-users_docs [2024/10/18 01:31] (current) – [Installation] olivier
@@ Line 4: / Line 4: @@
 ===== Hardware Compatibility List =====
-For BSDRP you need:
+To run BSDRP, you will need:
-  * a 2GB flash disk (Compact Flash, USB stick, mSATA flash module, etc.).
+  * A 4GB flash disk (such as Compact Flash, USB stick, or mSATA module).
-  * a minimum of 512MB RAM.
+  * At least 1GB of RAM.
-[[https://www.freebsd.org/releases/12.1R/hardware.html|All hardware supported by FreeBSD 12.1]] are supported by BSDRP with the exception of following drivers:
+All hardware supported by the latest FreeBSD release is compatible with BSDRP, except for some drivers that have been removed (e.g., wireless, PCMCIA, SCSI, USB printer, and FireWire).
-Wireless, PCMCIA cards, SCSI adapters, USB printer, fire wire, etc. drivers were removed from the FreeBSD kernel.
 ===== Filename convention =====
-The BSDRP images use this filename convention:
+BSDRP image filenames follow this pattern:
 BSDRP_//release//_//image type//_//arch//_//console//.img.xz
 The value //image type// can be:
-  * full : To be used for installing BSDRP. This image contain full BSDRP filesystem (bootloader, 2 systems partitions, cfg partition and data partition)
+  * full : For full installation, includes the bootloader, system, and data partitions.
-  * upgrade : To be used for upgrading BSDRP. This image contain only one system partition.
+  * upgrade : For system upgrades, includes only one system partition
 The value //arch// can be:
-  * i386 : for i486, i586 and i686 CPU
+  * i386 : For older x86 CPUs (i486, i586, i686).
-  * amd64 : for all x86-64 CPU (amd64 or intel 64)
+  * amd64 : For modern x86 64-bit CPUs (Intel and AMD)
 The value //console// can be:
-  * vga: To be used with a vga card and keyboard as default console (but it's still possible to connect to the serial port)
+  * vga: For VGA and keyboard use or KVM, but serial port is also accessible.
-  * serial: For headless use, use only serial port as default console
+  * serial: For headless systems using only the serial port.
 Examples:
-  * BSDRP_0.3_full_i386_vga.img, means full image, for arch i386, with keyboard/vga as console.
+  * BSDRP_0.3_full_i386_vga.img: Full image for i386, VGA console.
-  * BSDRP_0.3_upgrade_amd64_serial.img, means upgrade image, for arch amd64 on headless serial.
+  * BSDRP_0.3_upgrade_amd64_serial.img: Upgrade image for amd64, serial console.
 The *.mtree.xz files are used for system integrity check.
@@ Line 41: / Line 39: @@
 == Windows users ==
-Here are the 2 steps for writing the image to a CF/USB removable media:
+Here are the 2 steps for writing the image to a CF/flasg/USB removable media:
-  - Decompress the BSDRP image file [[http://www.7-zip.org/|7-Zip]]: You need to obtain a file with .img extension.
+  - Decompress the BSDRP image using [[http://www.7-zip.org/|7-Zip]] to get a .img file.
-  - Use [[http://win32diskimager.sourceforge.net/|Image Writer for Windows]] for writing the image file .img (**and not the file with .xz extension**) on your CF/USB connected to your PC.
+  - Use [[http://win32diskimager.sourceforge.net/|Image Writer for Windows]] to write the .img file to your CF/flash/USB device.
 == *BSD or Linux users ==
-Connect your Compact Flash or USB disk and write down the device name (can be 'sd4' for an usb key under Linux or 'da0' under FreeBSD as exemple).
+Connect your flash or USB drive and note its device name.
+Decompress the image and copy it to your drive using a byte copy command.
-Then unzip the file and byte copy it to your drive (**Warning: Double check that you had choosen the good destination disk!!!**):
+Then unzip the file and byte copy it to your drive (**Warning: Be sure to double-check the destination disk!**):
 <code>
 xzcat BSDRP_full_amd64_vga.1.0.img.xz | dd of=/dev/sd4 bs=256k
@@ Line 58: / Line 56: @@
 == Mac OS X users ==
-Insert the USB key, and run mount in a terminal (or disk utility if you prefer graphical method) to see what device OSX has assigned to your USB key. You should see something like this:
+Insert the USB key, and display list of external devices:
+<code>
+% diskutil list | grep external
+/dev/disk3 (external, physical):
+</code>
+Check if it is already mounted
 <code>
+% mount | grep '/dev/disk3'
 /dev/disk0s2 on / (hfs, local, journaled)
 devfs on /dev (devfs, local)
@@ Line 68: / Line 74: @@
 /dev/disk3s1 on /Volumes/UNTITLED (msdos, local, nodev, nosuid, noowners)
 </code>
-The last line is your USB device. Unmount it and write the BSDRP image to it with:
+The last line is your USB device. Unmount it and write the BSDRP image to the device adding the 'r' letter:
 <code>
 sudo umount -f /dev/disk3s1
-xzcat BSDRP_full_amd64_vga.1.0.img.xz | dd of=/dev/disk3 bs=256k
+xzcat BSDRP_full_amd64_vga.1.0.img.xz | sudo dd of=/dev/rdisk3 bs=1m
 </code>
-If successful, OSX will pop up an error dialog telling you it doesn't recognize the disk. Click 'Eject', remove the USB key, and you're done.
+If successful, OSX will pop up an error dialog telling you it doesn't recognise the disk. Click 'Eject', remove the USB key, and you're done.
 === To an hard drive ===