From 634ec240207fa0e5b67da5df0e83a438efac1902 Mon Sep 17 00:00:00 2001 From: Leona Date: Wed, 4 May 2016 07:40:07 -0700 Subject: [PATCH] correcting typos and formatting on vm_virtualbox page Signed-off-by: Leona --- source/vm-virtualbox.rst | 48 ++++++++++++++++++---------------------- 1 file changed, 22 insertions(+), 26 deletions(-) diff --git a/source/vm-virtualbox.rst b/source/vm-virtualbox.rst index b4227970..19eddf2b 100644 --- a/source/vm-virtualbox.rst +++ b/source/vm-virtualbox.rst @@ -3,39 +3,36 @@ Using VirtualBox ################ -This section explains how to run Clear Linux inside -VirtualBox_ environment. +This section explains how to run Clear Linux inside a `VirtualBox`_ +environment. Download VirtualBox =================== -Virtualbox is a hypervisor supported by *Oracle**, you can -download it from its official site -https://www.virtualbox.org/wiki/Downloads -and select the operating system you are using, -furthermore you can download its source code. At this point is very -important to download **version 5.0 or grather**, this is in order to -get support for :abbr:`AVX (Advanced Vector Extensions)` feature -that is used in Clear Linux. +VirtualBox is a hypervisor supported by *Oracle**. You can +download it from the `official VirtualBox website`_ and select +the operating system you are using. + +Download **version 5.0 or greater** to ensure support for +the :abbr:`AVX (Advanced Vector Extensions)` needed to run +Clear Linux. Create a virtual machine in VirtualBox ====================================== -1. Download the latest_ Clear linux live version (clear-XXXX-live.img.xz) +#. Download the `latest`_ live version of Clear Linux (clear-XXXX-live.img.xz) from https://download.clearlinux.org/image/. -2. Decompress Clear Linux image. Uncompressed image size is ~ **5GiB**. +#. Decompress the downloaded image. Uncompressed image size is ~ **5GB**. - On Linux :: $ xz -d clear-XXXX-live.img.xz - - On Windows + - On Windows you can use `7zip`_. - You can use 7zip_. - -3. To convert Clear Linux raw image to :abbr:`VDI (VirtualBox Disk Image)` +#. To convert a Clear Linux raw image to :abbr:`VDI (VirtualBox Disk Image)` format, you can use one of the following commands:: $ VBoxManage convertfromraw clear-XXXX-live.img clear-XXXX-live.vdi --format VDI @@ -46,34 +43,33 @@ Create a virtual machine in VirtualBox Note: Be sure you have Virtual box directory in your PATH (i.e.: on Windows - :file:`C:\\Program Files\\Oracle\\VirtualBox`) + :file:`C:\\Program Files\\Oracle\\VirtualBox`). -4. Create virtual machine using the VirtualBox assistant: +#. Create a virtual machine using the VirtualBox assistant: * Type: **Linux** * Version: **Linux 2.6 / 3.x / 4.x (64-bit)** * Attach the virtual disk created in the step number 3 as virtual hard disk file -5. Once it is created, go to settings to enable **EFI support** +#. After it is created, go to settings to enable **EFI support** * System -> Enable EFI (special OSes only) + Run your new VM =============== -Clear Linux comes with VirtualBox kernel modules in a bundle. You can install -these modules using - -.. code:: bash +Clear Linux can support kernel modules for VirtualBox. Install the bundle +that supports these modules with:: # swupd bundle-add virtualbox-guest -In order to use the VirtualBox additions it's necessary to load vboxsf module - -.. code:: bash +And to use the VirtualBox additions, load the ``vboxsf`` module:: # modprobe vboxsf + +.. _official VirtualBox website: https://www.virtualbox.org/wiki/Downloads .. _VirtualBox: https://www.virtualbox.org/ .. _latest: https://download.clearlinux.org/latest .. _7zip: http://www.7-zip.org/