summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md48
1 files changed, 16 insertions, 32 deletions
diff --git a/README.md b/README.md
index 7ed4641..5640fa6 100644
--- a/README.md
+++ b/README.md
@@ -1,14 +1,15 @@
-Install Debian using vmdb2 (v-i)
+Install Debian using vmdb2 (v-i) onto my Thinkpad x220 laptop
=============================================================================
WARNING!
-----------------------------------------------------------------------------
-Warning: this is an operating system installer. It will overwrite your
+**Warning:** this is an operating system installer. It will overwrite your
hard drive and annihilate anything that used to be there. There are no
safety rails. You will lose all your data. Make sure your backups
work. You have been warned.
+
Introduction
-----------------------------------------------------------------------------
@@ -16,7 +17,7 @@ This is a hack for my own amusement. It's not meant to be taken
seriously.
This is a rudimentary installer of Debian based on vmdb2. It has
-nothing to do with debian-install, the official Debian installer,
+nothing to do with debian-installer, the official Debian installer,
known as d-i. I use d-i, but would like something better:
* I'd like something I can easily modify. d-i requires building
@@ -29,19 +30,21 @@ known as d-i. I use d-i, but would like something better:
only helps to answer questions the packages ask. v-i lets you have
the full power of Ansible during initial installation.
-On the other hand, d-i is mature software and tested by thousands. v-i
-can just barely install my own Thinkpad x220 laptop.
+On the other hand, d-i is mature software and tested by a very large
+number of people, on a very large number of different hardware. v-i
+can just barely install my own Thinkpad x220 laptop, using UEFI.
-v-i is not currently expected to work with any other hardware.
+v-i is not currently expected to work with any other hardware. It
+might not even work on your x220.
Architecture
-----------------------------------------------------------------------------
-The vmdb2-installer builds a bootable disk image with Debian. The
-image boots with UEFI, and has everything you need to run vmdb2. You
-write the image to a USB drive, boot off that, and run vmdb2 in the
-booted system to install Debian onto the hard drive.
+The vmdb2 installer builds a bootable disk image with Debian. The
+image boots with UEFI, and has vmdb2 installed. You write the image to
+a USB drive, boot off that, and run vmdb2 in the booted system to
+install Debian onto the hard drive.
Thus:
@@ -49,6 +52,9 @@ Thus:
- installer image -> USB drive
- boot from USB drive
- run vmdb2 to install onto laptop hard drive
+ - the /root/x220.sh script does this, and installs a basic Debian
+ system using my Ansible playbooks
+- boot off the laptop hard drive
The image building uses vmdb2 as well. Things get a little recursive.
@@ -77,15 +83,6 @@ To write the resulting v-i.img to a USB drive:
sudo dd if=v-i.img of=/dev/path/to/usb/drive/device status=progress oflag=direct
~~~
-Alternatively, use bmaptool (from bmap-tools), which does the same
-thing as dd but skips holes in sparse files, so it's more efficient
-for disk images:
-
-~~~sh
-bmaptool create v-i.img > v-i.bmap
-sudo bmaptool copy v-i.img /dev/path/to/usb/drive/device
-~~~
-
Plug in the USB drive to the laptop, boot off that. Log into the
installer as root (no password), and run
@@ -95,16 +92,3 @@ installer as root (no password), and run
Reboot laptop from its hard drive and you should have a bare bones
Debian system installed.
-
-
-Virtual test envionment
------------------------------------------------------------------------------
-
-You probably want to test with virtual machines instead of real
-hardware, for convenience.
-
-~~~sh
-apt install qemu-system
-qemu-img create ~/tmp/main.img 10G
-./bootvm ~/tmp/main.img 10G v-i.img
-~~~