Skip to content

Commit 02cd083

Browse files
authored
Merge pull request #110632 from priestlg/gdpDBEManageSharesFix-040720
Fixing misaligned images so they render correctly.
2 parents a0b3fd9 + c0d0c8d commit 02cd083

File tree

1 file changed

+32
-35
lines changed

1 file changed

+32
-35
lines changed

articles/databox-online/data-box-edge-manage-shares.md

Lines changed: 32 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -24,12 +24,12 @@ To transfer data to Azure, you need to create shares on your Azure Data Box Edge
2424
In this article, you learn how to:
2525

2626
> [!div class="checklist"]
27+
>
2728
> * Add a share
2829
> * Delete a share
2930
> * Refresh shares
3031
> * Sync storage key
3132
32-
3333
## Add a share
3434

3535
Do the following steps in the Azure portal to create a share.
@@ -52,14 +52,14 @@ Do the following steps in the Azure portal to create a share.
5252
> Make sure that the Azure Storage account that you use does not have immutability policies set on it if you are using it with a Azure Stack Edge or Data Box Gateway device. For more information, see [Set and manage immutability policies for blob storage](https://docs.microsoft.com/azure/storage/blobs/storage-blob-immutability-policies-manage).
5353
5454
6. This step depends on whether you are creating an SMB or an NFS share.
55-
- **If creating an SMB share** - In the **All privilege local user** field, choose from **Create new** or **Use existing**. If creating a new local user, provide the **username**, **password**, and then confirm password. This assigns the permissions to the local user. After you have assigned the permissions here, you can then use File Explorer to modify these permissions.
55+
- **If creating an SMB share** - In the **All privilege local user** field, choose from **Create new** or **Use existing**. If creating a new local user, provide the **username**, **password**, and then confirm password. This assigns the permissions to the local user. After you have assigned the permissions here, you can then use File Explorer to modify these permissions.
5656

57-
![Add SMB share](media/data-box-edge-manage-shares/add-smb-share.png)
57+
![Add SMB share](media/data-box-edge-manage-shares/add-smb-share.png)
5858

5959
If you check allow only read operations for this share data, you can specify read-only users.
60-
- **If creating an NFS share** - You need to supply the **IP addresses of the allowed clients** that can access the share.
60+
- **If creating an NFS share** - You need to supply the **IP addresses of the allowed clients** that can access the share.
6161

62-
![Add NFS share](media/data-box-edge-manage-shares/add-nfs-share.png)
62+
![Add NFS share](media/data-box-edge-manage-shares/add-nfs-share.png)
6363

6464
7. To easily access the shares from Edge compute modules, use the local mount point. Select **Use the share with Edge compute** so that the share is automatically mounted after it is created. When this option is selected, the Edge module can also use the compute with the local mount point.
6565

@@ -69,7 +69,7 @@ Do the following steps in the Azure portal to create a share.
6969

7070
1. In the Azure portal, go to your Data Box Edge resource and then go to **Gateway > Shares**. Select **+ Add share** on the command bar.
7171

72-
![Select add share](media/data-box-edge-manage-shares/add-local-share-1.png)
72+
![Select add share](media/data-box-edge-manage-shares/add-local-share-1.png)
7373

7474
2. In **Add Share**, specify the share settings. Provide a unique name for your share.
7575

@@ -85,111 +85,109 @@ Do the following steps in the Azure portal to create a share.
8585

8686
7. Select **Create**.
8787

88-
![Create local share](media/data-box-edge-manage-shares/add-local-share-2.png)
88+
![Create local share](media/data-box-edge-manage-shares/add-local-share-2.png)
8989

9090
You see a notification that the share creation is in progress. After the share is created with the specified settings, the **Shares** blade updates to reflect the new share.
9191

92-
![View updates Shares blade](media/data-box-edge-manage-shares/add-local-share-3.png)
92+
![View updates Shares blade](media/data-box-edge-manage-shares/add-local-share-3.png)
9393

9494
Select the share to view the local mountpoint for the Edge compute modules for this share.
9595

96-
![View local share details](media/data-box-edge-manage-shares/add-local-share-4.png)
96+
![View local share details](media/data-box-edge-manage-shares/add-local-share-4.png)
9797

9898
## Mount a share
9999

100100
If you created a share before you configured compute on your Data Box Edge device, you will need to mount the share. Take the following steps to mount a share.
101101

102-
103102
1. In the Azure portal, go to your Data Box Edge resource and then go to **Gateway > Shares**. From the list of the shares, select the share you want to mount. The **Used for compute** column will show the status as **Disabled** for the selected share.
104103

105-
![Select share](media/data-box-edge-manage-shares/select-share-mount.png)
104+
![Select share](media/data-box-edge-manage-shares/select-share-mount.png)
106105

107106
2. Select **Mount**.
108107

109-
![Select mount](media/data-box-edge-manage-shares/select-mount.png)
108+
![Select mount](media/data-box-edge-manage-shares/select-mount.png)
110109

111110
3. When prompted for confirmation, select **Yes**. This will mount the share.
112111

113-
![Confirm mount](media/data-box-edge-manage-shares/confirm-mount.png)
112+
![Confirm mount](media/data-box-edge-manage-shares/confirm-mount.png)
114113

115114
4. After the share is mounted, go to the list of shares. You'll see that the **Used for compute** column shows the share status as **Enabled**.
116115

117-
![Share mounted](media/data-box-edge-manage-shares/share-mounted.png)
116+
![Share mounted](media/data-box-edge-manage-shares/share-mounted.png)
118117

119118
5. Select the share again to view the local mountpoint for the share. Edge compute module uses this local mountpoint for the share.
120119

121-
![Local mountpoint for the share](media/data-box-edge-manage-shares/share-mountpoint.png)
120+
![Local mountpoint for the share](media/data-box-edge-manage-shares/share-mountpoint.png)
122121

123122
## Unmount a share
124123

125124
Do the following steps in the Azure portal to unmount a share.
126125

127126
1. In the Azure portal, go to your Data Box Edge resource and then go to **Gateway > Shares**.
128127

129-
![Select share](media/data-box-edge-manage-shares/select-share-unmount.png)
128+
![Select share](media/data-box-edge-manage-shares/select-share-unmount.png)
130129

131130
2. From the list of the shares, select the share that you want to unmount. You want to make sure that the share you unmount is not used by any modules. If the share is used by a module, then you will see issues with the corresponding module. Select **Unmount**.
132131

133-
![Select unmount](media/data-box-edge-manage-shares/select-unmount.png)
132+
![Select unmount](media/data-box-edge-manage-shares/select-unmount.png)
134133

135134
3. When prompted for confirmation, select **Yes**. This will unmount the share.
136135

137-
![Confirm unmount](media/data-box-edge-manage-shares/confirm-unmount.png)
136+
![Confirm unmount](media/data-box-edge-manage-shares/confirm-unmount.png)
138137

139138
4. After the share is unmounted, go to the list of shares. You'll see that **Used for compute** column shows the share status as **Disabled**.
140139

141-
![Share unmounted](media/data-box-edge-manage-shares/share-unmounted.png)
140+
![Share unmounted](media/data-box-edge-manage-shares/share-unmounted.png)
142141

143142
## Delete a share
144143

145144
Do the following steps in the Azure portal to delete a share.
146145

147146
1. From the list of shares, select and click the share that you want to delete.
148147

149-
![Select share](media/data-box-edge-manage-shares/delete-share-1.png)
148+
![Select share](media/data-box-edge-manage-shares/delete-share-1.png)
150149

151150
2. Click **Delete**.
152151

153-
![Click delete](media/data-box-edge-manage-shares/delete-share-2.png)
152+
![Click delete](media/data-box-edge-manage-shares/delete-share-2.png)
154153

155154
3. When prompted for confirmation, click **Yes**.
156155

157-
![Confirm delete](media/data-box-edge-manage-shares/delete-share-3.png)
156+
![Confirm delete](media/data-box-edge-manage-shares/delete-share-3.png)
158157

159158
The list of shares updates to reflect the deletion.
160159

161-
162160
## Refresh shares
163161

164162
The refresh feature allows you to refresh the contents of a share. When you refresh a share, a search is initiated to find all the Azure objects including blobs and files that were added to the cloud since the last refresh. These additional files are then downloaded to refresh the contents of the share on the device.
165163

166164
> [!IMPORTANT]
165+
>
167166
> - You can't refresh local shares.
168167
> - Permissions and access control lists (ACLs) are not preserved across a refresh operation.
169168
170169
Do the following steps in the Azure portal to refresh a share.
171170

172-
1. In the Azure portal, go to **Shares**. Select and click the share that you want to refresh.
171+
1. In the Azure portal, go to **Shares**. Select and click the share that you want to refresh.
173172

174-
![Select share](media/data-box-edge-manage-shares/refresh-share-1.png)
173+
![Select share](media/data-box-edge-manage-shares/refresh-share-1.png)
175174

176-
2. Click **Refresh**.
175+
2. Click **Refresh**.
177176

178-
![Click refresh](media/data-box-edge-manage-shares/refresh-share-2.png)
177+
![Click refresh](media/data-box-edge-manage-shares/refresh-share-2.png)
179178

180-
3. When prompted for confirmation, click **Yes**. A job starts to refresh the contents of the on-premises share.
179+
3. When prompted for confirmation, click **Yes**. A job starts to refresh the contents of the on-premises share.
181180

182-
![Confirm refresh](media/data-box-edge-manage-shares/refresh-share-3.png)
183-
184-
4. While the refresh is in progress, the refresh option is grayed out in the context menu. Click the job notification to view the refresh job status.
181+
![Confirm refresh](media/data-box-edge-manage-shares/refresh-share-3.png)
185182

186-
5. The time to refresh depends on the number of files in the Azure container as well as the files on the device. Once the refresh has successfully completed, the share timestamp is updated. Even if the refresh has partial failures, the operation is considered successful and the timestamp is updated. The refresh error logs are also updated.
183+
4. While the refresh is in progress, the refresh option is grayed out in the context menu. Click the job notification to view the refresh job status.
187184

188-
![Updated timestamp](media/data-box-edge-manage-shares/refresh-share-4.png)
185+
5. The time to refresh depends on the number of files in the Azure container as well as the files on the device. Once the refresh has successfully completed, the share timestamp is updated. Even if the refresh has partial failures, the operation is considered successful and the timestamp is updated. The refresh error logs are also updated.
186+
187+
![Updated timestamp](media/data-box-edge-manage-shares/refresh-share-4.png)
189188

190189
If there is a failure, an alert is raised. The alert details the cause and the recommendation to fix the issue. The alert also links to a file that has the complete summary of the failures including the files that failed to update or delete.
191190

192-
193191
## Sync storage keys
194192

195193
If your storage account keys have been rotated, then you need to sync the storage access keys. The sync helps the device get the latest keys for your storage account.
@@ -209,7 +207,6 @@ Do the following steps in the Azure portal to sync your storage access key.
209207
>[!NOTE]
210208
> You only have to do this once for a given storage account. You don't need to repeat this action for all the shares associated with the same storage account.
211209
212-
213210
## Next steps
214211

215212
- Learn how to [Manage users via Azure portal](data-box-edge-manage-users.md).

0 commit comments

Comments
 (0)