Managing Shares

Shares are created for Filesystem-type volumes in vStor. When creating a Filesystem volume, you’re prompted to establish a share.

Prerequisites

  • A filesystem-type volume must exist or be created.

  • Hosts should be network accessible.

Creating a new share using the vStor Web Interface

  1. Open the vStor Web Interface at https://<vStor_hostname_or_IP>:8900.

  2. Log in as admin.

  3. In the navigation menu, click Storage and locate a Filesystem volume.\

  4. Add a new share by doing one of the following:

    • Hover over the volume record, click More Actions ⋯ and select Share.

    • Click the volume name, select the Shares tab and click Add share.

    The Add Share dialog will appear.\

  5. Make all required selections:

    1. Type: Select share type: nfs or smb.

    2. Read-only toggle: if the toggle is on, DPX will not be able to use this volume share as a backup storage.

    3. Require Kerberos authentication toggle: if the toggle is on, Kerberos authentication will be required in order to access the share.

    4. Allowed hosts:

      1. Select All hosts (not recommended) to allow access from any machine with access to the same network.

      2. Select Add host (recommended) to allow only certain machines. Add more machines using the Add next host button.

  6. Click Add to add the share. A connection check will be performed on each host. An error will be thrown for each unreachable host. You cannot add a share with one or more unreachable hosts.

Note. An NFS and SMB share cannot exist for the same volume simultaneously.

After completing the steps, the share is established. Click Shares in the navigation pane and the share will appear in the Shares table.

Creating a new share using vStor CLI

  1. Show the list of defined volumes using:

vstor volume show

This command will return the following output:

ID | TYPE       | POOL | IS CLONE | TOTAL   | FREE    | USED     | NAME
-------------------------------------------------------------------------
1  | filesystem | 1    | No       | 96.39GB | 96.39GB | 421.00KB | v1
2  | filesystem | 1    | No       | 96.39GB | 96.39GB | 53.00KB  | v2
3  | lun        | 1    | No       | 64.00KB | 52.00KB | 12.00KB  | lun1 
5  | filesystem | 1    | No       | 96.39GB | 96.39GB | 24.00KB  | myvol1
  1. Create a share for a selected volume using:

vstor share create --vol_id=5 --share_type=nfs –-allowed_hosts all

Alternatively, use:

vstor share create --vol_id=5 --share_type=nfs –-allowed_hosts  <comma separated IP address list>

The output of this command is structured in the following way:

ID: 3
NAME: /vstor/vpool1/fs5
SHARE TYPE: nfs
VOLUME ID: 5
CREATED: 2018-01-26 21:23:46 UTC
UPDATED: 2018-01-26 21:23:46 UTC
SHARE OPTIONS: ALLOWED HOSTS: all

Note. --share_type nfs is the only share type supported by DPX.

Last updated