Skip to content

Commit e78f0ad

Browse files
authored
Merge pull request #154876 from alkohli/2104
First set of changes
2 parents f723e7d + 218cb32 commit e78f0ad

9 files changed

+191
-56
lines changed

articles/databox-online/azure-stack-edge-gpu-connect-powershell-interface.md

Lines changed: 61 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,14 +7,14 @@ author: alkohli
77
ms.service: databox
88
ms.subservice: edge
99
ms.topic: how-to
10-
ms.date: 03/30/2021
10+
ms.date: 04/15/2021
1111
ms.author: alkohli
1212
---
1313
# Manage an Azure Stack Edge Pro GPU device via Windows PowerShell
1414

1515
[!INCLUDE [applies-to-GPU-and-pro-r-and-mini-r-skus](../../includes/azure-stack-edge-applies-to-gpu-pro-r-mini-r-sku.md)]
1616

17-
Azure Stack Edge Pro solution lets you process data and send it over the network to Azure. This article describes some of the configuration and management tasks for your Azure Stack Edge Pro device. You can use the Azure portal, local web UI, or the Windows PowerShell interface to manage your device.
17+
Azure Stack Edge Pro GPU solution lets you process data and send it over the network to Azure. This article describes some of the configuration and management tasks for your Azure Stack Edge Pro GPU device. You can use the Azure portal, local web UI, or the Windows PowerShell interface to manage your device.
1818

1919
This article focuses on how you can connect to the PowerShell interface of the device and the tasks you can do using this interface.
2020

@@ -70,6 +70,62 @@ A Multi-Process Service (MPS) on Nvidia GPUs provides a mechanism where GPUs can
7070
> [!NOTE]
7171
> When the device software and the Kubernetes cluster are updated, the MPS setting is not retained for the workloads. You'll need to enable MPS again.
7272
73+
<!--## Enable compute on private network
74+
75+
Use the `Add-HcsNetRoute` cmdlet to enable compute on a private network. This cmdlet lets you add custom routes on Kubernetes master and worker VMs.
76+
#### Add new route configuration
77+
78+
IP routing is the process of forwarding a packet based on the destination IP address. For the Kubernetes VMs on your device, you can route the traffic by adding a new route configuration.
79+
80+
A route configuration is a routing table entry that includes the following fields:
81+
82+
| Parameter | Description |
83+
|---------|---------|
84+
|Destination | Either an IP address or an IP address prefix. |
85+
|Prefix length | The prefix length corresponding to the address or range of addresses in the destination. |
86+
|Next hop | The IP address to which the packet is forwarded. |
87+
|Interface | The network interface that forwards the IP packet. |
88+
|Metric |Routing metric determines the preferred network interface used to reach the destination. |
89+
90+
91+
Consider the following information before you add these routes:
92+
93+
- The Kubernetes network where you are adding this route is in a private network and not connected to the internet.
94+
- The device port on which the compute is enabled does not have a gateway configured.
95+
- If you have a flat subnet, then you don't need to add these routes to the private network. You can (optionally) add these routes when there are multiple subnets on your private network.
96+
- You can add these routes only to the Kubernetes master and worker VMs and not to the device (Windows host).
97+
- The Kubernetes compute need not be configured before you add this route. You can also add or update routes after the Kubernetes compute is configured. You can only add a new route configuration via the PowerShell interface of the device and not through the local UI.
98+
- Make sure that the network interface that you'll use has a static configuration.
99+
100+
Consider an example where Port 1 and Port 2 on your device are connected to the internet. Ports 3 to Port 6 are on a private network and is the same network that has the Kubernetes master and worker VMs. None of the ports 3 to 6 have a default gateway configured. There are cameras that are connected to the private network. And the camera feed creates a traffic that flows between the camera and the network interfaces on the Kubernetes VMs.
101+
102+
To add a new custom route, use the cmdlet as follows:
103+
104+
```powershell
105+
Add-HcsNetRoute -InterfaceAlias "Port3" -DestinationPrefix "192.168.21.0/24" -NextHop "192.168.20.1" -RouteMetric 100
106+
```
107+
108+
Here the compute is enabled on the Port 3 network interface on your device and a virtual switch is created. The above route defines a destination subnet 192.168.21.0/24 and specifies the next hop as 192.168.20.1. This routing configuration has a routing metric of 100. Lower the routing metric, higher the priority assigned to the route.
109+
110+
111+
#### Check route configuration for an interface
112+
113+
Use this cmdlet to check for all the custom route configurations that you added on your device. These routes do not include all the system routes or default routes that already exist on the device.
114+
115+
```powershell
116+
Get-HcsNetRoute -InterfaceAlias Port3
117+
```
118+
119+
120+
#### Remove a route configuration
121+
122+
Use this cmdlet to remove a route configuration that you added on your device.
123+
124+
```powershell
125+
Remove-HcsNetRoute -InterfaceAlias "Port3" -DestinationPrefix "192.168.21.0/24"
126+
```
127+
-->
128+
73129
## Reset your device
74130

