Skip to main content

Apply Site User Data

You can provide site-specific Edge Installer configuration user data if you need to apply new values or override default values from the Edge Installer user data you created in the Prepare Edge Hosts for Installation step or, as often referenced, the Installer Handoff phase.

Use the following steps to create an ISO file containing the additional user data. You will load the newly created ISO to a bootable device, such as a USB stick.

Prerequisites​

  • A bootable device such as a USB drive, or a Preboot Execution Environment (PXE) server.

  • mkisofs, or genisoimage, or similar ISO management software.

  • cdrtools or wodim for Windows.

Create ISO​

  1. Create a file called user-data that contains the additional configurations you want to override or inject.

touch user-data
  1. Create an empty meta-data file:

touch meta-data
  1. Create an ISO using the following command.

MacOS/Linux:

mkisofs -output site-user-data.iso -volid cidata -joliet -rock user-data meta-data

Windows:

genisoimage -output site-user-data.iso -volid cidata -joliet -rock user-data meta-data

This generates an ISO file called site-user-data.iso in the current directory.


  1. Copy the ISO to a bootable device such as a USB drive.


    info

    You can use several software tools to create a bootable USB drive, such as balenaEtcher. For a PXE server, there are open-source projects such as Fog or Windows Deployment Services for Windows.

  2. Once the Edge host arrives at the physical site. Load the USB drive to the Edge host before powering it on. The Edge Installer will apply the new user data during the installation process.


Validate​

You can validate that the ISO image is not corrupted by attempting to flash a bootable device. Most software that creates a bootable device will validate the ISO image before the flash process.

Next Steps​

Before you register your Edge host with Palette you must have a tenant registration token. Review the Create Registration Token guide for steps on how to create a tenant registration token.