In 2017 Microsoft made it possible to run different Linux distribution on Windows 10, using a feature called the “Windows Subsystem for Linux“. With the latest official Semi-Annual Channel Windows Server release called Windows Server, version 1709 Microsoft also allowed to run the Windows Subsystem for Linux (WSL) on Windows Server. With the next release of Windows Server called Windows Server, version 1803, Microsoft will also add some improvements to the Windows Subsystem on Linux, which also apply to Windows 10 as well as Windows Server. This blog post shows you how you can do this.

First you have a Windows Server, version 1709 running. After that enable the Microsoft Windows Subsystem for Linux feature, running the following command (This will need a reboot)

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

1	Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

You can download the appx packages for you favorite Linux distribution, this can be today:

Ubuntu
OpenSUSE
Suse Linux Enterprise Server

If you are running on Windows Server Core (which is highly likely), you can use the following command to download the Linux distributions.

# For Ubuntu 16.04

Invoke-WebRequest -Uri https://aka.ms/wsl-ubuntu-1604 -OutFile ~/Ubuntu.zip -UseBasicParsing

# For OpenSUSE 42

Invoke-WebRequest -Uri https://aka.ms/wsl-opensuse-42 -OutFile ~/OpenSUSE.zip -UseBasicParsing

# For SLES 12

Invoke-WebRequest -Uri https://aka.ms/wsl-sles-12 -OutFile ~/SLES.zip -UseBasicParsing

# For Ubuntu 16.04

Invoke-WebRequest -Uri https://aka.ms/wsl-ubuntu-1604 -OutFile ~/Ubuntu.zip -UseBasicParsing

# For OpenSUSE 42

Invoke-WebRequest -Uri https://aka.ms/wsl-opensuse-42 -OutFile ~/OpenSUSE.zip -UseBasicParsing

# For SLES 12

Invoke-WebRequest -Uri https://aka.ms/wsl-sles-12 -OutFile ~/SLES.zip -UseBasicParsing

You can then unpack the file:

Expand-Archive ~/Ubuntu.zip C:\Distros\Ubuntu

1	Expand-Archive ~/Ubuntu.zip C:\Distros\Ubuntu

Now you can open that folder and run the installer for example ubuntu.exe. The first time this will do the setup where you also define the UNIX username and password as well as the root password.

After that you can run updates for your distro and you can start using Linux.

If you want to know more about the WSL, check out the Microsoft Documentation: Windows Subsystem for Linux Documentation and have a look at my WSL post in for Windows 10: Crazy times – You can now run Linux on Windows 10 from the Windows Store

If you are responsable to manage and operate Azure Stack, you will need to enable a couple of tools to manage Azure Stack. This post should give you a summary of what you should do to setup your Azure Stack Operator and Developer workstation environment.

Operating System

First of all you should setup a clean base system. I usually use the latest version of Windows 10, right now the latest Windows 10 version is the Fall Creators Update which give you some great features like the OpenSSH client or the Windows Subsystem for Linux build in, or I use Winodws Sevrer 2016 with Desktop Expierence. Make sure you install all the latest updates for Microsoft Update.

Install Visual Studio Code

Visual Studio Code is a new, free, lightweight cross-platform code editor for building modern web and cloud applications on Mac OS X, Linux and Windows. It is perfect for editing JSON files and even writing some code. And it has a built-in Terminal so you don’t have to switch between different windows.

I recommend you install the following Extensions:

code --install-extension ms-vscode.vscode-azureextensionpack
code --install-extension ms-vscode.powershell

code --list-extensions

code --install-extension ms-vscode.vscode-azureextensionpack

code --install-extension ms-vscode.powershell

code --list-extensions

Install SSH Client or Windows Subsystem for Linux (WSL)

