Articles in this section

See more

user add

Sara Levy
Follow

This command manually adds a user to the user database. Typical uses:

  • Enabling users to access the cluster via S3. Client users cannot access the cluster via s3 until you administrate their permission via one of the VMS user interfaces.

  • Enabling special S3 user permissions to create and delete buckets. These are administrated per user only via the VMS user interfaces.

  • Creating a local user entry for a user who does not exist in the auth provider or modifying an existing user entry to be 'local'. This enables you to allow a user access to resources via NFS on an exceptional basis. You define the user as a 'local' user and provide NFS user and group attributes. The user can then be authorized to access resources via NFS without being updated from the auth provider.

NFS Usage

Adds a user to the cluster UDB.

user add --name NAME
         --uid UID
        [--leading-gid LEADING_GID]
        [--gids GIDS]
        [--local]
        [--allow-create-bucket]
        [--allow-delete-bucket]

S3 Usage

Add a previously unknown user to the cluster UDB and optionally gives the user special permission to create and/or delete S3 buckets. The user will also need a key pair to be able to access the cluster. use user generate-key The user

Note

The user will not be able to create or access any buckets without an access key pair. To generate an access key pair, run user generate-key. To enable a key pair, run user modify-key.

user add --name NAME
         --uid UID
        [--allow-create-bucket]
        [--allow-delete-bucket]

Required Parameters

--name NAME

Sets the user's name.

--uid UID

Specifies the user's UID. Every user entry in the UDB has a unique UID.

Specify a unique UID that is not already in use in the UDB. UID is an NFS user attribute that identifies each user.

General Options

--leading-gid LEADING_GID

The GID (group ID) to assign as the owning group of any files created by the user.

For example: --leading-gid 44

--gids GIDS

Specifies GIDs (Group IDs) of groups to which the user belongs.

Enter the GIDs as a comma separated list.

For example: --gids 5,65,102,170

--local

Defines the user as local. Local users are not renewed from an auth provider (LDAP, NIS).

S3 Access Options

--allow-create-bucket

Allows the user to create buckets when connecting to the cluster via S3.

--allow-delete-bucket

Allows the user to delete buckets when connecting to the cluster via S3.

Example

This example adds a new user to the UDB with manually provided gids and configures the user as a local.

vcli: admin> user add --name bjohnson --uid 98 --leading-gid 44 --gids 5,65,102,170 --local

This example adds a new user and gives the user permission to create and delete S3 buckets.

vcli: admin> user add --name bjohnson --uid 700 --allow-create-bucket --allow-delete-bucket

Related articles

Comments

0 comments

Please sign in to leave a comment.