NOTE: This feature is available starting with VAST Cluster 5.3.5.
For each SMB-enabled view, you can list all SMB open files and/or SMB byte-range locks for a certain directory and unlock the files as needed. The following actions are supported:
List all open files and directories under a certain path
Close selected files or folders (will close all open handles on files)
Unlock all SMB byte-range locks on selected files
List all open handles of a single chosen file or folder
Release selected open handles of a single chosen file or folder
To list open files, you run an open file query. You can create a new query or select one of queries that you've run previously.
Managing Open SMB Files in VAST Web UI
Run an Open File Query
To search for open files on an SMB view:
From the left navigation menu, select Element Store and then Views to open the Views page.
Right-click an SMB-enabled view and choose Open SMB Files -> SMB Locks & Open Handles to open the SMB Locks & Open Handles dialog.
Do either of the following:
If you want to create and run a new query, use the Define query pane:
In the File prefix field, enter the path to the directory to search for open files.
This field is prepopulated with a path to the current view's root directory. Append it with a relative path to the directory you want. If you omit the ending slash, it will be added automatically when processing the query.
Note that the search will not include subdirectories.
Select Return only files with byte-range-locks if you want the query to return only files that have SMB byte-range locks on them. If this checkbox is not selected, both open handles and byte-range locks are displayed.
Click Start query.
If you want to rerun one of prior queries, select the query you want in the Past queries pane and click Start query.
VAST Cluster runs the query and displays a list of open files. For each file, there is an indication whether it has SMB byte-range locks on it.
View All Open Handles for a File
To list all open handles for a file included in open file query results:
Right-click the file and choose List All Open Handles.
A list of open handles for the file is displayed, including the following information per handle:
Client IP | The IP address of the client. |
Share Access | SMB share permissions. |
Username | The name of the user for which the handle was created. |
Session ID | The ID of the session where the handle was created. |
Unique ID | The unique ID of the handle. |
Has Locks | Indicates whether the file has byte-range locks on it. |
Access mask | A list of SMB access masks. |
Lease | Indicates whether there is a lease on the file. |
Close Open Handles
To close all open handles and release all SMB byte-range locks for a file:
Run an open file query for the path where the file resides.
Right-click the file in the query results and choose Close All Handles and Locks.
To close one or more specific handles for a file included in open file query results:
Run an open file query for the path where the file resides.
Right-click the file in the query results and choose List All Open Handles to view a list of open handles for the file.
Select one or more handles you want to close. Up to five handles can be selected.
Right-click the selection and choose the option to close handles.
Click Yes in the confirmation prompt.
Release Byte-Range Locks for a File
To release byte-range locks for a file:
Run an open file query for the path where the file resides.
Right-click the file in the query results and choose Release Byte-Range Locks.