IN THIS ARTICLE
Outlines how to use the Shared Folders MMC snap-in to manage shares over SMB in Qumulo Core
- Cluster running Qumulo Core version 3.0.3 or above
- Windows 7 // Server 2008R2 or newer client
With Qumulo Core, you can use the Shared Folders Microsoft Management Console (MMC) snap-in to centrally manage file shares. Once connected, you can configure the Shared Folders snap-in via MMC enabling you to easily create file shares and set permissions on Windows.
Important! If the user is not an admin, they need to be in the Data Administrators role to successfully connect.
Configure Shared Folders via MMC
- Open the command prompt.
- Run the following command to connect:
net use \\mycluster.qumulo.com /user:admin
- Press Enter, and type the password when prompted.
- Navigate to the Start Menu and select Run.
- Type in mmc and press Enter to open the Microsoft Management Console (MMC).
- Navigate to the File menu in the MMC and select Add/Remove Snap-In....
- Select Shared Folders from the list of available snap-ins and click the Add button.
- Select Connect to another computer.
- Select Another computer and type in the cluster’s hostname (or IP) in the text box.
NOTE: There will be no error message for success or failure. If you have a trailing "/", it will fail (i.e., mycluster.company.com/ will fail vs. mycluster.company.com will succeed).
- Click the Finish button.
- Once the Shared Folders snap-in is added, click OK. You should now see the Shared Folders snap-in showing on the left side, with the cluster hostname in parenthesis.
- Expand the Shared Folders snap-in by either double-clicking it or single-clicking the turndown arrow.
- Click on the Shares list item to see the existing shares on the cluster. An example of what you should see on a new cluster is below:
Create a Share
- Go to the Action menu and select New Share.
- Type in the path or click on Browse and select the directory:
NOTE: The ‘q$’ share path starts at the root of the filesystem (aka. ‘/’).
- Click Next and fill in the share name. Note that it defaults to the name of the folder, but can be changed.
- Click Next and select the share permissions.
NOTE: Share permissions are separate from the traditional NTFS ACLs. The recommendation is to set the Share Folder Permissions to Full Control for everyone, then control access via the NTFS ACLs on the directory / files.
- Click OK, and then Finish to create the share.
Login to the cluster via the Web UI and select SMB Shares in the Sharing menu to verify that the share was successfully created.
Modify a Share
- Right-click on the share that you wish to modify and select Properties.
- Edit the Share name, Folder path, and Description using the General tab. Note that User limit and Offline Settings will have no impact on your Qumulo cluster and the C:\ drive represents the root of your Qumulo cluster.
- Click the Share Permissions tab to manage the permissions given to different users and groups. Note that you can add local users and groups from your Qumulo cluster by prefixing them with nameofyourcluster\ (qfsd in the example below).
NOTE: If Full Control is not selected, there is a minor mismatch between the rights granted by Windows’ Change Permissions and the Qumulo Web UI’s Write permissions. Change Permissions set through the MMC will appear as Write* in the Web UI. We recommend using Qumulo’s tools to set share permissions.
- Click the Security tab to manage the file permissions for the directory subtree under the share.
- Click Apply to save.
IMPORTANT! Applying changes here will encounter an error on the .snapshots metadir on a cluster with default settings. Selecting Continue each time this happens will allow the rest of the permissions to be updated.
Publish a Share in Active Directory
The Publish tab allows you to publish the share in Active Directory so that users can easily search for it.
- Right-click and select Properties on the share.
- Check Publish this share in Active Directory and optionally give it a Description, Owner, and Keywords.
- Click Apply.
Find a Published Share in Active Directory
- To search for a published share, click Search Active Directory from the Network tab in File Explorer.
- Select Shared Folders under Find, input the Name or Keywords, and click Find Now.
Close an Open SMB File (3.0.5 or above)
- Select Open Files to see a list of the files currently open on the cluster.
- Right click on the SMB file and select Close Open File.
- Click Yes to confirm.
TIP! To manage a large number of open files, use the QQ CLI or API instead of Shared Folders. Check out the Close an Open SMB File via QQ CLI article for more info.
Remove a Share
- Right-click on the share you wish to remove and select Stop Sharing.
You should now successfully be able to use the Shared Folders MMC snap-in to manage shares over SMB in Qumulo Core
Like what you see? Share this article with your network!