added mqtt port prereq to all send telemetry and control device quicstarts

JimacoMS3 · JimacoMS3 · commit 61f7c4dcb589 · 2020-02-07T17:37:07.000-08:00
diff --git a/articles/iot-hub/quickstart-control-device-android.md b/articles/iot-hub/quickstart-control-device-android.md
@@ -43,6 +43,8 @@ If you don’t have an Azure subscription, create a [free account](https://azure
 
 * Two sample applications are required by this quickstart: The [Device SDK sample Android application](https://github.com/Azure-Samples/azure-iot-samples-java/tree/master/iot-hub/Samples/device/AndroidSample) and the [Service SDK sample Android application](https://github.com/Azure-Samples/azure-iot-samples-java/tree/master/iot-hub/Samples/service/AndroidSample). Both of these samples are part of the azure-iot-samples-java repository on GitHub. Download or clone the [azure-iot-samples-java](https://github.com/Azure-Samples/azure-iot-samples-java) repository.
 
+Make sure that port 8883 is open in your firewall. The sample in this quickstart uses MQTT protocol, which communicates over port 8883. This port may be blocked in some corporate and educational network environments. For more information and ways to work around this issue, see [Connecting to IoT Hub (MQTT)](iot-hub-mqtt-support.md#connecting-to-iot-hub).
+
 ## Create an IoT hub
 
 If you completed the previous [Quickstart: Send telemetry from a device to an IoT hub](quickstart-send-telemetry-android.md), you can skip this step and use the IoT hub you have already created.
diff --git a/articles/iot-hub/quickstart-control-device-dotnet.md b/articles/iot-hub/quickstart-control-device-dotnet.md
@@ -49,6 +49,8 @@ az extension add --name azure-cli-iot-ext
 
 If you haven't already done so, download the Azure IoT C# samples from https://github.com/Azure-Samples/azure-iot-samples-csharp/archive/master.zip and extract the ZIP archive.
 
+Make sure that port 8883 is open in your firewall. The sample in this quickstart uses MQTT protocol, which communicates over port 8883. This port may be blocked in some corporate and educational network environments. For more information and ways to work around this issue, see [Connecting to IoT Hub (MQTT)](iot-hub-mqtt-support.md#connecting-to-iot-hub).
+
 ## Create an IoT hub
 
 If you completed the previous [Quickstart: Send telemetry from a device to an IoT hub](quickstart-send-telemetry-dotnet.md), you can skip this step.
diff --git a/articles/iot-hub/quickstart-control-device-java.md b/articles/iot-hub/quickstart-control-device-java.md
@@ -57,6 +57,8 @@ az extension add --name azure-cli-iot-ext
 
 If you haven't already done so, download the sample Java project from https://github.com/Azure-Samples/azure-iot-samples-java/archive/master.zip and extract the ZIP archive.
 
+Make sure that port 8883 is open in your firewall. The sample in this quickstart uses MQTT protocol, which communicates over port 8883. This port may be blocked in some corporate and educational network environments. For more information and ways to work around this issue, see [Connecting to IoT Hub (MQTT)](iot-hub-mqtt-support.md#connecting-to-iot-hub).
+
 ## Create an IoT hub
 
 If you completed the previous [Quickstart: Send telemetry from a device to an IoT hub](quickstart-send-telemetry-java.md), you can skip this step.
diff --git a/articles/iot-hub/quickstart-control-device-node.md b/articles/iot-hub/quickstart-control-device-node.md
@@ -49,6 +49,8 @@ az extension add --name azure-cli-iot-ext
 
 If you haven't already done so, download the sample Node.js project from https://github.com/Azure-Samples/azure-iot-samples-node/archive/master.zip and extract the ZIP archive.
 
+Make sure that port 8883 is open in your firewall. The sample in this quickstart uses MQTT protocol, which communicates over port 8883. This port may be blocked in some corporate and educational network environments. For more information and ways to work around this issue, see [Connecting to IoT Hub (MQTT)](iot-hub-mqtt-support.md#connecting-to-iot-hub).
+
 ## Create an IoT hub
 
 If you completed the previous [Quickstart: Send telemetry from a device to an IoT hub](quickstart-send-telemetry-node.md), you can skip this step.
diff --git a/articles/iot-hub/quickstart-control-device-python.md b/articles/iot-hub/quickstart-control-device-python.md
@@ -41,6 +41,8 @@ If you haven't already done so, download the sample Python project from https://
 
 Have [Python version 3.7 or later](https://www.python.org/downloads/) installed on your development machine. For other versions of Python supported, see [Azure IoT Device Features](https://github.com/Azure/azure-iot-sdk-python/tree/master/azure-iot-device#azure-iot-device-features) in the SDK documentation.
 
+Make sure that port 8883 is open in your firewall. The sample in this quickstart uses MQTT protocol, which communicates over port 8883. This port may be blocked in some corporate and educational network environments. For more information and ways to work around this issue, see [Connecting to IoT Hub (MQTT)](iot-hub-mqtt-support.md#connecting-to-iot-hub).
+
 ## Create an IoT hub
 
 If you completed the previous [Quickstart: Send telemetry from a device to an IoT hub](quickstart-send-telemetry-python.md), you can skip this step.
diff --git a/articles/iot-hub/quickstart-send-telemetry-android.md b/articles/iot-hub/quickstart-send-telemetry-android.md
@@ -39,6 +39,8 @@ If you don’t have an Azure subscription, create a [free account](https://azure
 
 * The [sample Android application](https://github.com/Azure-Samples/azure-iot-samples-java/tree/master/iot-hub/Samples/device/AndroidSample) you run in this quickstart is part of the azure-iot-samples-java repository on GitHub. Download or clone the [azure-iot-samples-java](https://github.com/Azure-Samples/azure-iot-samples-java) repository.
 
+Make sure that port 8883 is open in your firewall. The sample in this quickstart uses MQTT protocol, which communicates over port 8883. This port may be blocked in some corporate and educational network environments. For more information and ways to work around this issue, see [Connecting to IoT Hub (MQTT)](iot-hub-mqtt-support.md#connecting-to-iot-hub).
+
 ## Create an IoT hub
 
 [!INCLUDE [iot-hub-include-create-hub](../../includes/iot-hub-include-create-hub.md)]
diff --git a/articles/iot-hub/quickstart-send-telemetry-c.md b/articles/iot-hub/quickstart-send-telemetry-c.md
@@ -37,6 +37,8 @@ If you don’t have an Azure subscription, create a [free account](https://azure
    az extension add --name azure-cli-iot-ext
    ```
 
+* Make sure that port 8883 is open in your firewall. The sample in this quickstart uses MQTT protocol, which communicates over port 8883. This port may be blocked in some corporate and educational network environments. For more information and ways to work around this issue, see [Connecting to IoT Hub (MQTT)](iot-hub-mqtt-support.md#connecting-to-iot-hub).
+
 ## Prepare the development environment
 
 For this quickstart, you'll be using the [Azure IoT device SDK for C](iot-hub-device-sdk-c-intro.md). 
diff --git a/articles/iot-hub/quickstart-send-telemetry-dotnet.md b/articles/iot-hub/quickstart-send-telemetry-dotnet.md
@@ -45,7 +45,7 @@ az extension add --name azure-cli-iot-ext
 
 Download the Azure IoT C# samples from https://github.com/Azure-Samples/azure-iot-samples-csharp/archive/master.zip and extract the ZIP archive.
 
-Make sure that port 8883 is open in your firewall. The sample in this quickstart uses MQTT protocol, which communicates over port 8883. This port may be blocked in some corporate and educational network environments. For more information and ways to work-around this issue, see [Connecting to IoT Hub (MQTT)](iot-hub-mqtt-support.md#connecting-to-iot-hub).
+Make sure that port 8883 is open in your firewall. The sample in this quickstart uses MQTT protocol, which communicates over port 8883. This port may be blocked in some corporate and educational network environments. For more information and ways to work around this issue, see [Connecting to IoT Hub (MQTT)](iot-hub-mqtt-support.md#connecting-to-iot-hub).
 
 ## Create an IoT hub
 
diff --git a/articles/iot-hub/quickstart-send-telemetry-ios.md b/articles/iot-hub/quickstart-send-telemetry-ios.md
@@ -35,6 +35,8 @@ If you don’t have an Azure subscription, create a [free account](https://azure
    az extension add --name azure-cli-iot-ext
    ```
 
+- Make sure that port 8883 is open in your firewall. The sample in this quickstart uses MQTT protocol, which communicates over port 8883. This port may be blocked in some corporate and educational network environments. For more information and ways to work around this issue, see [Connecting to IoT Hub (MQTT)](iot-hub-mqtt-support.md#connecting-to-iot-hub).
+
 ## Create an IoT hub
 
 [!INCLUDE [iot-hub-include-create-hub](../../includes/iot-hub-include-create-hub.md)]
diff --git a/articles/iot-hub/quickstart-send-telemetry-java.md b/articles/iot-hub/quickstart-send-telemetry-java.md
@@ -53,6 +53,8 @@ az extension add --name azure-cli-iot-ext
 
 Download the sample Java project from https://github.com/Azure-Samples/azure-iot-samples-java/archive/master.zip and extract the ZIP archive.
 
+Make sure that port 8883 is open in your firewall. The sample in this quickstart uses MQTT protocol, which communicates over port 8883. This port may be blocked in some corporate and educational network environments. For more information and ways to work around this issue, see [Connecting to IoT Hub (MQTT)](iot-hub-mqtt-support.md#connecting-to-iot-hub).
+
 ## Create an IoT hub
 
 [!INCLUDE [iot-hub-include-create-hub](../../includes/iot-hub-include-create-hub.md)]
diff --git a/articles/iot-hub/quickstart-send-telemetry-node.md b/articles/iot-hub/quickstart-send-telemetry-node.md
@@ -45,6 +45,8 @@ az extension add --name azure-cli-iot-ext
 
 Download the sample Node.js project from https://github.com/Azure-Samples/azure-iot-samples-node/archive/master.zip and extract the ZIP archive.
 
+Make sure that port 8883 is open in your firewall. The sample in this quickstart uses MQTT protocol, which communicates over port 8883. This port may be blocked in some corporate and educational network environments. For more information and ways to work around this issue, see [Connecting to IoT Hub (MQTT)](iot-hub-mqtt-support.md#connecting-to-iot-hub).
+
 ## Create an IoT hub
 
 [!INCLUDE [iot-hub-include-create-hub](../../includes/iot-hub-include-create-hub.md)]
diff --git a/articles/iot-hub/quickstart-send-telemetry-python.md b/articles/iot-hub/quickstart-send-telemetry-python.md
@@ -35,6 +35,8 @@ Download the sample Python project from https://github.com/Azure-Samples/azure-i
 
 Have [Python version 3.7 or later](https://www.python.org/downloads/) installed on your development machine. For other versions of Python supported, see [Azure IoT Device Features](https://github.com/Azure/azure-iot-sdk-python/tree/master/azure-iot-device#azure-iot-device-features) in the SDK documentation.
 
+Make sure that port 8883 is open in your firewall. The sample in this quickstart uses MQTT protocol, which communicates over port 8883. This port may be blocked in some corporate and educational network environments. For more information and ways to work around this issue, see [Connecting to IoT Hub (MQTT)](iot-hub-mqtt-support.md#connecting-to-iot-hub).
+
 ## Create an IoT hub
 
 [!INCLUDE [iot-hub-include-create-hub](../../includes/iot-hub-include-create-hub.md)]
