Adding a New Machine Type to a ggRock Image using the ggRock Seamless Boot Procedure This article details processes for adding a new PC/motherboard type to an existing ggRock system image using ggRock Seamless Boot.
Problem
A new Machine type or motherboard type appears within your game center.
This new type of system is unable to boot.
Solution
In most cases you will be able to simply update your existing System Image, thus preserving all of the data currently written to it (installed launchers, games, etc).
General Process Outline
-
Configure the new machine's BIOS appropriately for UEFI or Legacy mode based on the system image you will be updating, ensuring that the machine in question is powered off, as well as configure network boot as the first boot device.
-
Run the "Add new hardware" wizard against the system image in question to begin the process, then power on the new machine in order to begin the process of scanning for and installing the network driver for that machine type in your system image.
1. Configure the BIOS of the machine for which you will be adding support.
Based on the mode used to build your current system image, configure the BIOS of the machine for which you will be adding support to your system image in either UEFI or Legacy Mode. For details please refer to Configure Client Machines for Network/Diskless (PXE) Boot of the ggRock Installation Manual, or see your motherboard manufacturer's manual.
2. Access the ggRock Web UI.
Open a web browser and access the ggRock Web UI.
NOTE:
Please refer to the Access the Server Console step of the First-time Setup and Accessing the ggRock Server Application article to determine your server IP.
3. Click the "Images" tab within the ggRock Web UI.
4. Click the Image Menu (overflow menu) to the right of the image to which you wish to add new hardware support, then click the "Add New Hardware" context menu item.
5. Proceed with Step 1 of the Add New Hardware wizard, confirming that your Machine's BIOS is configured in either UEFI or Legacy boot mode based on which mode your current system image was built with.
Ensure Network Boot is configured as the first boot device.
Click the "Start " button to proceed.
6. Wait while Step 1.5 of the Add New Hardware Wizard (Updating ggRock Toolchain) completes.
7. The Add New Hardware Wizard automatically enters the "Scanning for Machines" mode.
At this time, please power on the Machine for which we will be installing the network driver.
8. Wait while the Add New Hardware Wizard automatically enters the "Collecting Hardware Data" phase.
Observe that the machine in question boots to a bare-bones Windows OS which automatically detects the network card and transfers the information to the ggRock Toolchain VM for installation in your system image.
Once the Machine boots, you should also note that the Add New Hardware wizard automatically had proceeded automatically to the next step.
9. Wait while the Add New Hardware Wizard automatically enters the "Adding NIC data to the Image" phase.
10. Wait while the Add New Hardware Wizard automatically enters the "Rebooting the new Machine" phase.
11. Observe that the Add New Hardware Wizard has proceeded to the final step. Click the "Finish" button.
12. Observe that the Machine in question has now successfully booted to the image you have added its network hardware to.
