Skip to content

Commit a4af2cc

Browse files
author
Pat Altimore
committed
Move screenshots
1 parent 91f8ef9 commit a4af2cc

File tree

1 file changed

+19
-17
lines changed

1 file changed

+19
-17
lines changed

articles/iot-operations/manage-mqtt-broker/howto-broker-persistence.md

Lines changed: 19 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ To configure volume settings using Azure CLI, prepare a Broker configuration fil
7878
}
7979
```
8080

81-
Then run the [az iot ops create](/cli/azure/iot/ops?view=azure-cli-latest#az-iot-ops-create) command with the `--broker-config-file` flag to deploy IoT Operations:
81+
Then run the [az iot ops create](/cli/azure/iot/ops#az-iot-ops-create) command with the `--broker-config-file` flag to deploy IoT Operations:
8282

8383
```azurecli
8484
az iot ops create --broker-config-file <BROKER_CONFIG_FILE>.json --cluster <CLUSTER_NAME> --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP_NAME> --sr-resource-id <SCHEMA_REGISTRY_RESOURCE_ID>
@@ -141,15 +141,16 @@ This setting controls which retained messages are persisted to disk.
141141

142142
# [Azure portal](#tab/portal)
143143

144-
:::image type="content" source="media/howto-broker-persistence/data-persistence-retained-messages.png" alt-text="[Screenshot changing data persistence retained messages options the Azure portal]":::
145144

146145
To configure retained messages persistence in the Azure portal:
147146

148147
1. Navigate to your IoT Operations instance.
149148
2. Go to **MQTT Broker** > **Data Persistence**.
150149
3. In the **Retained Messages** section:
151-
- Select the **Mode**: None, All, or Custom.
152-
- If Custom is selected, specify topic patterns and dynamic mode settings.
150+
- Select the **Mode**: None, All, or Custom.
151+
- If Custom is selected, specify topic patterns and dynamic mode settings.
152+
153+
:::image type="content" source="media/howto-broker-persistence/data-persistence-retained-messages.png" alt-text="[Screenshot changing data persistence retained messages options the Azure portal]":::
153154

154155
# [Azure CLI](#tab/azurecli)
155156

@@ -186,15 +187,16 @@ This setting controls which subscriber message queues are persisted to disk. Ses
186187

187188
# [Azure portal](#tab/portal)
188189

189-
:::image type="content" source="media/howto-broker-persistence/data-persistence-subscriber.png" alt-text="[Screenshot changing data persistence subscriber options the Azure portal]":::
190190

191191
To configure subscriber queue persistence in the Azure portal:
192192

193193
1. Navigate to your IoT Operations instance.
194194
2. Go to **MQTT Broker** > **Data Persistence**.
195195
3. In the **Subscriber Queue** section:
196-
- Select the **Mode**: None, All, or Custom.
197-
- If Custom is selected, specify subscriber client IDs and dynamic mode settings.
196+
- Select the **Mode**: None, All, or Custom.
197+
- If Custom is selected, specify subscriber client IDs and dynamic mode settings.
198+
199+
:::image type="content" source="media/howto-broker-persistence/data-persistence-subscriber.png" alt-text="[Screenshot changing data persistence subscriber options the Azure portal]":::
198200

199201
# [Azure CLI](#tab/azurecli)
200202

@@ -204,7 +206,7 @@ Use the `az iot ops broker persist update` command to update the subscriber queu
204206
az iot ops broker persist update --resource-group <ResourceGroupName> --instance <AioInstanceName> --name <BrokerName> --persist-mode subscriberQueue=<PersistMode>
205207
```
206208

207-
Here's an example command configure persistence for all subscriber queues:
209+
Here's an example command to configure persistence for all subscriber queues:
208210

209211
```azurecli
210212
az iot ops broker persist update --resource-group myResourceGroup --instance myAioInstance --name myBroker --persist-mode subscriberQueue=All
@@ -269,15 +271,15 @@ This setting controls which keys in the internal state store are persisted.
269271

270272
# [Azure portal](#tab/portal)
271273

272-
:::image type="content" source="media/howto-broker-persistence/data-persistence-state-store.png" alt-text="[Screenshot changing data persistence state store options the Azure portal]":::
273274

274275
To configure state store persistence in the Azure portal:
275276

276277
1. Navigate to your IoT Operations instance.
277278
2. Go to **MQTT Broker** > **Data Persistence**.
278279
3. In the **State Store** section:
279-
- Select the **Mode**: None, All, or Custom.
280-
- If Custom is selected, specify state store resources with key types, keys, and dynamic mode settings.
280+
- Select the **Mode**: None, All, or Custom.
281+
- If Custom is selected, specify state store resources with key types, keys, and dynamic mode settings.
282+
:::image type="content" source="media/howto-broker-persistence/data-persistence-state-store.png" alt-text="[Screenshot changing data persistence state store options the Azure portal]":::
281283

282284
# [Azure CLI](#tab/azurecli)
283285

@@ -305,17 +307,18 @@ You can enable or disable the dynamic persistence setting for each data type (re
305307

306308
# [Azure portal](#tab/portal)
307309

308-
:::image type="content" source="media/howto-broker-persistence/data-persistence-dynamic.png" alt-text="[Screenshot changing data persistence subscriber options the Azure portal]":::
309310

310311
To configure dynamic persistence settings in the Azure portal:
311312

312313
1. Navigate to your IoT Operations instance.
313314
2. Go to **MQTT Broker** > **Data Persistence**.
314315
3. Configure the global MQTT user property settings:
315-
- Set the **User property key** (default: `aio-persistence`)
316-
- Set the **User property value** (default: `true`)
316+
- Set the **User property key** (default: `aio-persistence`)
317+
- Set the **User property value** (default: `true`)
317318
4. In each persistence section (Retained Messages, Subscriber Queue, State Store):
318-
- Set **Dynamic persistence** to enabled to allow clients to request persistence for that data type.
319+
- Set **Dynamic persistence** to enabled to allow clients to request persistence for that data type.
320+
321+
:::image type="content" source="media/howto-broker-persistence/data-persistence-dynamic.png" alt-text="[Screenshot changing data persistence dynamic options the Azure portal]":::
319322

320323
# [Azure CLI](#tab/azurecli)
321324

@@ -331,7 +334,6 @@ Here's an example command Configure subscriber queue persistence for specific cl
331334
az iot ops broker persist update --resource-group myResourceGroup --instance myAioInstance --name myBroker --persist-mode subscriberQueue=Custom --subscriber-client-ids "factory-client-*" "sensor-gateway-01"--user-key disk-persistence --user-value disk
332335
```
333336

334-
---
337+
---
335338

336339
To learn more about Azure CLI support for advanced MQTT broker configuration, see [Azure CLI support for advanced MQTT broker configuration](https://aka.ms/aziotops-broker-config).
337-

0 commit comments

Comments
 (0)