Skip to content

Commit 5a9a83f

Browse files
Merge pull request #271519 from arunguru-msft/arunguru-removeiotmarketplace
Remove IOT marketplace references from SQL Edge documentation
2 parents a3f2353 + adc332f commit 5a9a83f

File tree

5 files changed

+24
-41
lines changed

5 files changed

+24
-41
lines changed

articles/azure-sql-edge/configure.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ Add values in **Container Create Options**.
6060
6161
## Configure by using an `mssql.conf` file
6262

63-
Azure SQL Edge doesn't include the [mssql-conf configuration utility](/sql/linux/sql-server-linux-configure-mssql-conf/) like SQL Server on Linux does. You need to manually configure the mssql.conf file and place it in the persistent storage drive that is mapped to the /var/opt/mssql/ folder in the SQL Edge module. When you're deploying SQL Edge from Azure Marketplace, this mapping is specified as the **Mounts** option in the **Container Create Options**.
63+
Azure SQL Edge doesn't include the [mssql-conf configuration utility](/sql/linux/sql-server-linux-configure-mssql-conf/) like SQL Server on Linux does. You need to manually configure the mssql.conf file and place it in the persistent storage drive that is mapped to the /var/opt/mssql/ folder in the SQL Edge module. When you're deploying SQL Edge through Azure IoT Hub, this mapping is specified as the **Mounts** option in the **Container Create Options**.
6464