75131
[!INCLUDE [Reset your device](../../includes/data-box-edge-gateway-deactivate-device.md)]
@@ -127,7 +183,7 @@ Before you begin, you must have:
127183
- Compute network configured. See [Tutorial: Configure network for Azure Stack Edge Pro with GPU](azure-stack-edge-gpu-deploy-configure-network-compute-web-proxy.md).
128184
- Compute role configured on your device.
129185

130-
On an Azure Stack Edge Pro device that has the compute role configured, you can troubleshoot or monitor the device using two different sets of commands.
186+
On an Azure Stack Edge Pro GPU device that has the compute role configured, you can troubleshoot or monitor the device using two different sets of commands.
131187

132188
- Using `iotedge` commands. These commands are available for basic operations for your device.
133189
- Using `kubectl` commands. These commands are available for an extensive set of operations for your device.
@@ -239,7 +295,7 @@ Here is a sample output.
239295

240296
### Use kubectl commands
241297

242-
On an Azure Stack Edge Pro device that has the compute role configured, all the `kubectl` commands are available to monitor or troubleshoot modules. To see a list of available commands, run `kubectl --help` from the command window.
298+
On an Azure Stack Edge Pro GPU device that has the compute role configured, all the `kubectl` commands are available to monitor or troubleshoot modules. To see a list of available commands, run `kubectl --help` from the command window.
243299

