This documentation supports the 20.08 version of BMC Discovery.

To view an earlier version of the product, select the version from the Product version menu.


The tw_upduser utility enables you to update properties of a specific user, such as the current state, permissions, and passwords. To use the utility, type the following command at the $TIDEWAY/bin/ directory:

tw_upduser [options] username


  • username is the name of the user to update
  • options are any of the options described in the following table and the common command line options described in Using command line utilities.

Command Line Option



Sets the user to an ACTIVE state


Sets the user to a BLOCKED state


Sets the user to a DISABLED state

-f, --fullname=ARG

Sets a full name of the user

-G, --groups=GROUP ,...

Sets the user's group membership


Sets the user to a LOCKED state


Specifies that the password must be changed


Specifies that the password is okay as currently stated


Specifies that the password should be changed

User example

In the following example, the tw_upduser utility sets the user Joe to a locked state to protect from unauthorized changes to that account.

Locking a user for security purposes

To lock a user, type the following command:

$TIDEWAY/bin/tw_upduser --locked Joe

The following confirmation is displayed:


To unlock the user, run the utility again with the --active option.

Was this page helpful? Yes No Submitting... Thank you