Add an NFS export using the ECS Portal

You can use the ECS Portal to create an NFS export and set the options that control access to the export.

Before you begin

  • This operation requires the Namespace Administrator or System Administrator role in ECS.
  • If you are a Namespace Administrator you can add NFS exports into your namespace.
  • If you are System Administrator you can add NFS exports into any namespace.
  • You must have created a bucket to provide the underlying storage for the export. For more information, see Create a bucket for NFS using the ECS Portal.

Procedure

  1. In the ECS Portal, select File > Exports > New Export.
    The New File Export page appears. The following example shows an export configured for access by NFS client hosts.
  2. On the New File Export page, in the Namespace field, select the namespace that owns the bucket that you want to export.
  3. In the Bucket field, select the bucket.
  4. In the Export Path field, specify the path.
    ECS automatically generates the export path based on the namespace and bucket. You only need to enter a name if you are exporting a directory that already exists within the bucket. So if you enter /namespace1/bucket1/dir1, for example, you should ensure that dir1 exists. If it does not, mounting the export will fail.
  5. Set the Show Bucket Quota option to No or Yes depending on how you want the export size to be reported.
    OptionDescription
    No The export size will be reported as the storage pool size.
    Yes The export size will be reported as the hard quota on the bucket, if set.
  6. To add the hosts that you want to be able to access the export, complete the following steps.
    1. In the Export Host Options area, click Add.
      The Add Export Host dialog appears.
    2. In the Add Export Host dialog, specify one or more hosts that you want to be able to access the export and configure the access options.
      You must choose an Authentication option. This is normally Sys unless you are intending to configure Kerberos. Default values for Permissions ( ro) and Write Transfer Policy ( async) are already set in the Add Export Host dialog and are passed to the NFS server. The remaining options are the same as the NFS server defaults and so are only passed by ECS if you change them.
      The following table describes the parameters that you can specify when you add a host.
      Setting Description
      Export Host Sets the IP address of the host or hosts that can access the export. Use a comma separated list to specify more than one host.
      Permissions Enables access to the export to be set as Read/Write or Read only. This is the same as setting rw or ro in /etc/exports.
      Write Transfer Policy Sets the write transfer policy as synchronous or asynchronous. The default is asynchronous.

      This parameter is the same as setting sync or async for an export in /etc/exports.

      Authentication Sets the authentication types supported by the export.
      Mounting Directories Inside Export Specifies whether subdirectories of the export path are allowed as mount points. This parameter is the same as the alldir setting in /etc/exports.

      With the alldir option, if you exported /namespace1/bucket1, for example, you can also mount subdirectories, such as/namespace1/bucket1/dir1, provided the directory exists.

      AnonUser An object user name (must have an entry in user/group mapping) to which all unknown (not specifically mapped via the user/group mapping) user IDs will be mapped when accessing the export..
      AnonGroup An object group name (must have an entry in user/group mapping) to which all unknown (not specifically mapped via the user/group mapping) group IDs will be mapped when accessing the export.
      RootSquash An object user name to which the root user ID (0) will be mapped when accessing the export.
    3. Click Add to finish defining the host options.
  7. If you want to add more hosts that can access the export, but with different options, repeat the previous step.
  8. Click Save to save the NFS export definition.

What to do next

Add a user or group mapping using the ECS Portal.