#!/usr/bin/env bash # wds-deploy.sh — Package M-Archy archiso netboot artifacts for WDS + PXELinux deployment # # Usage: # bash wds-deploy.sh --http-srv URL [OPTIONS] [OUT_DIR] # # --http-srv URL HTTP base URL where arch netboot files will be served # (e.g. http://192.168.1.10/m-archy) # Arch's initrd fetches airootfs.sfs over HTTP at boot time. # Required. # --tftp-prefix PATH Subdirectory within the WDS TFTP root for kernel/initramfs # (default: m-archy) # --preconf [FILE] Passed through to build.sh — embeds an answerfile into the ISO # --no-rebuild Skip the archiso build if a netboot tarball already exists # OUT_DIR Output directory (default: ~/m-archy-out) # # Output layout (inside OUT_DIR/wds-deploy/): # TFTP/ Copy contents to WDS TFTP root: C:\RemoteInstall\Boot\x64\ # HTTP/ Serve as HTTP root at the URL given to --http-srv # wds-tftp.zip Zip of TFTP/ — drop onto the Windows Server directly # # WDS deployment steps: # 1. Serve HTTP/ over IIS/Nginx at the --http-srv URL # 2. Extract wds-tftp.zip into C:\RemoteInstall\Boot\x64\ # 3. In WDS console → server Properties → Boot tab: # Set "Default boot program" for x64 to: Boot\x64\pxelinux.0 # 4. PXE-boot a client — the M-Archy menu appears set -euo pipefail SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)" SYSLINUX_BIOS="/usr/lib/syslinux/bios" # ── Argument parsing ─────────────────────────────────────────────────────────── HTTP_SRV="" TFTP_PREFIX="m-archy" PRECONF_ARGS=() NO_REBUILD=0 OUT_ARG="" while [[ $# -gt 0 ]]; do case "$1" in --http-srv) [[ $# -gt 1 ]] || { echo "ERROR: --http-srv requires a URL" >&2; exit 1; } HTTP_SRV="$2"; shift 2 ;; --http-srv=*) HTTP_SRV="${1#--http-srv=}"; shift ;; --tftp-prefix) [[ $# -gt 1 ]] || { echo "ERROR: --tftp-prefix requires a value" >&2; exit 1; } TFTP_PREFIX="$2"; shift 2 ;; --tftp-prefix=*) TFTP_PREFIX="${1#--tftp-prefix=}"; shift ;; --preconf) if [[ $# -gt 1 && "${2:0:1}" != "-" ]]; then PRECONF_ARGS=(--preconf "$2"); shift 2 else PRECONF_ARGS=(--preconf); shift fi ;; --preconf=*) PRECONF_ARGS=("$1"); shift ;; --no-rebuild) NO_REBUILD=1; shift ;; -*) echo "Unknown flag: $1" >&2; exit 1 ;; *) OUT_ARG="$1"; shift ;; esac done OUT_DIR="${OUT_ARG:-${OUT_DIR:-$HOME/m-archy-out}}" WDS_DIR="$OUT_DIR/wds-deploy" # ── Validate ────────────────────────────────────────────────────────────────── if [[ -z "$HTTP_SRV" ]]; then echo "ERROR: --http-srv is required." >&2 echo " The Arch initrd fetches airootfs.sfs over HTTP at boot." >&2 echo " Example: --http-srv http://192.168.1.10/m-archy" >&2 exit 1 fi HTTP_SRV="${HTTP_SRV%/}" # strip trailing slash # ── Ensure syslinux is available ────────────────────────────────────────────── if [[ ! -f "$SYSLINUX_BIOS/pxelinux.0" ]]; then echo "syslinux not found — installing..." sudo pacman -S --noconfirm syslinux fi if [[ ! -f "$SYSLINUX_BIOS/pxelinux.0" ]]; then echo "ERROR: $SYSLINUX_BIOS/pxelinux.0 still not found after install." >&2 exit 1 fi # ── Build ISO + netboot tarball (unless --no-rebuild) ───────────────────────── NETBOOT_TARBALL="$(ls "$OUT_DIR/"*-netboot-*.tar.gz 2>/dev/null | head -n1 || true)" if [[ "$NO_REBUILD" -eq 1 && -n "$NETBOOT_TARBALL" ]]; then echo "Skipping build — using existing tarball: $(basename "$NETBOOT_TARBALL")" else echo "Building archiso (this may take a while)..." bash "$SCRIPT_DIR/build.sh" "${PRECONF_ARGS[@]+"${PRECONF_ARGS[@]}"}" "$OUT_DIR" NETBOOT_TARBALL="$(ls "$OUT_DIR/"*-netboot-*.tar.gz 2>/dev/null | head -n1 || true)" fi [[ -n "$NETBOOT_TARBALL" ]] \ || { echo "ERROR: No netboot tarball found in $OUT_DIR — build may have failed." >&2; exit 1; } echo "Using netboot tarball: $(basename "$NETBOOT_TARBALL")" # ── Extract netboot tarball ─────────────────────────────────────────────────── EXTRACT_DIR="$OUT_DIR/.netboot-extracted" rm -rf "$EXTRACT_DIR" mkdir -p "$EXTRACT_DIR" echo "Extracting netboot tarball..." tar -xzf "$NETBOOT_TARBALL" -C "$EXTRACT_DIR" VMLINUZ="$(find "$EXTRACT_DIR" -name 'vmlinuz-linux' | head -n1 || true)" INITRAMFS="$(find "$EXTRACT_DIR" -name 'initramfs-linux.img' | head -n1 || true)" ARCH_DIR="$(find "$EXTRACT_DIR" -maxdepth 2 -type d -name 'arch' | head -n1 || true)" [[ -f "$VMLINUZ" ]] || { echo "ERROR: vmlinuz-linux not found in netboot tarball." >&2; exit 1; } [[ -f "$INITRAMFS" ]] || { echo "ERROR: initramfs-linux.img not found in netboot tarball." >&2; exit 1; } [[ -d "$ARCH_DIR" ]] || { echo "ERROR: arch/ directory not found in netboot tarball." >&2; exit 1; } # ── Build WDS deployment tree ───────────────────────────────────────────────── # # TFTP root layout (mirrors what WDS serves via TFTP): # pxelinux.0 PXELinux bootloader # ldlinux.c32 required by pxelinux.0 # menu.c32 + libcom32.c32 + libutil.c32 text boot menu # pxelinux.cfg/default boot menu config # /arch/boot/x86_64/vmlinuz-linux # /arch/boot/x86_64/initramfs-linux.img # # HTTP root layout (served at $HTTP_SRV/ over IIS/Nginx/Apache): # arch/x86_64/airootfs.sfs fetched by initrd at boot # arch/x86_64/airootfs.sfs.sha512 # arch/pkglist.x86_64.txt (and any other netboot files) TFTP_ROOT="$WDS_DIR/TFTP" HTTP_ROOT="$WDS_DIR/HTTP" rm -rf "$WDS_DIR" mkdir -p \ "$TFTP_ROOT/$TFTP_PREFIX/arch/boot/x86_64" \ "$TFTP_ROOT/pxelinux.cfg" \ "$HTTP_ROOT" # ── Copy syslinux modules ───────────────────────────────────────────────────── echo "Copying syslinux PXELinux modules..." REQUIRED_MODS=(pxelinux.0 ldlinux.c32 menu.c32 libcom32.c32 libutil.c32) MISSING_MODS=() for mod in "${REQUIRED_MODS[@]}"; do if [[ -f "$SYSLINUX_BIOS/$mod" ]]; then cp "$SYSLINUX_BIOS/$mod" "$TFTP_ROOT/" else MISSING_MODS+=("$mod") fi done if [[ ${#MISSING_MODS[@]} -gt 0 ]]; then echo "Warning: missing syslinux modules (non-fatal for some setups): ${MISSING_MODS[*]}" fi # ── Copy kernel and initramfs ───────────────────────────────────────────────── echo "Copying kernel and initramfs..." cp "$VMLINUZ" "$TFTP_ROOT/$TFTP_PREFIX/arch/boot/x86_64/vmlinuz-linux" cp "$INITRAMFS" "$TFTP_ROOT/$TFTP_PREFIX/arch/boot/x86_64/initramfs-linux.img" # ── Copy HTTP content (airootfs squashfs and supporting files) ──────────────── echo "Copying HTTP content (airootfs + supporting files)..." cp -r "$ARCH_DIR" "$HTTP_ROOT/arch" # ── Generate pxelinux.cfg/default ──────────────────────────────────────────── echo "Writing pxelinux.cfg/default..." # Kernel path is relative to the TFTP root KERNEL_PATH="${TFTP_PREFIX}/arch/boot/x86_64/vmlinuz-linux" INITRD_PATH="${TFTP_PREFIX}/arch/boot/x86_64/initramfs-linux.img" # archiso_http_srv must end with a slash; archisobasedir is the subdir within it # that contains the x86_64/ squashfs tree APPEND_BASE="initrd=${INITRD_PATH} archiso_http_srv=${HTTP_SRV}/ archisobasedir=arch ip=dhcp" cat > "$TFTP_ROOT/pxelinux.cfg/default" </dev/null; then (cd "$TFTP_ROOT" && zip -r "$ZIP_FILE" .) echo "Created: $ZIP_FILE" else echo "Note: 'zip' not installed — skipping wds-tftp.zip creation." echo " Install with: sudo pacman -S zip" fi # ── Summary ─────────────────────────────────────────────────────────────────── echo echo "=========================================================================" echo " WDS deployment package: $WDS_DIR" echo "=========================================================================" echo echo " TFTP/ → WDS TFTP root (copy to Windows Server)" echo " Destination: C:\\RemoteInstall\\Boot\\x64\\" echo " Tip: use wds-tftp.zip if created above, or robocopy/SCP the TFTP/ tree." echo echo " HTTP/ → HTTP root (serve at: ${HTTP_SRV}/)" echo " The initrd fetches: ${HTTP_SRV}/arch/x86_64/airootfs.sfs" echo " Serve with IIS, Nginx, or Apache pointing to the HTTP/ directory." echo echo " pxelinux.cfg/default kernel args summary:" echo " archiso_http_srv = ${HTTP_SRV}/" echo " archisobasedir = arch" echo echo " WDS configuration steps:" echo " 1. Copy TFTP/ contents to C:\\RemoteInstall\\Boot\\x64\\" echo " 2. Serve HTTP/ over IIS/Nginx at: ${HTTP_SRV}/" echo " 3. Open WDS console → right-click server → Properties → Boot tab:" echo " x64 default boot program: Boot\\x64\\pxelinux.0" echo " Check 'Always continue the PXE boot' for unknown clients" echo " 4. If WDS manages DHCP, ensure option 67 is: Boot\\x64\\pxelinux.0" echo " If using a separate DHCP server, set:" echo " option 66 (next-server) = " echo " option 67 (boot-file) = Boot\\x64\\pxelinux.0" echo " 5. PXE-boot a client — the M-Archy menu should appear." echo echo " File sizes:" du -sh "$TFTP_ROOT" "$HTTP_ROOT" 2>/dev/null | sed 's/^/ /' echo "========================================================================="