git: 61d1d667c7 - main - Handbook - Virtualization: Upgrade Parallels installation steps

From: Sergio Carlavilla Delgado <>
Date: Sun, 09 Apr 2023 17:45:40 UTC
The branch main has been updated by carlavilla:


commit 61d1d667c7a72169cd96d4b46314d297731e9596
Author:     Minsoo Choo <>
AuthorDate: 2023-04-09 17:43:42 +0000
Commit:     Sergio Carlavilla Delgado <>
CommitDate: 2023-04-09 17:43:42 +0000

    Handbook - Virtualization: Upgrade Parallels installation steps
    Reviewed by:    carlavilla@ made some tweaks and format with
                    one sentence per line
    PR:                     257618
    Differential Revision:
 .../en/books/handbook/virtualization/_index.adoc   |  55 ++++++++-------------
 .../handbook/virtualization/parallels-freebsd1.png | Bin 62972 -> 705979 bytes
 .../handbook/virtualization/parallels-freebsd2.png | Bin 68151 -> 603138 bytes
 .../handbook/virtualization/parallels-freebsd3.png | Bin 76742 -> 591697 bytes
 .../handbook/virtualization/parallels-freebsd4.png | Bin 87403 -> 502689 bytes
 .../handbook/virtualization/parallels-freebsd5.png | Bin 57191 -> 514080 bytes
 .../handbook/virtualization/parallels-freebsd6.png | Bin 89874 -> 484946 bytes
 .../handbook/virtualization/parallels-freebsd7.png | Bin 69993 -> 1107633 bytes
 8 files changed, 21 insertions(+), 34 deletions(-)

diff --git a/documentation/content/en/books/handbook/virtualization/_index.adoc b/documentation/content/en/books/handbook/virtualization/_index.adoc
index c82a3178a2..d0d47868d7 100644
--- a/documentation/content/en/books/handbook/virtualization/_index.adoc
+++ b/documentation/content/en/books/handbook/virtualization/_index.adoc
@@ -74,7 +74,7 @@ Before reading this chapter, you should:
 == FreeBSD as a Guest on Parallels Desktop for macOS(R)
-Parallels Desktop for Mac(R) is a commercial software product available for Intel(R) based Apple(R) Mac(R) computers running macOS(R) 10.4.6 or higher.
+Parallels Desktop for Mac(R) is a commercial software product available for Intel(R) based Apple(R) Mac(R) computers running macOS(R) 10.14.6 or higher.
 FreeBSD is a fully supported guest operating system.
 Once Parallels has been installed on macOS(R), the user must configure a virtual machine and then install the desired guest operating system.
@@ -82,54 +82,41 @@ Once Parallels has been installed on macOS(R), the user must configure a virtual
 === Installing FreeBSD on Parallels Desktop on Mac(R)
 The first step in installing FreeBSD on Parallels is to create a new virtual machine for installing FreeBSD.
