Skip to content

Commit 5906177

Browse files
committed
Updates
-Removed Pre-Auth -Textual changes -Local Password check -Copy script -Readme qoutes -Password escaping
1 parent c8ae393 commit 5906177

2 files changed

Lines changed: 185 additions & 299 deletions

File tree

Deployment/README.md

Lines changed: 21 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,4 @@
11
# Azure Stack Development Kit installer
2-
![Deploying Azure Stack](https://github.com/Azure/AzureStack-Tools/raw/renamestaging/Deployment/Deployment.gif)
32

43
The Azure Stack Development Kit installer provides a UI with the following features
54

@@ -27,7 +26,7 @@ $LocalPath = 'c:\AzureStack_Installer'
2726
New-Item $LocalPath -Type directory
2827
2928
# Download file
30-
Invoke-WebRequest $uri -OutFile ($LocalPath + '\' + asdk-installer.ps1)
29+
Invoke-WebRequest $uri -OutFile ($LocalPath + '\' + 'asdk-installer.ps1')
3130
```
3231

3332
## Prepare the SafeOS for deployment
@@ -36,46 +35,47 @@ The installer script can be used to prepare your host for the deployment of the
3635

3736
Select the cloudbuilder.vhdx and optionally specify a path to a folder containing drivers for the host.
3837
The host can be configured with the following options:
39-
40-
- **Local administrator password** If you uncheck this option the host will prompt for a password during the oobe setup when rebooting to the cloudbuilder.vhdx. Not specifying a local administrator password requires KVM access to the host to specify the password during boot.
41-
- **Computer name** - You can specify the name for the Azure Stack Development Kit host. The name needs to comply with FQDN requirements and cannot be longer than 15 characters. If you do not select the option, Windows generates a computername during OOBE.
42-
- **Timezone** - This options sets timezone for the Azure Stack Development Kit host to the selected value. If this option is not selected the timezone will be configred to (UTC-8:00) Pacific Time (US & Canada)
43-
- **Static IP Configuration** If the Azure Stack development kit needs to be configured with a static IP address, select this option. The installer will prompt for the networking interface and copy the current values for use in the cloudbuilder.vhdx during reboot. You can override the values that where copied if needed. If you do not select this option the network interfaces will be configured with DHCP when rebooted into the cloudbuilder.vhdx
38+
- **Local administrator password** - If you uncheck this option the host will prompt for a password during the oobe setup when rebooting to the cloudbuilder.vhdx. Not specifying a local administrator password requires KVM access to the host to specify the password during boot.
39+
- **Computer name** - You can specify the name for the Azure Stack Development Kit host. The name needs to comply with FQDN requirements and cannot be longer than 15 characters. If you do not select the option, Windows generates a computername during OOBE.
40+
- **Timezone** - This options sets timezone for the Azure Stack Development Kit host to the selected value. If this option is not selected the timezone will be configred to (UTC-8:00) Pacific Time (US & Canada)
41+
- **Static IP Configuration** If the Azure Stack development kit needs to be configured with a static IP address, select this option. The installer will prompt for the networking interface and copy the current values for use in the cloudbuilder.vhdx during reboot. You can override the values that where copied if needed. If you do not select this option the network interfaces will be configured with DHCP when rebooted into the cloudbuilder.vhdx
4442

4543
A job will perform the following actions:
4644

47-
- Verify if the disk containing the cloudbuilder.vhdx has **enough space** to expand the disk. You will need at least (120GB - Size of the cloudBuilder.vhdx file) of free disk space on the disk that contains the cloudBuilder.vhdx.
48-
- Remove previous **Azure Stack** boot entries .
49-
- **Mount** the cloudbuilder.vhdx.
50-
- Add **bootfiles** to the Operating System disk.
51-
- Updates the boot configuration with an **Azure Stack** entry for the virtual hard disk and sets it to the default value.
52-
- Adds an **unattend** file to the Operating System on the mounted virtual hard disk, based on the selections made in the wizard.
53-
- Adds **drivers** to the operating system, if that option was selected during the wizard.
45+
- Verify if the disk containing the cloudbuilder.vhdx has **enough space** to expand the disk. You will need at least (120GB - Size of the cloudBuilder.vhdx file) of free disk space on the disk that contains the cloudBuilder.vhdx.
46+
- Remove previous **Azure Stack** boot entries .
47+
- **Mount** the cloudbuilder.vhdx.
48+
- Add **bootfiles** to the Operating System disk.
49+
- Updates the boot configuration with an **Azure Stack** entry for the virtual hard disk and sets it to the default value.
50+
- Adds an **unattend** file to the Operating System on the mounted virtual hard disk, based on the selections made in the wizard.
51+
- Adds **drivers** to the operating system, if that option was selected during the wizard.
5452

5553
When the job is completed you finalize the wizard to reboot into the cloudbuilder.vhdx. If you have enabled the local administrator password and have connectivity to the IP address (either the static one specified or based on DHCP), you can remote into the host with RDP after the OOBE completes.
5654

5755
## Prepare the Azure Stack Development Kit installation
5856

59-
Once the host has succesfully completed booting from the cloudbuilder.vhdx, logon to the host as administrator and start the same installation script again. The installer script was originally stored on c:\AzureStack_Installer. After the reboot into cloudbuilder.vhdx the SafeOS system disk is presented as a datadisk in the Operating System of the Azure Stack Development Kit host OS. Browse for the script and execute it by righclicking it and select Run with PowerShell. Or browse to the path in a PowerShell session and run:
57+
Once the host has succesfully completed booting from the cloudbuilder.vhdx, logon to the host as administrator and start the same installation script again. The installer script was originally stored on c:\AzureStack_Installer. After the reboot into cloudbuilder.vhdx the SafeOS system disk is presented as a datadisk in the Operating System of the Azure Stack Development Kit host OS. Browse for the script and execute it by righclicking it and select Run with PowerShell. Or browse to the path in a PowerShell session and run;
6058

6159
```powershell
6260
.\asdk-installer.ps1
6361
```
6462

6563
Click install to start the deployment wizard. Select the preferred identity provider for your Azure Stack Development Kit deployment.
6664

67-
- **Azure Cloud** : Azure Active Directory
68-
- **ADFS** : Local ADFS instance as part of the installation
65+
- **Azure Cloud** : Azure Active Directory
66+
- **ADFS** : Local ADFS instance as part of the installation
6967

70-
If you selected Azure Cloud, specify the credentials of an account with the Global Admin role in an Azure Active Directory tenant. This account will also be used to administer your Azure Stack Development Kit. If this account is part of multiple active directory tenants you can check the tenantID and override the default value with the name of the desired directory tenant for the installation.
68+
If you selected Azure Cloud, specify the Azure Active Directory tenant (e.g. azurestack.onmicrosoft.com).
7169

7270
Submit the local administrator password. This value submitted has to match the current configured local administrator password.
7371

7472
In the network interface screen, select the adapter that will be used for the Azure Stack Development Kit. Ensure you have access to the IP address as all other adapters will be disabled by the installer.
7573

76-
The network configuration screen allows you to specify the settings for the BGPNAT vm. The default settings uses DHCP for the BGPNAT vm. You can set it to static, but only use this parameter if DHCP can???t assign a valid IP address for Azure Stack to access the Internet. A static IP address needs to be specified with the subnetmask length (e.g. 10.0.0.5/24). Optionally you can specify the TimeServer, DNS Server and VLAN ID.
74+
The network configuration screen allows you to specify the settings for the BGPNAT vm. The default settings uses DHCP for the BGPNAT vm. You can set it to static, but only use this parameter if DHCP can’t assign a valid IP address for Azure Stack to access the Internet. A static IP address needs to be specified with the subnetmask length (e.g. 10.0.0.5/24). Optionally you can specify the TimeServer, DNS Server and VLAN ID.
75+
76+
The summary screen displays the PowerShell script that will be executed. Click deploy start the deployment of the Azure Stack Development Kit.
7777

78-
The summary screen displays the PowerSheel script that will be executed. Click deploy start the deployment of the Azure Stack Development Kit.
78+
> Note: When you have selected Azure Cloud as the identity provider, you will be prompted 2 to 3 minutes after the deployment has started. Please ensure you submit your Azure AD credentials.
7979
8080
## Rerun and gather logs
8181

@@ -88,5 +88,4 @@ If the installation completed succesfully, but you ran into an issue that requir
8888
The installer script allows you to easily initiate a reboot to the SafeOS to start a redeployment of your Azure Stack Development Kit. Start the installer script and select Reboot. You will be presented with the current boot options. Select the entry for the SafeOS and select Reboot. This creates a onetime override in the boot order. The SafeOS boot entry will be select automatically. The next reboot the boot configuration will resume its normal order and the host will boot into the cloudbuilder.vhdx again.
8989

9090
### Note
91-
92-
The Azure Stack Development Kit installer script is based on PowerShell and the Windows Presentation Foundation. It is published in this public repository so you can make improvements to it by submitting a pull request.
91+
The Azure Stack Development Kit installer script is based on PowerShell and the Windows Presentation Foundation. It is published in this public repository so you can make improvements to it by submitting a pull request.

0 commit comments

Comments
 (0)