Adapt instructions for VirtualBox 87/25987/2 10.93.1 11.0.0 koi/10.93.1 koi/11.0.0 koi_10.93.1 koi_11.0.0
authorJan-Simon Möller <jsmoeller@linuxfoundation.org>
Tue, 2 Feb 2021 17:51:39 +0000 (18:51 +0100)
committerJan-Simon Moeller <jsmoeller@linuxfoundation.org>
Wed, 3 Feb 2021 11:23:03 +0000 (11:23 +0000)
This is due to https://www.virtualbox.org/ticket/19873?cversion=0&cnum_hist=4

Adapt the documentation to deal with the resolution issue.

Bug-AGL: SPEC-3731
Signed-off-by: Jan-Simon Möller <jsmoeller@linuxfoundation.org>
Change-Id: I6ff56593d1064d44dc5ab972d8e3475003a91f36
Reviewed-on: https://gerrit.automotivelinux.org/gerrit/c/AGL/documentation/+/25987

docs/0_Getting_Started/1_Quickstart/Using_Ready_Made_Images.md

index fc1eb44..9f467e7 100644 (file)
@@ -75,7 +75,8 @@ AGL provides a number of pre-built ready-made images of various versions.
 
 ### 2. Virtual Box (Emulation)
 
-    **NOTE :** Please see https://jira.automotivelinux.org/browse/SPEC-3731 .
+**NOTE :** Please note [https://www.virtualbox.org/ticket/19873](https://www.virtualbox.org/ticket/19873) as this affects the VMs resolution.
+The AGL demo images do require 1920x1080. The instructions below have been adapted.
 
   1. Download the [compressed vbox disk image](https://download.automotivelinux.org/AGL/release/koi/latest/qemux86-64/deploy/images/qemux86-64/agl-demo-platform-crosssdk-qemux86-64.wic.vmdk.xz).
 
@@ -98,7 +99,11 @@ AGL provides a number of pre-built ready-made images of various versions.
     - Go to `Storage`, and change the attribute to `Type : AHCI` and click on `OK`.
     ![vbox-step-5](images/vbox-5.png)
     - Next go to `Display` and change the attribute to 'VMSVGA' for the graphics driver. Change the graphics memory to be at least 64MB.
-    - Click on `Start`.
+    - **Important:**: Open a new terminal window and execute this command:
+    ```sh
+    VBoxManage setextradata agl-demo VBoxInternal2/EfiGraphicsResolution 1920x1080
+    ```
+    - Return to the UI and click on `Start`.
     - For troubleshooting, you can refer [here](https://lists.automotivelinux.org/g/agl-dev-community/message/8474).
 
 ### 3. x86 physical system