# Manage SMB using the GUI

Using the GUI, you can:

* [Configure the SMB cluster](#configure-the-smb-cluster)
* [Edit the SMB cluster](#edit-the-smb-cluster)
* [Join the SMB cluster in the Active Directory](#join-the-smb-cluster-in-the-active-directory)
* [Delete the SMB cluster](#delete-the-smb-cluster)
* [Display the SMB shares list](#display-the-smb-shares-list)
* [Add an SMB share](#add-an-smb-share)
* [Edit an SMB share](#undefined)
* [Remove an SMB share](#remove-an-smb-share)

{% hint style="info" %}
**Note:** Use ASCII format when configuring name fields, such as domain and shares.
{% endhint %}

## **Configure the SMB cluster** <a href="#configure-the-smb-cluster" id="configure-the-smb-cluster"></a>

Define the Weka system hosts that participate in the SMB cluste&#x72;**.**

**Procedure**

1. From the menu, select **Manage > Protocols**.
2. From the Protocols pane, select **SMB**.
3. On the Configuration tab, select **Configure**.

![SMB cluster configuration tab](https://661826007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuOB5D2WMRjXBnChPFTrk%2Fuploads%2FY2SZ9D3ohYVqcEs56tVI%2Fwmng_smb_configure_button.png?alt=media\&token=e0b1ae41-ddeb-4274-b040-23d6cb612b59)

4\. In the SMB Cluster Configuration dialog, set the following properties:

* **Name**: A NetBIOS name for the SMB cluster.
* **Domain**: The domain the SMB cluster joins.
* **Domain NetBIOS Name**: (Optional) The domain NetBIOS name.
* **Hosts**: List of 3-8 Weka system hosts to participate in the SMB cluster, based on the host IDs in Weka.
* **Encryption:** Select the in-transit encryption to use in the SMB cluster:\
  \- enabled: enables encryption negotiation but doesn't turn it on automatically for supported\
  &#x20;  sessions and share connections.\
  \- disabled: doesn't support encrypted connections.\
  \- desired: enables encryption negotiation and turns on data encryption on supported sessions\
  &#x20;  and share connections.\
  \- required: enforces data encryption on sessions and share connections. Clients that do not\
  &#x20;  support encryption will be denied access to the server.
* **IPs**: (Optional) List of public IPs (comma-separated) used as floating IPs for the SMB cluster to serve the SMB over and thereby provide HA (do not assign these IPs to any host on the network). For IP range, use the following format: **a.b.c.x-y**.

{% hint style="info" %}
In AWS installations, it is not possible to set a list of SMB service addresses. The SMB service must be accessed using the primary addresses of the cluster nodes.
{% endhint %}

5\. Select **Save**.

![SMB Cluster Configuration dialog](https://661826007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuOB5D2WMRjXBnChPFTrk%2Fuploads%2F2O6157sFPFzKCE5Ere0G%2Fwmng_smb_configure_dialog.gif?alt=media\&token=ba11360a-f65e-4643-8534-1c8851711ce5)

Once the system completes the configuration process, the host statuses change from not ready (red X icon) to ready (green V icon), as shown in the following example:

![SMB cluster configuration example](https://661826007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuOB5D2WMRjXBnChPFTrk%2Fuploads%2F07yzwQp9xK2Zuhxxveve%2Fwmng_smb_configure_result.png?alt=media\&token=212c44dd-25e5-46f2-8102-cb4c9124c4aa)

## Edit the SMB cluster <a href="#edit-the-smb-cluster" id="edit-the-smb-cluster"></a>

You can modify the encryption and IPs settings according to your needs.

**Procedure**

1. In the SMB Cluster Configuration, select the **pencil** icon.

<figure><img src="https://661826007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuOB5D2WMRjXBnChPFTrk%2Fuploads%2FleT6wosHJDePGmGG1ivH%2Fwmng_smb_cluster_edit.png?alt=media&#x26;token=618b3874-b12c-42ee-8101-3300465cb3c4" alt=""><figcaption><p>Edit the SMB cluster</p></figcaption></figure>

2\. In the Edit SMB Configuration dialog, update the encryption and IPs settings.

<figure><img src="https://661826007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuOB5D2WMRjXBnChPFTrk%2Fuploads%2Fh0MRG79wBendCkn2NdUj%2Fwmng_edit_smb_configuration.png?alt=media&#x26;token=a2fd3d95-3212-48a9-9c07-3309057a4d5e" alt=""><figcaption><p>Edit SMB configuration</p></figcaption></figure>

3\. Select **Save**.

## Join the SMB cluster in the Active Directory <a href="#join-the-smb-cluster-in-the-active-directory" id="join-the-smb-cluster-in-the-active-directory"></a>

To enable the organizational Active Directory to resolve the access of users and user groups to the SMB cluster, join the SMB cluster in the Active Directory (AD).

**Before you begin**

To enable the Weka storage nodes to join the AD domain, verify that the AD server is the DNS server.&#x20;

**Procedure**

1. In the SMB Cluster Configuration, select **Join**.

![Join the SMB cluster in the Active Directory](https://661826007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuOB5D2WMRjXBnChPFTrk%2Fuploads%2Fd3jWhQnYDs6mHfwBnHNQ%2Fwmng_smb_join_ad_button.png?alt=media\&token=ad42fbe0-c90f-4948-be8f-e61d1e512c0c)

2\. In the Join to Active Directory dialog, set the following properties:

* **Username** and **Password**: A username and password of an account that has access privileges to the Active Directory. Weka does not save the user password. A computer account is created on behalf of the user for the SMB cluster.
* **Server**: (Optional) Weka identifies the AD server automatically based on the AD name. You do not need to set the server name. In some cases, if required, specify the AD server.
* **Computers Org. Unit**: The default organization unit is the Computers directory. You can define any other directory to connect to in Active Directory, such as SMB servers or Corporate computers.

![Join Active Directory dialog](https://661826007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuOB5D2WMRjXBnChPFTrk%2Fuploads%2FNEWcWnHTKiCocWsIJJ9L%2Fwmng_smb_join_ad_dialog.png?alt=media\&token=cb7f0d09-4e14-4b44-9778-76b9cf4121a4)

Once the SMB cluster joins in the Active Directory, the join status next to the domain changes to **Joined**.

{% hint style="info" %}
To join a different Active Directory to the existing SMB cluster configuration, select **Leave**. To confirm the action, enter the username and password used to connect to the Active Directory.
{% endhint %}

## Delete the SMB cluster <a href="#delete-the-smb-cluster" id="delete-the-smb-cluster"></a>

Deleting the SMB cluster resets its configuration data.

**Procedure**

1. In the SMB Cluster Configuration, select the **trash** icon.

![Delete the SMB cluster configuration](https://661826007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuOB5D2WMRjXBnChPFTrk%2Fuploads%2FcpFBho8z6EdKE5hpnURZ%2Fwmng_smb_cluster_remove.png?alt=media\&token=f4e74c4b-1bb9-4dab-a54b-529a49734954)

2\. In the SMB Configuration Reset message, select **Reset**.

## **Display the SMB shares list** <a href="#display-the-smb-shares-list" id="display-the-smb-shares-list"></a>

The Shares tab displays the list of SMB shares that are already created in the system. You can also customize the table columns of the SMB shares list.

**Procedure**

1. From the menu, select **Manage > Protocols**.
2. From the Protocols pane, select **SMB**.
3. Select the **Shares** tab.\
   You can filter the list using any column in the table.

![SMB shares list](https://661826007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuOB5D2WMRjXBnChPFTrk%2Fuploads%2FhH86Zxnsey46ajarxoym%2Fwmng_smb_list_shares.png?alt=media\&token=74e68f5e-d6f6-4da3-b9c8-3ddd3c95f318)

## Add an SMB share <a href="#add-an-smb-share" id="add-an-smb-share"></a>

**Procedure**

1. In the Shares tab, select **+Create**.

![Create an SMB share](https://661826007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuOB5D2WMRjXBnChPFTrk%2Fuploads%2F0lItvwCj35e1n5AgQJex%2Fwmng_smb_share_create_button.png?alt=media\&token=0c2783ae-2492-4ca0-ad11-9ccb6a210273)

2\. In the Add SMB Share dialog, set the following properties:

* **Name**: A meaningful name for the SMB share.&#x20;
* **Filesystem**: The filesystem name that includes the directory to share. Select one from the list. A filesystem set with required authentication cannot be used for SMB share.
* **Description**: A description or purpose of the SMB share.&#x20;
* **Path**: A valid internal path, relative to the root, within the filesystem to expose for the SMB share.
* **Encryption:** Select in-transit encryption enforcement of the share. The cluster global encryption settings can affect the actual encryption.
* **Read Only:** Select if you want to set the share as read only.
* **Hidden:** Select if you want to hide the share, so it is not visible when viewing the list of system shares.
* **Allow Guest Access:** Select if you want to allow guests to access without authentication.
* **Access Permissions:** Define the share access permissions. If you select ON, select the access type, and the users or groups allowed to access the share (comma-separated users and groups list, add '@' as a group prefix).
* **Files/Directories POSIX Mode Mask**: Set the new default file and directory permissions in a numeric (octal) format created through the share.
* **ACLs Enabled**: Determines whether to enable the Windows Access-Control Lists (ACLs) on the share. Weka translates the ACLs to POSIX.

3\. Select **Save**.

![Add SMB Share dialog](https://661826007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuOB5D2WMRjXBnChPFTrk%2Fuploads%2FVNEJezhd9NuPaMh4EKmH%2Fwmng_smb_share_add_dialog.png?alt=media\&token=c33e5ee3-4e61-4690-bffd-2777665d9622)

## Edit an SMB share <a href="#edit-an-smb-share" id="edit-an-smb-share"></a>

You can update some of the SMB share settings. These include encryption, hiding the share, allowing guest access, and setting the share as read only or not.

**Procedure**

1. In the Shares tab, select the three dots of the share and select **Edit**.

<figure><img src="https://661826007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuOB5D2WMRjXBnChPFTrk%2Fuploads%2FDt11CwSwfnNH7wiEGhkl%2Fwmng_edit_smb_share_button.png?alt=media&#x26;token=2a7c78a7-e3b3-4623-b22d-a48e12068c7a" alt=""><figcaption></figcaption></figure>

2\. In the Update Share Settings dialog, update the relevant properties and select **Save**.

<figure><img src="https://661826007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuOB5D2WMRjXBnChPFTrk%2Fuploads%2F9HeyMnzY4EBdLOvocjpV%2Fwmng_update_share_settings.png?alt=media&#x26;token=68027f7e-b165-403f-8e33-034b256b8e19" alt=""><figcaption><p>Update the SMB share settings</p></figcaption></figure>

## Remove an SMB share <a href="#remove-an-smb-share" id="remove-an-smb-share"></a>

**Procedure**

1. In the Shares tab, select the three dots of the share and select **Remove**.

![Remove an SMB . share](https://661826007-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuOB5D2WMRjXBnChPFTrk%2Fuploads%2FRodXD9Dy6V5oUiOtti4Z%2Fwmng_smb_share_remove.png?alt=media\&token=7c27e704-6ce5-4ce0-9019-3c135374f930)

2\. In the confirmation message that appears, select **Confirm**.\
&#x20;   The removed share no longer appears in the SMB Shares list.