mirrors/serenity
1
0
Fork 0
mirror of https://github.com/SerenityOS/serenity.git synced 2025-01-22 17:31:58 -05:00
Code Issues Projects Releases Packages Wiki Activity

Documentation: Add Serenity installation guide for VMware

Browse source
This commit is contained in:
Brendan Coles 2021-03-10 06:48:11 +00:00 committed by Andreas Kling
parent 54f6436598
commit 0e18c7ffda
2 changed files with 36 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
Documentation/BuildInstructions.md
View file

@ -187,7 +187,7 @@ On Linux, QEMU is significantly faster if it's able to use KVM. The run script w
Bare curious users may even consider sourcing suitable hardware to [install Serenity on a physical PC.](https://github.com/SerenityOS/serenity/blob/master/Documentation/INSTALL.md)
Outside of QEMU, Serenity will run on VirtualBox. If you're curious, see how to [install Serenity on VirtualBox.](https://github.com/SerenityOS/serenity/blob/master/Documentation/VirtualBox.md)
Outside of QEMU, Serenity will run on VirtualBox and VMware. If you're curious, see how to [install Serenity on VirtualBox](https://github.com/SerenityOS/serenity/blob/master/Documentation/VirtualBox.md) or [install Serenity on VMware](https://github.com/SerenityOS/serenity/blob/master/Documentation/VMware.md).
Later on, when you `git pull` to get the latest changes, there's (usually) no need to rebuild the toolchain. You can simply run `ninja install`, `ninja image`, and `ninja run` again. CMake will only rebuild those parts that have been updated.

35
Documentation/VMware.md Normal file
View file

@ -0,0 +1,35 @@
# Serenity installation guide for VMware
## NOTICE
There are currently issues with running Serenity in VMware. Please refer to the [open issue](https://github.com/SerenityOS/serenity/issues/5716) for a list of currently known issues. Anything that doesn't currently work will be noted in this document.
## Creating the disk image
Before creating a disk image that will work in VMware, you will need to create a GRUB image as described in the [Serenity installation guide](https://github.com/SerenityOS/serenity/blob/master/Documentation/INSTALL.md). Please skip the final step of that section, as that is only relevant for putting the image onto a real drive. You **cannot** use the same disk image created for QEMU. Using that image will halt immediately with the message ``FATAL: No bootable medium found! System halted.``
The easiest way to convert the disk image is with QEMU:
``
qemu-img convert -O vmdk /path/to/grub_disk_image /path/to/output/serenityos.vmdk
``
## Creating the virtual machine
Creating a SerenityOS virtual machine is similar to any other virtual machine. The main difference is using the already created VMDK disk image.
**Please note that these instructions were written with VMware Player 15 in mind. Therefore, these instructions may not match exactly for past and future versions or VMware Workstation.**
1. Open the **Create a New Virtual Machine** dialog. Select **I will install the operating system later**.
2. Choose **Other** as the guest operating system.
3. Feel free to give it any name and store it anywhere.
4. Choose any size for the hard disk. This disk will later be removed and replaced with the converted GRUB image from the previous stage.
5. Select **Finish** to finalize creation of the virtual machine.
6. Select the newly created virtual machine and click **Edit virtual machine settings**.
7. Serenity requires at minimum 32 MB of memory. Set **Memory for this virtual machine** equal to or above 32 MB. The currently recommended size is 256 MB. Please note that Serenity is currently a 32-bit system, so anything above the ~3.5 GB mark will not be recognized.
8. Select the existing **Hard Disk** and click **Remove**.
9. Select **Add**, select **Hard Disk**, select **IDE (Recommended)**, select **Use an existing virtual disk**.
10. Click **Browse** and browse to where you stored the converted VMDK disk image from the previous stage and add it. Click **Finish**.
11. Finally click **Save**. You can now **Power On** the virtual machine.
Please note that at the time of writing, audio and networking do not work in VMware.
That is all you need to boot Serenity in VMware!