Documentation

Installing the Bootstrapper (Offline)

This guide was migrated from the previous website and may refer to older versions of Disco ICT.

Use the offline workflow to add the Disco ICT client bootstrapper to a captured Windows Imaging Format (WIM) image. When a device starts from the prepared image, the bootstrapper connects to Disco ICT, downloads the client and begins enrolment.

This guide covers WIM images only. Check the current Disco ICT release notes for supported Windows versions and image requirements before deploying. The online workflow, which adds the bootstrapper before an image is prepared and captured, is different.

Before you begin

  • Make a backup copy of the WIM. The install command modifies the image.
  • Download the client bootstrapper from the Enrolment page in Disco ICT.
  • Use a Windows computer where you can open an elevated Command Prompt and access the WIM.
  • If devices need wireless access to reach Disco ICT during enrolment, prepare the required wireless profile and certificates as described below.

Prepare the bootstrapper folder

Put the downloaded bootstrapper in a dedicated folder. If the device can connect to Disco ICT over a wired network during enrolment, no wireless files are needed.

For wireless enrolment, place the profile and any required certificates in the same folder as the bootstrapper. Disco ICT uses each file’s name prefix to identify its purpose; you can add a descriptive suffix after the prefix.

File Required filename prefix
Root certificate WLAN_Cert_Root
Intermediate certificate WLAN_Cert_Intermediate
Personal certificate WLAN_Cert_Personal
Wireless profile WLAN_Profile

For example, WLAN_Cert_Root_ExampleCA.pem is recognised as a root certificate. Include only the files needed by your environment, and protect the folder appropriately if it contains a personal certificate or private key.

The original offline workflow specifies the password password for the personal certificate. This is a legacy requirement and must be confirmed for the Disco ICT version you are using. Do not use this workflow if that password conflicts with your security requirements.

Add the bootstrapper to the WIM

Open Command Prompt as an administrator. Run the bootstrapper with /install followed by the path to the WIM. Replace both example paths with the actual paths on your computer:

"C:\Disco\Disco.ClientBootstrapper.exe" /install "C:\Images\Windows.wim"

In File Explorer, Shift + right-click a file and choose Copy as path to copy its full path. Keep the quotes around paths that contain spaces.

The bootstrapper mounts the WIM temporarily, copies itself and the contents of its folder into the image, configures it to run at startup, and then unmounts the image and cleans up. This can take several minutes, depending on the image size.

Deploy the image

After the command completes successfully, use the WIM with your imaging solution as usual. On first startup, the bootstrapper runs, downloads the Disco ICT client and completes the enrolment steps configured for the device.