These files are used for PXE booting off of releng PXE server (relengweb). There's a tool that's being worked on for adding machines in a more automated fashion. In the meantime, the basics: ######### * You'll need a folder named the FQDN of the target machine, e.g., 'releng3.av1.gaikai.org' * You'll symlink that to the MAC address (lowercase, no extra chars) of the port that will be used for booting, e.g., '90b11c54e0bf' * In the folder, two JSON files: * bootstrap.json - Information about what image to put on the host, and how to partition disks * upconf.json - Dynamic information for use inside the running image about a partiuclar instance, e.g., timezone, hostname, MAC, IP address, etc. ######### ######### Workstation specific info: * There are 3 images to choose from: * workstation-stable - default - stable Gentoo desktop image maintained by releng * workstation-unstable - unstable Gentoo desktop image semi-maintained by releng Prone to breakage upstream, don't use unless you're familiar with Gentoo debugging * laptop-workstation - stable Gentoo desktop image for laptops maintained by releng * Hostname should be gk#last 4 of gaikai serial number# * qatest1.dev.av1.gaikai.org can be used as an example. That is the qa test machine, so releng should always keep that context updated with the current JSON files/formats * Adding a new desktop: * Until new tool is ready, here are the steps to add a machine: * cd /var/releng/contexts * cp -r qatest1.dev.av1.gaikai.org gk1234.dev.av1.gaikai.org * ln -s gk1234.dev.av1.gaikai.org ffffffffffff * vi gk1234.dev.av1.gaikai.org/bootstrap.json * update timezone, image, kernel, HD layout (all optional, defaults should work) * vi gk1234.dev.av1.gaikai.org/upconf.json * name, fqdn, mac - MUST change * domain, type, ip/network info - optional * PXE boot the machine. See https://wiki.gaikai.biz/display/TechOps/Gentoo+Workstation+Stable for next steps #########