2015-06-08 21:57:45 +00:00
|
|
|
# subiquity
|
2015-07-17 00:12:39 +00:00
|
|
|
> Ubuntu Server Installer
|
2015-06-15 19:12:26 +00:00
|
|
|
|
2017-01-25 22:29:32 +00:00
|
|
|
# Acquire subiquity from source
|
2015-09-28 20:02:51 +00:00
|
|
|
|
2017-01-25 22:29:32 +00:00
|
|
|
`git clone https://github.com/CanonicalLtd/subiquity`
|
2015-09-30 19:01:17 +00:00
|
|
|
|
2017-01-25 22:29:32 +00:00
|
|
|
`cd subiquity && make install_deps`
|
2015-09-28 20:02:51 +00:00
|
|
|
|
|
|
|
# Testing out the Text-UI (TUI)
|
|
|
|
SUbiquity's text UI is is available for testing without actually installing
|
|
|
|
anything to a system or a VM. Subiquity developers make use of this for rapid
|
2017-01-25 22:29:32 +00:00
|
|
|
development. After checking out subiquity you can start it:
|
2015-09-28 20:02:51 +00:00
|
|
|
|
2017-01-25 22:29:32 +00:00
|
|
|
`make dryrun`
|
2015-09-28 20:02:51 +00:00
|
|
|
|
2017-01-25 22:29:32 +00:00
|
|
|
All of the features are present in dry-run mode. The installer will emit its
|
2015-09-28 20:02:51 +00:00
|
|
|
backend configuration files to /tmp/subiquity-config-* but it won't attempt to
|
|
|
|
run any installer commands (which would fail without root privileges). Further,
|
|
|
|
subiquity can load other machine profiles in case you want to test out the
|
|
|
|
installer without having access to the machine. A few sample machine
|
2017-01-25 22:37:34 +00:00
|
|
|
profiles are available in the repository at ./examples/ and
|
2017-01-25 22:29:32 +00:00
|
|
|
can be loaded via the MACHINE make variable:
|
2015-09-28 20:02:51 +00:00
|
|
|
|
2017-01-25 22:29:32 +00:00
|
|
|
`make dryrun MACHINE=examples/desktop.json`
|
2015-09-28 20:02:51 +00:00
|
|
|
|
|
|
|
# Generating machine profiles
|
2017-01-25 22:29:32 +00:00
|
|
|
Machine profiles are generated from the probert tool. To collect a machine profile:
|
2015-09-28 20:02:51 +00:00
|
|
|
|
2017-01-25 22:37:34 +00:00
|
|
|
`PYTHONPATH=probert ./probert/bin/probert --all > mymachine.json`
|
2015-09-28 20:02:51 +00:00
|
|
|
|
2017-01-25 22:29:32 +00:00
|
|
|
# Making an install image.
|
2015-09-28 20:02:51 +00:00
|
|
|
|
2017-01-25 22:37:34 +00:00
|
|
|
To try out subiquity for real, it is necessary to make an image and run it in a
|
|
|
|
VM. See installer/README.md for instructions on how to do this.
|