parallelvirtualcluster
/
pvc-installer
1
0
Fork 0
Code Issues 1 Pull Requests Projects Releases Wiki Activity

Compare commits

base: parallelvirtualcluster:df1acc5e8020137ebd79746145a3eb221dcca536
Branches Tags
parallelvirtualcluster:master
...
compare: parallelvirtualcluster:e39a473c53c68c527dcb7f3cc98348a37613e511
Branches Tags
parallelvirtualcluster:master

4 Commits
df1acc5e80 ... e39a473c53

Author SHA1 Message Date
Joshua Boniface e39a473c53
Merge pull request #4 from parallelvirtualcluster/joshuaboniface-patch-1 2021-10-29 20:15:41 -04:00
Joshua Boniface b5dacd8f02
Enhance warning message 2021-10-29 20:15:29 -04:00
Joshua Boniface 32d66e6b4c
Merge pull request #3 from parallelvirtualcluster/joshuaboniface-patch-1 2021-10-29 20:14:06 -04:00
Joshua Boniface 95cb3b8986
Add additional details to README document 2021-10-29 20:13:24 -04:00
2 changed files with 22 additions and 5 deletions
Show Stats Expand all files Collapse all files

24
README.md
View File

@ -4,22 +4,38 @@
This repository contains the generator and configurations for the PVC Live Node Installer ISO. This ISO provides a quick and convenient way to install a PVC base system to a physical server, ready to then be provisioned using the [PVC Ansible](https://github.com/parallelvirtualcluster/pvc-ansible) configuration framework. Part of the [Parallel Virtual Cluster system](https://github.com/parallelvirtualcluster/pvc).
## Using
## Using the PVC Installer
Run `./buildiso.sh`. This will pull down the Debian LiveCD image, extract it, debootstrap a fresh install environment, copy in the configurations, generate a squashfs, then finally generate an ISO for use via CD-ROM, Virtual Media, or USB/SDCard flash.
### Preparing
1. Run `./buildiso.sh` from the root of the repository. This will pull down the Debian LiveCD image, extract it, debootstrap a fresh install environment, copy in the configurations, generate a squashfs, then finally generate an ISO file.
Note that artifacts of the build (the LiveCD ISO, debootstrap directory, and squashfs) are cached in `artifacts/` for future reuse.
## Booting
2. Load the ISO via virtual media or write it to a USB drive.
3. Boot the server from the ISO, ideally in UEFI mode.
### Booting
The built ISO can be booted in either BIOS (traditional ISOLinux) or UEFI (Grub2) modes. It is strongly recommended to use the latter if the system supports it for maximum flexibility.
## Installing
### Installing
The installer script will ask several questions to configure the bare minimum system needed for [`pvc-ansible`](https://github.com/parallelvirtualcluster/pvc-ansible) to configure the node.
Follow the prompts carefully; if you make a mistake, you can ^C to cancel the installer, then re-run via `/install.sh` from the resulting root shell.
## Command-line Flags
`-o`: Set the name of the output file, instead of using the standard `pvc-installer_<date>.iso`.
`-s`: Specify an alternate Debian Live ISO source/mirror.
`-a`: Use the cached `squashfs` artifact for the build if possible.
`-u`: Use this name for the initial user account (default is `deploy`).
## License
Copyright (C) 2018-2021 Joshua M. Boniface <joshua@boniface.me>

3
install.sh
View File

@ -1,7 +1,8 @@
#!/usr/bin/env bash
if [[ $( whoami ) != "root" ]]; then
echo "This script is designed to run as root within the installer only!"
echo "STOP! This script is designed to run as root within the installer only!"
echo "Do not run it on your system. To build a PVC installer ISO, use './buildiso.sh' instead!"
exit 1
fi