To manage Linux Virtual Machines running on Azure Stack or if you need to manage the hardware switches in Azure Stack or your border switches where Azure Stack is connected, SSH is the way to access it. Windows 10 now comes with several builtin options like the OpenSSH Client which you can install as addtional feature or for example the Windows Subsystem for Linux (WSL) which allows you to run several linux tools on Windows directly. If you are using another version of Winodws, the thrid party application PuTTY is your friend.

You can also using PowerShell to install it:

Get-WindowsCapability -Online | ? Name -like 'OpenSSH*'

# Install the OpenSSH Client
Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0

# Install the OpenSSH Server
Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0

Get-WindowsCapability -Online | ? Name -like 'OpenSSH*'

# Install the OpenSSH Client

Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0

# Install the OpenSSH Server

Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0

Install Azure Stack PowerShell

Azure Stack compatible Azure PowerShell modules are required to work with Azure Stack. PowerShell commands for Azure Stack are installed through the PowerShell gallery, you can run the following commands to install it: (Make sure there are no other Azure PowerShell Modules installed, if there are, the commands will remove them). If you also install Visual Studio, install Visual Studio first before you install the Azure Stack PowerShell.

# Trust the PowerShell Gallery
Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted

# Remove Existing Azure PowerShell Modules
Get-Module -ListAvailable | where-Object {$_.Name -like “Azure*”} | Uninstall-Module

# Install the AzureRM.Bootstrapper module. Select Yes when prompted to install NuGet
Install-Module -Name AzureRm.BootStrapper

# Install and import the API Version Profile required by Azure Stack into the current PowerShell session.
Use-AzureRmProfile -Profile 2017-03-09-profile -Force

#Install Azure Stack Module
Install-Module -Name AzureStack -RequiredVersion 1.2.11

# Verify Installation
Get-Module -ListAvailable | where-Object {$_.Name -like "Azure*"}

# Trust the PowerShell Gallery

Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted

# Remove Existing Azure PowerShell Modules

Get-Module -ListAvailable | where-Object {$_.Name -like “Azure*”} | Uninstall-Module

# Install the AzureRM.Bootstrapper module. Select Yes when prompted to install NuGet

Install-Module -Name AzureRm.BootStrapper

# Install and import the API Version Profile required by Azure Stack into the current PowerShell session.

Use-AzureRmProfile -Profile 2017-03-09-profile -Force

#Install Azure Stack Module

Install-Module -Name AzureStack -RequiredVersion 1.2.11

# Verify Installation

Get-Module -ListAvailable | where-Object {$_.Name -like "Azure*"}

If you need to install it on a machine which does not have access to the internet. check outthe offical Microsoft page: Install PowerShell for Azure Stack

Install Azure Stack tools

AzureStack-Tools is a GitHub repository that hosts PowerShell modules that you can use to manage and deploy resources to Azure Stack. This brings you several functionalities for Azure Stack management:

Deployment of Azure Stack – Helps prepare for Azure Stack deployment.
Resource Manager policy for Azure Stack – Constrains Azure subscription to the capabilities available in the Azure Stack.
Connecting to Azure Stack – Connect to an Azure Stack instance from your personal computer/laptop.
Setting up Identity for Azure Stack – Create and manage identity related objects and configurations for Azure Stack
Azure Stack Service Administration – Manage plans and subscriptions in Azure Stack.
Azure Stack Compute Administration – Manage compute (VM) service in Azure Stack.
AzureRM Template validator – Validate Azure ARM Template Capabilities
Azure Stack Infrastructure Administration – Manage Azure Stack Infrastructure

You can get the Azure Stack tools from GitHub:

# Change directory to the root directory
cd \

# Download the tools archive
Invoke-WebRequest https://github.com/Azure/AzureStack-Tools/archive/master.zip -OutFile master.zip

# Expand the downloaded files
Expand-Archive master.zip -DestinationPath . -Force

# Change to the tools directory
cd AzureStack-Tools-master

# Change directory to the root directory

cd \

# Download the tools archive

