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

User example

In the following example, you can add a new adminstrative 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