Loading...

End User Access > Command Center > Solutions and Use Cases > Use Commvault as an ObjectStore System > Access Commvault Storage Using NFS Protocol > NFS ObjectStore for CommCell Console and Command Line Interface > NFS ObjectStore Command Line Interface > update

Updating the NFS ObjectStore Share Properties

Name

update

Syntax

ConfigureObjectStore -o update -n <Object Store Name> [-c Allowed clients] [-a Access Permission (RW/RO)] [-V Versions enabled flag] [-S Squashing Type] [-u anonuid] [-g anongid] [-C Copy Precedence] [-A ACL enable flag <1|0>] [-D Retention: Minimum Days to retain Deleted Items] [-v Retention: Minimum versions to retain] [-d Retention: Minimum days to retain the older versions] [-F Backup filter] [-h]

Description

The update option updates the NFS ObjectStore properties.

Use this option when additional clients and users need access to the NFS ObjectStore or when you want to change the versions enabled flag.

The table lists the options that the software supports.

Option

Description

-n

The NFS ObjectStore name.

-c

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

Specify the clients that can access the point-in-time NFS ObjectStore over NFS protocol.

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

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

-a

The access permissions. The valid values are :

  • RW, read and write
  • RO, read-only

-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 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.
  • 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.

-h

Displays the help for this option.

-F

Specify the file extensions that must be excluded from the backup operations.

Example

  • The following commands update an NFS ObjectStore. In this example, the parameters are listed on the command line.

    ./ConfigureObjectStore -o update -n userTest -c 192.168.0.42,192.168.0.44
    ./ConfigureObjectStore -o update -n userTest1 -c 192.168.0.45,192.168.0.46 -V0

  • The following command is used to modify filters that must be excluded from the backup operations:

    ./ConfigureObjectStore -o update -n OraTest2 -F "txt,jpeg,bmp"

  • The following command is used to remove filters that were added earlier.

    ./ConfigureObjectStore -o update -n OraTest2 -F ""

    Before you remove the filters, you must delete the files with extensions that match with the filter criteria you set.

Last modified: 6/8/2020 3:16:54 PM