Articles in this section

Creating Views

Sara Levy
  • Updated
Follow

Each view is attached to a view policy which governs some of the configuration of the view. A view policy can be reused.

If there is no view policy with the configuration that you need for a particular view, you need to create a suitable view policy first. See Creating View Policies for instructions.

Creating a View via the VAST Web UI

  1. In the VAST Web UI, select Element Store from the left navigation menu and then select Views.

  2. Click Create View to add a new view.

    The Add View dialog appears.

  3. In the Path field, enter the full path from the top level of the storage system on the cluster to the location that you want to expose.

    The directory may exist already, such as if it was created by a client inside a mounted parent directory. It could also be a path to a new directory which you'll create now. (see step 9)

  4. Open the Protocols dropdown, select which protocols you want the view to be accessible from. You can select any combination with the exception that S3 Endpoint can only be selected alone. The options are:

    • NFS. Select this to expose the view as an NFS export to clients using NFS version 3.

    • NFS4. Select this to expose the view as an NFS export to clients using NFS version 4.1.

    • SMB. Select this to expose the view as an SMB share to SMB clients.

    • S3 Bucket. Select this to expose the view as an S3 bucket.

    • S3 Endpoint. This option creates a template for creating buckets via S3 APIs. Whenever a bucket is created using this endpoint, a new view is created under the specified path. See Managing Bucket Creation via S3 API for more information about S3 Endpoint buckets.

      You can enable NFS and/or NFS4 together with S3 Endpoint. In this case, the view path is exported for NFS access while multiple S3 buckets may also be created under the view path.

  5. If you enabled SMB in the Protocols dropdown, then enter a name for the SMB share in the SMB Share Name field.

    This is required for SMB.

    The name cannot include the following characters: /\:|<>*?"

  6. If you enabled NFSin the Protocols dropdown, you can optionally specify an alias for the mount path of the NFS export. An alias must begin with a forward slash ("/") and must consist of only ASCII characters. Enter the alias in the NFS Alias field.

  7. If you enabled S3 Bucket in the Protocols dropdown, enter a name for the bucket in the S3 Bucket Name field.

    S3 Bucket name is required for S3 buckets.

  8. From the Policy Name dropdown, select the view policy that has the configuration you want to use for the view.

  9. If the directory does not already exist in the file system, enable the Create Directory setting to create the directory.

  10. If you selected S3 Bucket or S3 Endpoint in the Protocols dropdown, select the S3 tab and set the relevant settings:

    • For S3 Bucket:

      • S3 Bucket Owner. Specify a user to be the bucket owner.

        S3 Bucket owner is required for S3 buckets.

      • S3 Versioning. Enable this setting if you want to enable object versioning on the bucket. (Versioning cannot be disabled later.)

      • Anonymous Access. Enable this setting to allow anonymous S3 access to the bucket. If enabled, anonymous requests are granted provided that the object ACL grants access to the All Users group (in S3 Native security flavor) or the permission mode bits on the requested file and directory path grant access permission to "others" (in NFS security flavor).

    • For S3 Endpoint:

      • Bucket Creators (Users). List users here by user name. Any request to create an S3 bucket that is sent by S3 API by a user listed here will use the S3 Endpoint view that you are configuring.

        Note

        Users should not be specified as bucket creators in more than one S3 Endpoint view.

        Naming a user as a bucket creator in two S3 Endpoint views will fail the creation of the view with an error.

      • Bucket Creators (Groups). List groups here by group name. Any request to create an S3 bucket that is sent by S3 API by a user who belongs to a group listed here will use the S3 Endpoint view that you are configuring.

        Caution

        Take extra care not to duplicate bucket creators through groups: If you specify a group as a bucket creator group in one view and you also specify a user who belongs to that group as a bucket creator user in another view, view creation will not fail. Yet, there is a conflict between the two configurations and the selection of a view for configuring the user's buckets is not predictable.

      • Anonymous Access. Enable this setting to allow anonymous S3 access to the bucket. If enabled, anonymous requests are granted provided that the object ACL grants access to the All Users group (in S3 Native security flavor) or the permission mode bits on the requested file and directory path grant access permission to "others" (in NFS security flavor).

  11. Click Create.

    The view is now created and can be accessed via all the protocols you enabled. You can see it displayed in the Views tab.

Creating a View via the VAST CLI

Use the view create command to create the view.

Related articles

Comments

0 comments

Article is closed for comments.