244300
```PowerShell
245301
C:\Users\myuser>kubectl --help
@@ -599,4 +655,4 @@ To exit the remote PowerShell session, close the PowerShell window.
599655
600656
## Next steps
601657
602-
- Deploy [Azure Stack Edge Pro](azure-stack-edge-gpu-deploy-prep.md) in Azure portal.
658+
- Deploy [Azure Stack Edge Pro GPU](azure-stack-edge-gpu-deploy-prep.md) in Azure portal.

articles/databox-online/azure-stack-edge-gpu-overview.md

Lines changed: 22 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,9 @@ author: alkohli
77
ms.service: databox
88
ms.subservice: edge
99
ms.topic: overview
10-
ms.date: 01/18/2021
10+
ms.date: 04/19/2021
1111
ms.author: alkohli
12-
#Customer intent: As an IT admin, I need to understand what Azure Stack Edge Pro is and how it works so I can use it to process and transform data before sending to Azure.
12+
#Customer intent: As an IT admin, I need to understand what Azure Stack Edge Pro GPU is and how it works so I can use it to process and transform data before sending to Azure.
1313
---
1414
# What is Azure Stack Edge Pro with GPU?
1515

@@ -19,10 +19,10 @@ Azure Stack Edge Pro with GPU is a Hardware-as-a-service solution. Microsoft shi
1919

2020
## Use cases
2121

22-
Here are the various scenarios where Azure Stack Edge Pro can be used for rapid Machine Learning (ML) inferencing at the edge and preprocessing data before sending it to Azure.
22+
Here are the various scenarios where Azure Stack Edge Pro GPU can be used for rapid Machine Learning (ML) inferencing at the edge and preprocessing data before sending it to Azure.
2323

24-
- **Inference with Azure Machine Learning** - With Azure Stack Edge Pro, you can run ML models to get quick results that can be acted on before the data is sent to the cloud. The full data set can optionally be transferred to continue to retrain and improve your ML models. For more information on how to use the Azure ML hardware accelerated models on the Azure Stack Edge Pro device, see
25-
[Deploy Azure ML hardware accelerated models on Azure Stack Edge Pro](../machine-learning/how-to-deploy-fpga-web-service.md#deploy-to-a-local-edge-server).
24+
- **Inference with Azure Machine Learning** - With Azure Stack Edge Pro GPU, you can run ML models to get quick results that can be acted on before the data is sent to the cloud. The full data set can optionally be transferred to continue to retrain and improve your ML models. For more information on how to use the Azure ML hardware accelerated models on the Azure Stack Edge Pro GPU device, see
25+
[Deploy Azure ML hardware accelerated models on Azure Stack Edge Pro GPU](../machine-learning/how-to-deploy-fpga-web-service.md#deploy-to-a-local-edge-server).
2626

2727
- **Preprocess data** - Transform data before sending it to Azure via compute options such as containerized workloads and Virtual Machines to create a more actionable dataset. Preprocessing can be used to:
2828

@@ -31,11 +31,11 @@ Here are the various scenarios where Azure Stack Edge Pro can be used for rapid
3131
- Subset data to optimize storage and bandwidth, or for further analysis.
3232
- Analyze and react to IoT Events.
3333

34-
- **Transfer data over network to Azure** - Use Azure Stack Edge Pro to easily and quickly transfer data to Azure to enable further compute and analytics or for archival purposes.
34+
- **Transfer data over network to Azure** - Use Azure Stack Edge Pro GPU to easily and quickly transfer data to Azure to enable further compute and analytics or for archival purposes.
3535

3636
## Key capabilities
3737

38-
Azure Stack Edge Pro has the following capabilities:
38+
Azure Stack Edge Pro GPU has the following capabilities:
3939

4040
|Capability |Description |
4141
|---------|---------|
@@ -44,7 +44,7 @@ Azure Stack Edge Pro has the following capabilities:
4444
|Data access | Direct data access from Azure Storage Blobs and Azure Files using cloud APIs for additional data processing in the cloud. Local cache on the device is used for fast access of most recently used files.|
4545
|Cloud-managed |Device and service are managed via the Azure portal. |
4646
|Offline upload | Disconnected mode supports offline upload scenarios.|
47-
|Supported file transfer protocols | Support for standard SMB, NFS, and REST protocols for data ingestion. <br> For more information on supported versions, see [Azure Stack Edge Pro system requirements](azure-stack-edge-system-requirements.md).|
47+
|Supported file transfer protocols | Support for standard SMB, NFS, and REST protocols for data ingestion. <br> For more information on supported versions, see [Azure Stack Edge Pro GPU system requirements](azure-stack-edge-system-requirements.md).|
4848
|Data refresh | Ability to refresh local files with the latest from cloud.|
4949
|Encryption | BitLocker support to locally encrypt data and secure data transfer to cloud over *https*.|
5050
|Bandwidth throttling| Throttle to limit bandwidth usage during peak hours.|
@@ -53,33 +53,35 @@ Azure Stack Edge Pro has the following capabilities:
5353

5454
## Components
5555

56-
The Azure Stack Edge Pro solution comprises of Azure Stack Edge resource, Azure Stack Edge Pro physical device, and a local web UI.
56+
The Azure Stack Edge Pro GPU solution comprises of Azure Stack Edge resource, Azure Stack Edge Pro GPU physical device, and a local web UI.
5757

58-
* **Azure Stack Edge Pro physical device** - A 1U rack-mounted server supplied by Microsoft that can be configured to send data to Azure.
58+
* **Azure Stack Edge Pro GPU physical device** - A 1U rack-mounted server supplied by Microsoft that can be configured to send data to Azure.
5959

60-
* **Azure Stack Edge resource** – A resource in the Azure portal that lets you manage an Azure Stack Edge Pro device from a web interface that you can access from different geographical locations. Use the Azure Stack Edge resource to create and manage resources, view, and manage devices and alerts, and manage shares.
60+
* **Azure Stack Edge resource** – A resource in the Azure portal that lets you manage an Azure Stack Edge Pro GPU device from a web interface that you can access from different geographical locations. Use the Azure Stack Edge resource to create and manage resources, view, and manage devices and alerts, and manage shares.
6161

62-
For more information, go to [Create an order for your Azure Stack Edge Pro device](azure-stack-edge-gpu-deploy-prep.md#create-a-new-resource).
62+
For more information, go to [Create an order for your Azure Stack Edge Pro GPU device](azure-stack-edge-gpu-deploy-prep.md#create-a-new-resource).
6363

64-
* **Azure Stack Edge Pro local web UI** - A browser-based local user interface on your Azure Stack Edge Pro device primarily intended for the initial configuration of the device. Use the local web UI also to run diagnostics, shut down and restart the Azure Stack Edge Pro device, view copy logs, and contact Microsoft Support to file a service request.
64+
* **Azure Stack Edge Pro GPU local web UI** - A browser-based local user interface on your Azure Stack Edge Pro GPU device primarily intended for the initial configuration of the device. Use the local web UI also to run diagnostics, shut down and restart the Azure Stack Edge Pro GPU device, view copy logs, and contact Microsoft Support to file a service request.
6565

66-
For information about using the web-based UI, go to [Use the web-based UI to administer your Azure Stack Edge Pro](azure-stack-edge-manage-access-power-connectivity-mode.md).
66+
[!INCLUDE [azure-stack-edge-gateway-local-web-ui-languages](../../includes/azure-stack-edge-gateway-local-web-ui-languages.md)]
67+
68+
For information about using the web-based UI, go to [Use the web-based UI to administer your Azure Stack Edge Pro GPU](azure-stack-edge-manage-access-power-connectivity-mode.md).
6769

6870
## Region availability
6971

70-
Azure Stack Edge Pro physical device, Azure resource, and target storage account to which you transfer data do not all have to be in the same region.
72+
Azure Stack Edge Pro GPU physical device, Azure resource, and target storage account to which you transfer data do not all have to be in the same region.
7173

7274
- **Resource availability** - For this release, the resource is available in East US, West EU, and South East Asia regions.
7375

74-
- **Device availability** - For a list of all the countries/regions where the Azure Stack Edge Pro device is available, go to **Availability** section in the **Azure Stack Edge Pro** tab for [Azure Stack Edge Pro pricing](https://azure.microsoft.com/pricing/details/azure-stack/edge/#azureStackEdgePro).
76+
- **Device availability** - For a list of all the countries/regions where the Azure Stack Edge Pro GPU device is available, go to **Availability** section in the **Azure Stack Edge Pro** tab for [Azure Stack Edge Pro GPU pricing](https://azure.microsoft.com/pricing/details/azure-stack/edge/#azureStackEdgePro).
7577

76-
- **Destination Storage accounts** - The storage accounts that store the data are available in all Azure regions. The regions where the storage accounts store Azure Stack Edge Pro data should be located close to where the device is located for optimum performance. A storage account located far from the device results in long latencies and slower performance.
78+
- **Destination Storage accounts** - The storage accounts that store the data are available in all Azure regions. The regions where the storage accounts store Azure Stack Edge Pro GPU data should be located close to where the device is located for optimum performance. A storage account located far from the device results in long latencies and slower performance.
7779

7880
Azure Stack Edge service is a non-regional service. For more information, see [Regions and Availability Zones in Azure](../availability-zones/az-overview.md). Azure Stack Edge service does not have dependency on a specific Azure region, making it resilient to zone-wide outages and region-wide outages.
7981

8082
## Next steps
8183

82-
- Review the [Azure Stack Edge Pro system requirements](azure-stack-edge-gpu-system-requirements.md).
84+
- Review the [Azure Stack Edge Pro GPU system requirements](azure-stack-edge-gpu-system-requirements.md).
8385

84-
- Understand the [Azure Stack Edge Pro limits](azure-stack-edge-limits.md).
85-
- Deploy [Azure Stack Edge Pro](azure-stack-edge-gpu-deploy-prep.md) in Azure portal.
86+
- Understand the [Azure Stack Edge Pro GPU limits](azure-stack-edge-limits.md).
87+
- Deploy [Azure Stack Edge Pro GPU](azure-stack-edge-gpu-deploy-prep.md) in Azure portal.

articles/databox-online/azure-stack-edge-gpu-system-requirements.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.subservice: edge
99
ms.topic: conceptual
1010
ms.date: 04/26/2021
1111
ms.author: alkohli
12-
ms.custom: "contperf-fy21q3"
12+
ms.custom: "contperf-fy21q4"
1313
---
1414
# System requirements for Azure Stack Edge Pro with GPU
1515

articles/databox-online/azure-stack-edge-mini-r-overview.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: alkohli
77
ms.service: databox
88
ms.subservice: edge
99
ms.topic: overview
10-
ms.date: 03/03/2021
10+
ms.date: 04/19/2021
1111
ms.author: alkohli
1212
#Customer intent: As an IT admin, I need to understand what Azure Stack Edge Mini R is and how it works so I can use it to process and transform data before sending to Azure.
1313
---
@@ -66,6 +66,7 @@ The Azure Stack Edge Mini R solution comprises of an Azure Stack Edge resource,
6666

6767
* **Azure Stack Edge Mini R local web UI** - A browser-based local user interface on your Azure Stack Edge Mini R device primarily intended for the initial configuration of the device. Use the local web UI also to run diagnostics, shut down and restart the Azure Stack Edge Pro device, view copy logs, and contact Microsoft Support to file a service request.
6868

69+
[!INCLUDE [azure-stack-edge-gateway-local-web-ui-languages](../../includes/azure-stack-edge-gateway-local-web-ui-languages.md)]
6970

7071
## Region availability
7172

articles/databox-online/azure-stack-edge-pro-r-overview.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: alkohli
77
ms.service: databox
88
ms.subservice: edge
99
ms.topic: overview
10-
ms.date: 02/22/2021
10+
ms.date: 04/19/2021
1111
ms.author: alkohli
1212
#Customer intent: As an IT admin, I need to understand what Azure Stack Edge Pro R is and how it works so I can use it to process and transform data before sending to Azure.
1313
---
@@ -66,6 +66,8 @@ The Azure Stack Edge Pro R solution comprises of an Azure Stack Edge resource, A
6666

6767
- **Azure Stack Edge Pro R local web UI** - A browser-based local user interface on your Azure Stack Edge Pro R device primarily intended for the initial configuration of the device. Use the local web UI also to run diagnostics, shut down and restart the Azure Stack Edge Pro device, view copy logs, and contact Microsoft Support to file a service request.
6868

69+
[!INCLUDE [azure-stack-edge-gateway-local-web-ui-languages](../../includes/azure-stack-edge-gateway-local-web-ui-languages.md)]
70+
6971

7072
## Region availability
7173

articles/databox/data-box-overview.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ author: alkohli
88
ms.service: databox
99
ms.subservice: pod
1010
ms.topic: overview
11-
ms.date: 12/18/2020
11+
ms.date: 04/19/2021
1212
ms.author: alkohli
1313
#Customer intent: As an IT admin, I need to understand what Data Box is and how it works so I can use it to import on-premises data into Azure or export data from Azure.
1414
---
@@ -96,6 +96,17 @@ The Data Box includes the following components:
9696

9797
![The Data Box local web UI](media/data-box-overview/data-box-local-web-ui.png)
9898

99+
The local web UI on the device currently supports the following languages with their corresponding language codes:
100+
101+
| Language | Code | Language | Code | Language | Code |
102+
|----------------------|------|-------------------------|--------|-------------------------|--------------|
103+
| English {default} | en | Czech | cs | German | de |
104+
| Spanish | es | French | fr | Hungarian | hu |
105+
| Italian | it | Japanese | ja | Korean | ko |
106+
| Dutch | nl | Polish | pl | Portuguese - Brazil | pt-br |
107+
| Portuguese - Portugal| pt-pt| Russian | ru | Swedish | sv |
108+
| Turkish | tr | Chinese - simplified | zh-hans| | |
109+
99110
For information about using the web-based UI, go to [Use the web-based UI to administer your Data Box](data-box-portal-ui-admin.md).
100111

101112
## The workflow

0 commit comments

Comments
 (0)