Prepare the ASDK host computer

Before you can install the ASDK on the host computer, the ASDK host must be prepared for installation. When the development kit host computer has been prepared, it will boot from the CloudBuilder.vhdx virtual machine hard drive to begin ASDK deployment.

Prepare the development kit host computer

Before you can install the ASDK on the host computer, the ASDK host computer environment must be prepared.

  1. Sign in as a Local Administrator to your development kit host computer.

  2. Ensure that the CloudBuilder.vhdx file has been moved to the root of the C:\ drive (C:\CloudBuilder.vhdx).

  3. Run the following script to download the development kit installer file (asdk-installer.ps1) from the Azure Stack GitHub tools repository to the C:\AzureStack_Installer folder on your development kit host computer:


    Be sure to download the asdk-installer.ps1 file each time you install the ASDK. Frequent changes are made to this script and the most current version should be used for each ASDK deployment. Older versions of the script might not work with the most current release.

    # Variables
    $Uri = ''
    $LocalPath = 'C:\AzureStack_Installer'
    # Create folder
    New-Item $LocalPath -Type directory
    # Enforce usage of TLSv1.2 to download from GitHub
    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
    # Download file
    Invoke-WebRequest $uri -OutFile ($LocalPath + '\' + 'asdk-installer.ps1')
  4. From an elevated PowerShell console, start the C:\AzureStack_Installer\asdk-installer.ps1 script, and then click Prepare Environment.

  5. On the Select Cloudbuilder vhdx page of the installer, browse to and select the cloudbuilder.vhdx file that you downloaded and extracted in the previous steps. On this page, you can also, optionally, enable the Add drivers check box if you need to add additional drivers to the development kit host computer. Click Next.

  6. On the Optional settings page, provide the local administrator account information for the development kit host computer and then click Next.

    If you don't provide the local administrator credentials in this step, you'll need direct or KVM access to the host after the computer restarts as part of setting up the development kit.

    You can also provide values for the following optional settings:

    • Computername: This option sets the name for the development kit host. The name must comply with FQDN requirements and must be 15 characters or less in length. The default is a random computer name generated by Windows.
    • Static IP configuration: Sets your deployment to use a static IP address. Otherwise, when the installer reboots into the cloudbuilder.vhdx, the network interfaces are configured with DHCP. If you choose to use a static IP configuration, additional options are displayed where you must also:
      • Select a network adapter. Make sure you can connect to the adapter before you click Next.
      • Make sure that the displayed IP address, Gateway, and DNS values are correct and then click Next.
  7. Click Next to start the preparation process.

  8. When the preparation indicates Completed, click Next.

  9. Click Reboot now to boot the development kit host computer into the cloudbuilder.vhdx and continue the deployment process.

Next steps

Install the ASDK