GNOME.org
 

[gnome-build-meta/valentindavid/eos-installer: 39/39] Add instructions for GNOME Boxes

commit 9425323ec955229b2da435c747ce3aca975dba29
Author: Valentin David <valentin david codethink co uk>
Date:   Fri Mar 27 10:13:02 2020 +0100

    Add instructions for GNOME Boxes

 BOOTABLE_IMAGES.md  | 89 +++++++++++++++++++++++++++++++----------------------
 gnome-os-master.xml | 48 +++++++++++++++++++++++++++++
 2 files changed, 101 insertions(+), 36 deletions(-)
---
diff --git a/BOOTABLE_IMAGES.md b/BOOTABLE_IMAGES.md
index 6a4d9140..e477d644 100644
--- a/BOOTABLE_IMAGES.md
+++ b/BOOTABLE_IMAGES.md
@@ -1,6 +1,50 @@
 # Bootable images
 
-## Building and running the image.
+## Building the installer
+
+First run `utils/sign-image.sh` to build and sign the image.
+Then build `iso/image.bst` and checkout the artifact. This will
+contain `installer.iso`.
+
+```
+./utils/sign-image.sh
+bst build iso/image.bst
+bst checkout iso/image.bst checkout
+```
+
+## Running with GNOME Boxes
+
+Copy file gnome-os-master.xml to `$XDG_CONFIG_HOME/osinfo/os/gnome.org/gnome-os-master.xml` for GNOME Boxes.
+
+Using GNOME Boxes devel on flatpak, it will be: 
`~/.var/app/org.gnome.BoxesDevel/config/osinfo/os/gnome.org/gnome-os-master.xml`.
+
+Using GNOME Boxes stable on flatpak, it will be: 
`~/.var/app/org.gnome.Boxes/config/osinfo/os/gnome.org/gnome-os-master.xml`.
+
+Otherwise, `~/.config/osinfo/os/gnome.org/gnome-os-master.xml`
+
+Then create a virtual machine using an "Operating System Image
+File". Select `installer.iso` from the checkout directory.
+
+## Updating with local OSTree
+
+Run helper script: `utils/update-local-repo.sh`. This will create a
+local repository with the current state of working copy.
+
+Then run `utils/run-local-repo.sh` to start a server. This script does
+not fork. Leave it to run.
+
+Open a shell and type `enable-developer-repository`. The server has to
+be running at that time. You do not need to pass any parameter if you
+are running the image in a QEMU with standard configuration for user
+network (`-netdev user`). For other configuration look at
+configuration with `--help`.
+
+If `enable-developer-repository` succeeded, you can then reboot.  Do
+not call `enable-developer-repository` again.  Further updates will be
+done automatically by `eos-updater`. To force update sooner, run
+`eos-updater-ctl update`, or use GNOME Software.
+
+## Building the base image (not installer)
 
 Build `vm/image.bst` and checkout. The image will be `disk.qcow2`.
 
@@ -9,13 +53,15 @@ bst build vm/image.bst
 bst checkout vm/image.bst checkout
 ```
 
+## Running manually with QEMU the base image
+
 Before the first run, copy the UEFI variables image.
 
 ```
 cp /usr/share/OVMF/OVMF_CODE.fd .
 ```
 
-Then run with QEMU:
+Then, run with QEMU:
 
 ```
 qemu-system-x86_64 \
@@ -32,17 +78,7 @@ qemu-system-x86_64 \
 For more explanations on the QEMU command line see section [Using
 QEMU](#using-qemu).
 
-## Using the installer
-
-First run `utils/sign-image.sh` to build and sign the image.
-Then build `iso/image.bst` and checkout the artifact. This will
-contain `installer.iso`.
-
-```
-./utils/sign-image.sh
-bst build iso/image.bst
-bst checkout iso/image.bst checkout
-```
+## Running manually with QEMU the installer
 
 Before the first run, copy the UEFI variables image.
 
@@ -85,30 +121,11 @@ qemu-system-x86_64 \
   -drive file=disk.qcow2,format=qcow2,media=disk
 ```
 
-## Updating with local OSTree
-
-Run helper script: `utils/update-local-repo.sh`. This will create a
-local repository with the current state of working copy.
-
-Then run `utils/run-local-repo.sh` to start a server. This script does
-not fork. Leave it to run.
-
-Open a shell and type `enable-developer-repository`. The server has to
-be running at that time. You do not need to pass any parameter if you
-are running the image in a QEMU with standard configuration for user
-network (`-netdev user`). For other configuration look at
-configuration with `--help`.
-
-If `enable-developer-repository` succeeded, you can then reboot.  Do
-not call `enable-developer-repository` again.  Further updates will be
-done automatically by `eos-updater`. To force update sooner, run
-`eos-updater-ctl update`, or use GNOME Software.
-
-## Using QEMU
+### Using QEMU
 
 <a name="using-qemu"></a>
 
-### UEFI boot
+#### UEFI boot
 
 You need two files, OVMF/EDK2 code and variables.
 
@@ -124,7 +141,7 @@ We assume here we are using x86_64. The paths are:
 Copy the variable file locally. It is needed to be modified. The code
 can stay because it will be read only.
 
-### Creating a hard disk
+#### Creating a hard disk
 
 To create a 64GB disk, for example:
 
@@ -132,7 +149,7 @@ To create a 64GB disk, for example:
 qemu-img create -f qcow2 disk.qcow2 64G
 ```
 
-### QEMU Parameters
+#### QEMU Parameters
 
 4 CPU threads: `-smp 4`
 
diff --git a/gnome-os-master.xml b/gnome-os-master.xml
new file mode 100644
index 00000000..34d6768a
--- /dev/null
+++ b/gnome-os-master.xml
@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<libosinfo version="0.0.1">
+  <os id="http://gnome.org/gnome-os/master";>
+    <name>GNOME OS master</name>
+    <short-id>gnome-os</short-id>
+    <version>master</version>
+    <vendor>GNOME</vendor>
+    <family>linux</family>
+    <distro>gnome</distro>
+
+    <devices>
+      <!-- We need to enable that when we have virtio net -->
+      <!-- <device id="http://pcisig.com/pci/1af4/1041"/> -->
+      <!-- We need to enable that when we have virtio blk pci -->
+      <!-- <device id="http://pcisig.com/pci/1af4/1042"/> -->
+      <device id="http://pcisig.com/pci/1af4/1050"/>
+      <device id="http://pcisig.com/pci/8086/100e"/>
+      <device id="http://pcisig.com/pci/8086/293e"/>
+      <device id="http://qemu.org/chipset/x86/q35"/>
+    </devices>
+
+    <firmware arch="x86_64" type="efi"/>
+
+    <resources arch="all">
+      <minimum>
+        <cpu>1000000000</cpu>
+        <n-cpus>2</n-cpus>
+        <ram>2147483648</ram>
+        <storage>34359738368</storage>
+      </minimum>
+      <recommended>
+        <cpu>1000000000</cpu>
+        <n-cpus>2</n-cpus>
+        <ram>4294967296</ram>
+        <storage>34359738368</storage>
+      </recommended>
+    </resources>
+
+    <media arch="x86_64">
+      <iso>
+        <volume-id>GNOME-OS-INSTALLER</volume-id>
+        <application-id>GNOME OS MASTER X86_64</application-id>
+      </iso>
+    </media>
+
+  </os>
+</libosinfo>
+
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]