Invoke-WebRequest https://github.com/Azure/AzureStack-Tools/archive/master.zip -OutFile master.zip

# Expand the downloaded files

Expand-Archive master.zip -DestinationPath . -Force

# Change to the tools directory

cd AzureStack-Tools-master

You can directly open that folder in Visual Studio Code:

code C:\AzureStack-Tools-master

1	code C:\AzureStack-Tools-master

Configure Azure Stack PowerShell environment

As an Azure Stack user, you can configure your Azure Stack PowerShell environment. After you configure, you can use PowerShell to manage Azure Stack resources such as subscribe to offers, create virtual machines, deploy Azure Resource Manager templates, etc.

For an Azure Stack deployment which is using Azure Active Directory (AAD) as an Identity provider, you can use the following commands:

# Navigate to the downloaded folder and import the **Connect** PowerShell module
Set-ExecutionPolicy RemoteSigned
Import-Module .\Connect\AzureStack.Connect.psm1

# For Azure Stack development kit, this value is set to https://management.local.azurestack.external. For a real Azure Stack solution this will be https://maangement.-region-.-fqdn-
$ArmEndpoint = "&lt;Resource Manager endpoint for your environment&gt;"

# For Azure Stack development kit, this value is set to https://graph.windows.net/.
$GraphAudience = "&lt;GraphAudience endpoint for your environment&gt;"

# Register an AzureRM environment that targets your Azure Stack instance
Add-AzureRMEnvironment `
-Name "AzureStackUser" `
-ArmEndpoint $ArmEndpoint

# Set the GraphEndpointResourceId value
Set-AzureRmEnvironment `
-Name "AzureStackUser" `
-GraphAudience $GraphAudience

# Get the Active Directory tenantId that is used to deploy Azure Stack
$TenantID = Get-AzsDirectoryTenantId `
-AADTenantName "&lt;myDirectoryTenantName&gt;.onmicrosoft.com" `
-EnvironmentName "AzureStackUser"

# Sign in to your environment
Login-AzureRmAccount `
-EnvironmentName "AzureStackUser" `
-TenantId $TenantID

# Navigate to the downloaded folder and import the **Connect** PowerShell module

Set-ExecutionPolicy RemoteSigned

Import-Module .\Connect\AzureStack.Connect.psm1

# For Azure Stack development kit, this value is set to https://management.local.azurestack.external. For a real Azure Stack solution this will be https://maangement.-region-.-fqdn-

$ArmEndpoint = "<Resource Manager endpoint for your environment>"

# For Azure Stack development kit, this value is set to https://graph.windows.net/.

$GraphAudience = "<GraphAudience endpoint for your environment>"

# Register an AzureRM environment that targets your Azure Stack instance

Add-AzureRMEnvironment `

-Name "AzureStackUser" `

-ArmEndpoint $ArmEndpoint

# Set the GraphEndpointResourceId value

Set-AzureRmEnvironment `

-Name "AzureStackUser" `

-GraphAudience $GraphAudience

# Get the Active Directory tenantId that is used to deploy Azure Stack

$TenantID = Get-AzsDirectoryTenantId `

-AADTenantName "<myDirectoryTenantName>.onmicrosoft.com" `

-EnvironmentName "AzureStackUser"

# Sign in to your environment