-Select [.guimenuitem]#FreeBSD# as the menu:Guest OS Type[] when prompted:
-image::parallels-freebsd1.png[Parallels setup wizard showing FreeBSD as chosen OS]
+Choose menu:Install Windows or another OS from a DVD or image file[] and proceed.
-Choose a reasonable amount of disk and memory depending on the plans for this virtual FreeBSD instance.
-4GB of disk space and 512MB of RAM work well for most uses of FreeBSD under Parallels:
+image::parallels-freebsd1.png[Parallels setup wizard showing Install Windows or another OS from a DVD or image file chosen]
-image::parallels-freebsd2.png[Parallels setup wizard showing the amount of RAM allocated]
+Select the FreeBSD image file.
-image::parallels-freebsd3.png[Parallels setup wizard showing the disk menu]
+image::parallels-freebsd2.png[Parallels setup wizard showing FreeBSD image file selected]
-image::parallels-freebsd4.png[Parallels setup wizard showing the menu for setting the disk size and type]
+Choose menu:Other as operating system[].
-image::parallels-freebsd5.png[Parallels setup wizard showing the menu for setting the disk location]
-Select the type of networking and a network interface:
-image::parallels-freebsd6.png[Parallels setup wizard showing the network menu]
-image::parallels-freebsd7.png[Parallels setup wizard showing the menu with the network type options]
-Save and finish the configuration:
-image::parallels-freebsd8.png[Parallels setup wizard showing the menu to configure the name of the machine and the directory where to save the configuration]
+Choosing FreeBSD will cause boot error on startup.
-image::parallels-freebsd9.png[Parallels setup wizard indicating that the configuration is complete and asking the user if he wants to start guest OS installation]
+image::parallels-freebsd3.png[Parallels setup wizard showing Other selected as operating system]
-After the FreeBSD virtual machine has been created, FreeBSD can be installed on it.
-This is best done with an official FreeBSD CD/DVD or with an ISO image downloaded from an official FTP site.
-Copy the appropriate ISO image to the local Mac(R) filesystem or insert a CD/DVD in the Mac(R)'s CD-ROM drive.
-Click on the disc icon in the bottom right corner of the FreeBSD Parallels window.
-This will bring up a window that can be used to associate the CD-ROM drive in the virtual machine with the ISO file on disk or with the real CD-ROM drive.
+Name the virtual machine and check menu:Customize settings before installation[]
-image::parallels-freebsd11.png[Parallels showing a summary of the newly created machine with information and actions to execute on the machine]
+image::parallels-freebsd4.png[Parallels setup wizard showing the checkbox checked for customizing settings before installation]
-Once this association with the CD-ROM source has been made, reboot the FreeBSD virtual machine by clicking the reboot icon.
-Parallels will reboot with a special BIOS that first checks if there is a CD-ROM.
+When the configuration window pops up, go to menu:Hardware[] tab, choose menu:Boot order[], and click menu:Advanced[].
+Then, choose *EFI 64-bit* as menu:BIOS[].
-image::parallels-freebsd10.png[Parallels showing the BIOS running]
+image::parallels-freebsd5.png[Parallels setup wizard showing EFI 64-bit chosen as BIOS]
-In this case it will find the FreeBSD installation media and begin a normal FreeBSD installation.
-Perform the installation, but do not attempt to configure Xorg at this time.
+Click menu:OK[], close the configuration window, and click menu:Continue[].
-image::parallels-freebsd12.png[Parallels showing a snippet of the FreeBSD installation process]
+image::parallels-freebsd6.png[Parallels setup wizard showing the summary of the new virtual machine]
-When the installation is finished, reboot into the newly installed FreeBSD virtual machine.
+The virtual machine will automatically boot.
+Install FreeBSD following the general steps.
-image::parallels-freebsd13.png[Parallels showing the boot of FreeBSD]
+image::parallels-freebsd7.png[FreeBSD booted on Parallels]
 === Configuring FreeBSD on Parallels
diff --git a/documentation/static/images/books/handbook/virtualization/parallels-freebsd1.png b/documentation/static/images/books/handbook/virtualization/parallels-freebsd1.png
index 9b9259230c..6dcb724e2b 100644
Binary files a/documentation/static/images/books/handbook/virtualization/parallels-freebsd1.png and b/documentation/static/images/books/handbook/virtualization/parallels-freebsd1.png differ
diff --git a/documentation/static/images/books/handbook/virtualization/parallels-freebsd2.png b/documentation/static/images/books/handbook/virtualization/parallels-freebsd2.png
index 8ef4e74478..890e6af21e 100644
Binary files a/documentation/static/images/books/handbook/virtualization/parallels-freebsd2.png and b/documentation/static/images/books/handbook/virtualization/parallels-freebsd2.png differ
diff --git a/documentation/static/images/books/handbook/virtualization/parallels-freebsd3.png b/documentation/static/images/books/handbook/virtualization/parallels-freebsd3.png
index c114191b5a..13e7ba1c3d 100644
Binary files a/documentation/static/images/books/handbook/virtualization/parallels-freebsd3.png and b/documentation/static/images/books/handbook/virtualization/parallels-freebsd3.png differ
diff --git a/documentation/static/images/books/handbook/virtualization/parallels-freebsd4.png b/documentation/static/images/books/handbook/virtualization/parallels-freebsd4.png
index ae526c8aee..61bcfad4a1 100644
Binary files a/documentation/static/images/books/handbook/virtualization/parallels-freebsd4.png and b/documentation/static/images/books/handbook/virtualization/parallels-freebsd4.png differ
diff --git a/documentation/static/images/books/handbook/virtualization/parallels-freebsd5.png b/documentation/static/images/books/handbook/virtualization/parallels-freebsd5.png
index d13d2b3925..6ee6eee47a 100644
Binary files a/documentation/static/images/books/handbook/virtualization/parallels-freebsd5.png and b/documentation/static/images/books/handbook/virtualization/parallels-freebsd5.png differ
diff --git a/documentation/static/images/books/handbook/virtualization/parallels-freebsd6.png b/documentation/static/images/books/handbook/virtualization/parallels-freebsd6.png
index 78051ab315..75c66b8ff0 100644
Binary files a/documentation/static/images/books/handbook/virtualization/parallels-freebsd6.png and b/documentation/static/images/books/handbook/virtualization/parallels-freebsd6.png differ
diff --git a/documentation/static/images/books/handbook/virtualization/parallels-freebsd7.png b/documentation/static/images/books/handbook/virtualization/parallels-freebsd7.png
index dd4c21524a..bd09dfe3e2 100644
Binary files a/documentation/static/images/books/handbook/virtualization/parallels-freebsd7.png and b/documentation/static/images/books/handbook/virtualization/parallels-freebsd7.png differ