> Documentation > Solutions and Use Cases > Use Commvault as an ObjectStore System > Access Commvault Storage Using NFS and CIFS Protocols > NFS ObjectStore Command Line Interface

Creating an NFS ObjectStore Share

Name

create

Syntax

ConfigureObjectStore -o create -n <Object Store Name> -s <Storage Policy> -i <Index Server Client Name> [-t Object Store type] -m <Media Agent Client Name> -c <Allowed clients> [-V Versions enabled flag] [-S Squashing Type] [-u anonuid] [-g anongid] [-C Copy Precedence] [-A ACL enable flag <1|0>] [-h]

Description

The create option creates an NFS ObjectStore share.

Before you create the share, make sure that you have the following CommCell Console information:

  • The MediaAgent client name

  • The Index Server client name that is in the Index Servers client group in the CommCell Console

  • The storage policy name

After you create the NFS ObjectStore, send the mount path to the users so that they can access it.

The table lists the options that the software supports.

Option

Description

-n

The NFS ObjectStore share name.

-s

The storage policy name.

-t

The NFS ObjectStore type. This can be any string.

This option does not affect the NFS ObjectStore operation

-i

The Index Server client name that is in the Index Servers client group in the CommCell Console

-m

The Linux MediaAgent name.

-c

A comma separated list of IP Addresses or host names that can access the NFS ObjectStore share.

Specify the clients that can access the NFS ObjectStore share over NFS, SMB, or CIFS protocol.

The clients do not need to be configured in CommCell Console.

To make this share accessible to any client, use 0.0.0.0 for IPv4 and :: for IPv6 as the client IP address.

-V

The flag that specifies whether to enable versioning for this NFS ObjectStore

Valid values are:

-S

The squashing type to use for the share. The default is NO_ROOT_SQUASH.

Valid values are:

  • ROOT_SQUASH: Map the root user on the NFS client to an anonymous user/group that has limited privileges. This prevents a root client user from having total control of the NFS ObjectStore share.

  • ROOT_ID_SQUASH: Map the root user on the NFS client to an anonymous user/group that has limited privileges and map a non-root user that is part of the root user's group to an anonymous group ID so that the user is treated as a non-root user.

    A root user ID is 0. A root user group ID is 0. This squashing type performs the following operations:

    • Maps a user ID of 0 to an anonymous user ID.

    • Maps a group ID of 0 to an anonymous group ID.

    • Maps a group ID of 0 in an alternative group to an anonymous group ID.

      For example, if USER1 has the root user group (group ID 0), then the user is mapped to an anonymous group ID and is treated as USER1 (instead of having root privileges).

  • ALL_SQUASH: Map all the users on the NFS client to an anonymous user/group that has limited privileges.

    Note

    Windows clients that use the CIFS interface cannot create files or directories when you set the squashing type to ALL_SQUASH.

  • NO_ROOT_SQUASH: A root user account on the NFS client can access the share as a root user.

-u

If you use squashing, then the user ID is the user ID that the software uses for mapping. This value can be greater than 0.

-g

If you use squashing, then the group ID is the group ID that the software uses for mapping. This value can be greater than 0.

-C

Specify the copy precedence to use for the backup copy operation.

-h

Displays the help for this option.

Example

The following command creates a NFS ObjectStore share. In this example, the parameters are listed on the command line.

 
./ConfigureObjectStore -o create -n userTest -s object_store_storage_policy -i Index1_analyticsServer  -m object_store_mediaagent -c 192.164.42.42
 Create Object Store [userTest] succeeded
 mount=/userTest

Loading...