-EnvironmentName "AzureStackUser" `

-TenantId $TenantID

Install and configure CLI for use with Azure Stack

You can also use the Azure CLI 2.0 to manage Azure Stack.

Install Azure CLI on Windows using MSI

To install the CLI on Windows and use it in the Windows command-line, download and run the Azure CLI Installer (MSI).

Install with apt-get for Bash on Ubuntu on Windows (WSL)

Open the Bash shell.
Modify your sources list.
echo "deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ wheezy main" | \ sudo tee /etc/apt/sources.list.d/azure-cli.list
1
2
echo "deb [arch=amd64] https://packages.microsoft.com/repos/azure-cli/ wheezy main" | \
sudo tee /etc/apt/sources.list.d/azure-cli.list

Run the following sudo commands:

sudo apt-key adv --keyserver packages.microsoft.com --recv-keys 52E16F86FEE04B979B07E28DB02C46DF417A0893
sudo apt-get install apt-transport-https
sudo apt-get update &amp;&amp; sudo apt-get install azure-cli

sudo apt-key adv --keyserver packages.microsoft.com --recv-keys 52E16F86FEE04B979B07E28DB02C46DF417A0893

sudo apt-get install apt-transport-https

sudo apt-get update && sudo apt-get install azure-cli

Run the CLI from the command prompt with the az command.

Connect to Azure Stack using the Azure CLI

If you are using Public Certificates for your Azure Stack, this is pretty staight forward, if you are using the Azure Stack Development Kit or an Internal CA, make sure your client trusts the Azure Stack CA root Certificate. You can find more here: Install and configure CLI for use with Azure Stack

Register as a cloud administrative environement:

To register the cloud administrative environment, use:

az cloud register \
-n AzureStackAdmin \
--endpoint-resource-manager "https://adminmanagement.-region-.FQDN-" \
--suffix-storage-endpoint "-region-.FQDN-" \
--suffix-keyvault-dns ".adminvault.-region-.FQDN-" \
--endpoint-active-directory-graph-resource-id "https://graph.windows.net/" \
--endpoint-vm-image-alias-doc &lt;URI of the document which contains virtual machine image aliases&gt;

az cloud register \

-n AzureStackAdmin \

--endpoint-resource-manager "https://adminmanagement.-region-.FQDN-" \

--suffix-storage-endpoint "-region-.FQDN-" \

--suffix-keyvault-dns ".adminvault.-region-.FQDN-" \

--endpoint-active-directory-graph-resource-id "https://graph.windows.net/" \

--endpoint-vm-image-alias-doc <URI of the document which contains virtual machine image aliases>

Set the active environment by using the following commands.
az cloud set \ -n AzureStackAdmin
1
2
az cloud set \
-n AzureStackAdmin
Update your environment configuration to use the Azure Stack specific API version profile. To update the configuration, run the following command:
az cloud update \ --profile 2017-03-09-profile
1
2
az cloud update \
--profile 2017-03-09-profile

Sign in to your Azure Stack environment by using the az login command. You can sign in to the Azure Stack environment either as a user or as a service principal.

az login \
-u &lt;Active directory global administrator or user account. For example: username@&lt;aadtenant&gt;.onmicrosoft.com&gt; \
--tenant &lt;Azure Active Directory Tenant name. For example: myazurestack.onmicrosoft.com&gt;

az login \

-u <Active directory global administrator or user account. For example: username@<aadtenant>.onmicrosoft.com> \

--tenant <Azure Active Directory Tenant name. For example: myazurestack.onmicrosoft.com>

Register the user environment, use:

To register the user environment, use:

az cloud register \
-n AzureStackUser \
--endpoint-resource-manager "https://management.local.azurestack.external" \
--suffix-storage-endpoint "local.azurestack.external" \
--suffix-keyvault-dns ".vault.local.azurestack.external" \
--endpoint-active-directory-graph-resource-id "https://graph.windows.net/" \
--endpoint-vm-image-alias-doc &lt;URI of the document which contains virtual machine image aliases&gt;

az cloud register \

-n AzureStackUser \

--endpoint-resource-manager "https://management.local.azurestack.external" \

--suffix-storage-endpoint "local.azurestack.external" \

--suffix-keyvault-dns ".vault.local.azurestack.external" \

--endpoint-active-directory-graph-resource-id "https://graph.windows.net/" \

--endpoint-vm-image-alias-doc <URI of the document which contains virtual machine image aliases>

Set the active environment by using the following commands.
az cloud set \ -n AzureStackUser
1
2
az cloud set \
-n AzureStackUser
Update your environment configuration to use the Azure Stack specific API version profile. To update the configuration, run the following command:
az cloud update \ --profile 2017-03-09-profile
1
2
az cloud update \
--profile 2017-03-09-profile

Sign in to your Azure Stack environment by using the az login command. You can sign in to the Azure Stack environment either as a user or as a service principal.

az login \
-u &lt;Active directory global administrator or user account. For example: username@&lt;aadtenant&gt;.onmicrosoft.com&gt; \
--tenant &lt;Azure Active Directory Tenant name. For example: myazurestack.onmicrosoft.com&gt;

az login \

-u <Active directory global administrator or user account. For example: username@<aadtenant>.onmicrosoft.com> \

--tenant <Azure Active Directory Tenant name. For example: myazurestack.onmicrosoft.com>

Install the Microsoft Azure Storage Explorer

To access and manage Azure Stack Storage Accounts you can also use the Microsoft Azure Storage Explorer tool. Microsoft Azure Storage Explorer (Preview) is a standalone app from Microsoft that allows you to easily work with Azure Storage data on Windows, macOS and Linux.

If you are running the Azure Stack Development Kit, you should again have a look how you get the certificates implace, you can find that here: Connect Storage Explorer to an Azure Stack subscription

Install the Microsoft Azure Storage Explorer
After Storage Explorer restarts, select the Edit menu, and then ensure that Target Azure Stack is selected. If it is not selected, select it, and then restart Storage Explorer for the change to take effect. This configuration is required for compatibility with your Azure Stack environment.
To connect to the Azure Stack account, select Add an account.
In the Connect to Azure Storage dialog box, under Azure environment, select Use Azure Stack Environment, and then click Next.
To sign in with the Azure Stack account that’s associated with at least one active Azure Stack subscription, fill in the Sign in to Azure Stack Environment dialog box.
The details for each field are as follows:Environment name: The field can be customized by user.
ARM resource endpoint: The samples of Azure Resource Manager resource endpoints:For cloud operator:
https://adminmanagement.-region-.-FQDN-
For tenant:
https://management.-region-.-FQDN-
Tenant Id: Optional. The value is given only when the directory must be specified.

This should help you quickly setup an Azure Stack Cloud Operator Workstation. What other tools do you need to manage and operator your Azure Stack? leave a comment.

Tag: WSL

Install Windows Subsystem for Linux on Windows Server

HVC – SSH Direct for Linux VMs on Hyper-V

How to connect to Linux VMs using SSH Direct

Final Thoughts

Microsoft released Windows Server 1709

Windows Server 1709 Features and Improvements

New Windows Server Management Experience

Windows Server Servicing

Crazy times – You can now run Linux on Windows 10 from the Windows Store

Follow Me

About

Sponsor

Sponsor

Sponsor

Sponsor

Tag: WSL

Install Windows Subsystem for Linux on Windows Server

HVC – SSH Direct for Linux VMs on Hyper-V

How to connect to Linux VMs using SSH Direct

Final Thoughts

Setup an Azure Stack Cloud Operator and Developer Workstation Environment

Operating System

Install Visual Studio Code

Install SSH Client or Windows Subsystem for Linux (WSL)

Install Azure Stack PowerShell

Install Azure Stack tools

Configure Azure Stack PowerShell environment

Install and configure CLI for use with Azure Stack

Install Azure CLI on Windows using MSI

Install with apt-get for Bash on Ubuntu on Windows (WSL)

Connect to Azure Stack using the Azure CLI

Install the Microsoft Azure Storage Explorer

Microsoft released Windows Server 1709

Windows Server 1709 Features and Improvements

New Windows Server Management Experience

Windows Server Servicing

Crazy times – You can now run Linux on Windows 10 from the Windows Store

Follow Me

About

Sponsor

Sponsor

Sponsor

Sponsor