6565
```json
6666
{
@@ -126,7 +126,7 @@ traceflag2 = 1204
126126

127127
## Run Azure SQL Edge as non-root user
128128

129-
By default, the Azure SQL Edge containers run with a non-root user/group. When deployed through the Azure Marketplace (or using `docker run`), unless a different user/group is specified, SQL Edge containers starts up as the mssql (non-root) user. To specify a different non-root user during deployment, add the `*"User": "<name|uid>[:<group|gid>]"*` key-value pair under container create options. In the following example, SQL Edge is configured to start as the user `*IoTAdmin*`.
129+
By default, the Azure SQL Edge containers run with a non-root user/group. When deployed through the Azure IoT Hub (or using `docker run`), unless a different user/group is specified, SQL Edge containers starts up as the mssql (non-root) user. To specify a different non-root user during deployment, add the `*"User": "<name|uid>[:<group|gid>]"*` key-value pair under container create options. In the following example, SQL Edge is configured to start as the user `*IoTAdmin*`.
130130

131131
```json
132132
{

articles/azure-sql-edge/deploy-portal.md

Lines changed: 18 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -26,45 +26,26 @@ Azure SQL Edge is a relational database engine optimized for IoT and Azure IoT E
2626
> [!NOTE]
2727
> To deploy an Azure Linux VM as an IoT Edge device, see this [quickstart guide](../iot-edge/quickstart-linux.md).
2828
29-
## Deploy SQL Edge Module from Azure Marketplace
29+
## Deploy Azure SQL Edge Module using IoT Hub
3030

31-
Azure Marketplace is an online applications and services marketplace where you can browse through a wide range of enterprise applications and solutions that are certified and optimized to run on Azure, including [IoT Edge modules](https://azuremarketplace.microsoft.com/marketplace/apps/category/internet-of-things?page=1&subcategories=iot-edge-modules). Azure SQL Edge can be deployed to an edge device through the marketplace.
31+
Azure SQL Edge can be deployed using instructions from [Deploy modules from Azure portal](/azure/iot-edge/how-to-deploy-modules-portal). The image URI for Azure SQL Edge is `mcr.microsoft.com/azure-sql-edge:latest`.
3232

33-
1. Find the Azure SQL Edge module on the Azure Marketplace.
33+
1. On the **Add IoT Edge Module** page, specify the desired values for the *IoT Edge Module Name*, *Image URI*, *Restart Policy* and *Desired Status*.
3434

35-
:::image type="content" source="media/deploy-portal/find-offer-marketplace.png" alt-text="Screenshot of SQL Edge in the Azure Marketplace.":::
35+
Use the following image URI depending on the edition you want to deploy:
36+
- *Developer edition* - `mcr.microsoft.com/azure-sql-edge/developer`
37+
- *Premium edition* - `mcr.microsoft.com/azure-sql-edge/premium`
3638

37-
1. Pick the software plan that best matches your requirements and select **Create**.
38-
39-
:::image type="content" source="media/deploy-portal/pick-correct-plan.png" alt-text="Screenshot showing how to pick the correct software plan.":::
40-
41-
1. On the Target Devices for IoT Edge Module page, specify the following details and then select **Create**.
42-
43-
| Field | Description |
44-
| --- | --- |
45-
| **Subscription** | The Azure subscription under which the IoT Hub was created |
46-
| **IoT Hub** | Name of the IoT Hub where the IoT Edge device is registered and then select "Deploy to a device" option |
47-
| **IoT Edge Device Name** | Name of the IoT Edge device where SQL Edge would be deployed |
48-
49-
1. On the **Set Modules on device:** page, select the Azure SQL Edge module under **IoT Edge Modules**. The default module name is set to *AzureSQLEdge*.
50-
51-
1. On the *Module Settings* section of the **Update IoT Edge Module** pane, specify the desired values for the *IoT Edge Module Name*, *Restart Policy* and *Desired Status*.
52-
53-
> [!IMPORTANT]
54-
> Don't change or update the **Image URI** settings on the module.
55-
56-
1. On the *Environment Variables* section of the **Update IoT Edge Module** pane, specify the desired values for the environment variables. For a complete list of Azure SQL Edge environment variables, see [Configure using environment variables](configure.md#configure-by-using-environment-variables). The following default environment variables are defined for the module.
39+
1. On the *Environment Variables* section of the **Add IoT Edge Module** page, specify the desired values for the environment variables. For a complete list of Azure SQL Edge environment variables, see [Configure using environment variables](configure.md#configure-by-using-environment-variables).
5740

5841
| Parameter | Description |
5942
| --- | --- |
60-
| MSSQL_SA_PASSWORD | Change the default value to specify a strong password for the SQL Edge admin account. |
61-
| MSSQL_LCID | Change the default value to set the desired language ID to use for SQL Edge. For example, 1036 is French. |
62-
| MSSQL_COLLATION | Change the default value to set the default collation for SQL Edge. This setting overrides the default mapping of language ID (LCID) to collation. |
63-
64-
> [!IMPORTANT]
65-
> Don't change or update the `ACCEPT_EULA` environment variable for the module.
43+
| ACCEPT_EULA | Set this value to `Y` to accept the [End-User Licensing Agreement](https://go.microsoft.com/fwlink/?linkid=2139274) |
44+
| MSSQL_SA_PASSWORD | Set the value to specify a strong password for the SQL Edge admin account. |
45+
| MSSQL_LCID | Set the value to set the desired language ID to use for SQL Edge. For example, 1036 is French. |
46+
| MSSQL_COLLATION | Set the value to set the default collation for SQL Edge. This setting overrides the default mapping of language ID (LCID) to collation. |
6647

67-
1. On the *Container Create Options* section of the **Update IoT Edge Module** pane, update the following options as per requirement.
48+
1. On the *Container Create Options* section of the **Add IoT Edge Module** page, set the options as per requirement.
6849

6950
- **Host Port**
7051

@@ -107,12 +88,16 @@ Azure Marketplace is an online applications and services marketplace where you c
10788
```
10889

10990
> [!IMPORTANT]
110-
> Don't change the `PlanId` environment variable defined in the create config setting. If this value is changed, the Azure SQL Edge container will fail to start.
91+
> Set the `PlanId` environment variable based on the edition installed.
92+
> - *Developer edition* - `asde-developer-on-iot-edge`
93+
> - *Premium edition* - `asde-premium-on-iot-edge`
94+
>
95+
> If this value is set incorrectly, the Azure SQL Edge container fails to start.
11196
11297
> [!WARNING]
11398
> If you reinstall the module, remember to remove any existing bindings first, otherwise your environment variables will not be updated.
11499
115-
1. On the **Update IoT Edge Module** pane, select **Update**.
100+
1. On the **Add IoT Edge Module** page, select **Add**.
116101
1. On the **Set modules on device** page, select **Next: Routes >** if you need to define routes for your deployment. Otherwise select **Review + Create**. For more information on configuring routes, see [Deploy modules and establish routes in IoT Edge](../iot-edge/module-composition.md).
117102
1. On the **Set modules on device** page, select **Create**.
118103

articles/azure-sql-edge/overview.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ What is Azure SQL Edge video on Channel 9:
3030

3131
Azure SQL Edge supports two deployment modes.
3232

33-
- Connected deployment through Azure IoT Edge: Azure SQL Edge is available on the Azure Marketplace and can be deployed as a module for [Azure IoT Edge](../iot-edge/about-iot-edge.md). For more information, see [Deploy Azure SQL Edge](deploy-portal.md).<br>
33+
- Connected deployment through Azure IoT Edge: Azure SQL Edge is available as a module for [Azure IoT Edge](../iot-edge/about-iot-edge.md). For more information, see [Deploy Azure SQL Edge](deploy-portal.md).
3434

3535
:::image type="content" source="media/overview/overview.png" alt-text="Diagram of SQL Edge overview.":::
3636

articles/azure-sql-edge/troubleshoot.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ This article provides information about possible errors seen when deploying and
2020

2121
Azure SQL Edge supports two deployment models:
2222

23-
- Connected deployment through Azure IoT Edge: Azure SQL Edge is available on the Azure Marketplace and can be deployed as a module for [Azure IoT Edge](../iot-edge/about-iot-edge.md). For more information, see [Deploy Azure SQL Edge](deploy-portal.md).<br>
23+
- Connected deployment through Azure IoT Edge: Azure SQL Edge can be deployed as a module for [Azure IoT Edge](../iot-edge/about-iot-edge.md). For more information, see [Deploy Azure SQL Edge](deploy-portal.md).<br>
2424

2525
- Disconnected deployment: Azure SQL Edge container images can be pulled from Docker hub and deployed either as a standalone container or on a Kubernetes cluster. For more information, see [Deploy Azure SQL Edge with Docker](disconnected-deployment.md) and [Deploy an Azure SQL Edge container in Kubernetes](deploy-kubernetes.md).
2626

articles/azure-sql-edge/tutorial-set-up-iot-edge-modules.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -75,11 +75,9 @@ Now, specify the container credentials in the IoT Edge module.
7575

7676
## Deploy the Azure SQL Edge module
7777

78-
1. Deploy the Azure SQL Edge module by selecting on **+ Add** and then **Marketplace Module**.
78+
1. Deploy the Azure SQL Edge module by selecting on **+ Add** and then **IoT Edge Module**.
7979

80-
1. On the **IoT Edge Module Marketplace** pane, search for *Azure SQL Edge* and pick *Azure SQL Edge Developer*.
81-
82-
1. Select the newly added *Azure SQL Edge* module under **IoT Edge Modules** to configure the Azure SQL Edge module. For more information on the configuration options, see [Deploy Azure SQL Edge](./deploy-portal.md).
80+
1. Set the configuration options in **Add IoT Edge Modules** page to deploy Azure SQL Edge module. For more information on the configuration options, see [Deploy Azure SQL Edge](./deploy-portal.md).
8381

8482
1. Add the `MSSQL_PACKAGE` environment variable to the *Azure SQL Edge* module deployment, and specify the SAS URL of the database dacpac file created in step 8 of [Part one](tutorial-deploy-azure-resources.md) of this tutorial.
8583

0 commit comments

Comments
 (0)