Go to file

Joshua Boniface c8f1d853a0 Move to template format instead of cat-EOF Simplifies the scripts and adds the ability to easily and cleanly change the contents of these files without dealing with escape characters, etc.		2023-09-01 15:41:57 -04:00
templates	Move to template format instead of cat-EOF	2023-09-01 15:41:57 -04:00
.gitignore	Ignore PXE artifacts	2023-09-01 15:41:56 -04:00
LICENSE	Initial commit of autobuild/autodeploy PVC ISO system	2023-09-01 15:41:53 -04:00
README.md	Add additional details to README document	2023-09-01 15:41:56 -04:00
buildiso.sh	Move to template format instead of cat-EOF	2023-09-01 15:41:57 -04:00
buildpxe.sh	Move to template format instead of cat-EOF	2023-09-01 15:41:57 -04:00
install.sh	Move to template format instead of cat-EOF	2023-09-01 15:41:57 -04:00

README.md

PVC Live Node Installer

NOTICE FOR GITHUB: This repository is a read-only mirror of the PVC repositories from my personal GitLab instance. Pull requests submitted here will not be merged. Issues submitted here will however be treated as authoritative.

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 configuration framework. Part of the Parallel Virtual Cluster system.

Using the PVC Installer

Preparing

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.

Load the ISO via virtual media or write it to a USB drive.
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

The installer script will ask several questions to configure the bare minimum system needed for 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

This repository, and all contained files, is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.