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_adduser utility enables you to add a new user to the system, and assign a user to a new group.


Use the BMC Discovery user interface to perform the functionality provided by the tw_adduser command line utility (see Enabling other users). If you choose to run the utility, read the documentation in this section to learn its usage and to understand the risks and potential impact on your environment.

To use the utility, type the following command at the $TIDEWAY/bin/ directory:

tw_adduser [options] username


  • username is the name of the new user.
    If you do not specify a user name, BMC Discovery will use the default, system.
  • 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



(Optional) Specifies the full name of the user


(Optional) Specifies additional groups to add a user to (the default value is public). The value public is also the default when you select the Groups option from the Add User page on the Administration tab.

--no-force-password-changeSpecifies that the user does not have to change their password at their first login, though this is not recommended.

User example

In the following example, you can add a new admin user to a multiple groups by using the utility, the -g option, and a comma-separated list.

Adding a new user to multiple groups

$TIDEWAY/bin/tw_adduser -g discovery,admin newuser 
Was this page helpful? Yes No Submitting... Thank you