User Manager Utility

The User Manager utility (imqusermgr) is used for populating or editing a flat-file user repository. The utility must be run on the same host where the broker is installed; if a broker-specific user repository does not yet exist, you must first start up the corresponding broker instance in order to create it. You will also need the appropriate permissions to write to the repository : on the Solaris or Linux platforms, this means you must be either the root user or the user who originally created the broker instance.

Table 16-15 lists the subcommands available with the imqusermgr command. In all cases, the -i option specifies the instance name of the broker to whose user repository the command applies; if not specified, the default name imqbroker is assumed.

Table 16-15 User Manager Subcommands

Syntax	Description
`add` [`-i` `instanceName`] `-u` `userName` `-p` `password` [`-g` `group`]	Add user and password to repository The optional `-g` option specifies a group to which to assign this user: `admin` `user` `anonymous`
`delete` [`-i` `instanceName`] `-u` `userName`	Delete user from repository
`update` [`-i` `instanceName`] `-u` `userName` `-p` `password` `update` [`-i` `instanceName`] `-u` `userName` `-a` `activeStatus` `update` [`-i` `instanceName`] `-u` `userName` `-p` `password` `-a` `activeStatus`	Set user’s password or active status (or both) The `-a` option takes a boolean value specifying whether to make the user active (`true`) or inactive (`false`). An inactive status means that the user entry remains in the user repository, but the user will not be authenticated, even if using the correct password. Default value: `true`.
`list` [`-i` `instanceName`] [`-u` `userName`]	Display user information If no user name is specified, all users in the repository are listed.

In addition, the options listed in Table 16-16 can be applied to any subcommand of the imqusermgr command.

Table 16-16 General User Manager Options

Option	Description
`-DbrokerProperty=value`	Specify a broker property value when starting `imqusermgr`.
`-f`	Perform action without user confirmation
`-s`	Silent mode (no output displayed)
`-v`	Display version information¹
`-h`	Display usage help¹

¹ Any other options specified on the command line are ignored.

Skip Navigation Links
Exit Print View
	Oracle GlassFish Server Message Queue 4.5 Administration Guide