Troubleshoot mounting failures - Cloud Storage Gateway - Alibaba Cloud Documentation Center

When a share fails to be mounted, you can use an automatic inspection script or follow a set of systematic manual troubleshooting steps to pinpoint the problem. This topic describes how to troubleshoot share mount failures.

Use the automatic inspection script to troubleshoot an SMB share mount failure

Important

There may be various reasons for failing to mount an SMB share on Windows. The automatic inspection script can diagnose some of these causes. If the failure remains unresolved after using the script, please submit a ticket to contact us.

You can follow these steps to identify the issue using the automatic inspection script:

Log on to the Windows Server where the SMB share mount operation failed.
Execute the following commands in PowerShell or PowerShell ISE to download and run the automatic inspection script. Follow the suggestions provided by the script.
1. Download the inspection script.
```
Invoke-WebRequest https://csg-tools.oss-cn-shanghai.aliyuncs.com/tool/windows_client/alicsg_smb_windows_inspection.ps1 -OutFile alicsg_smb_windows_inspection.ps1
```
2. Run the inspection script.
```
.\alicsg_smb_windows_inspection.ps1 -MountAddress \\<gateway_ip>\<share_name> -Locale zh-CN
```
  In the command, \\<gateway_ip>\<share_name> is the SMB share mount target. Replace the fileds with your actual information.

How can I fix a share mount failure on a cross-zone high-availability gateway?

Verify that the virtual IP address is configured correctly. Mounting will fail if you specify a public IP addresses or virtual IP address that conflicts with route table entries.
Conduct ping tests to ensure network connectivity to the virtual IP address of the gateway.
For a failure in mounting a Windows SMB share, check the configuration of Lanman Workstation and ensure that the Workstation service and TCP/IP NetBIOS Helper service are enabled.

How can I fix a failure in mounting an SMB share on Windows 2019?

Phenomenon

When I attempt to mount an SMB share on Windows 2019, an error shown in the following figure appears. 2025-03-04_16-17-47

Solution

On the local Windows client, press Win+R to open Run, enter gpedit.msc, and click OK.
In the left-side navigation pane of the Local Group Policy Editor dialog box, go to Computer Configuration > Administrative Templates > Network > Lanman Workstation.
On the Lanman Workstation page, in the Settings section, select Enable insecure guest logons.
In the Enable insecure guest logons dialog box, select Enabled, and click Apply.
Attempt to mount the SMB share again.
If the mount still fails, restart the Windows client to clear the cache and try once more.