Managing Licensed Users¶

A license grants you a certain number of seats that you can fill with any users you choose. These seats can be filled and then later reassigned as your needs change.

There are three ways you can manage the users associated with your license:

Manually adding/removing users
Importing all users or groups of users
Automatically adding users new to Review Board or new to a group

We’ll cover each of these in detail.

To get started:

Go to the Power Pack configuration page.

This can be found in Administration UI -> Extensions -> Power Pack -> Configure page.
Click Manage users.

This will take you to the “Manage Users” page, with additional links for importing users and configuring automatic user licensing.

Adding/Removing Users¶

Users can be manually added to your license or removed from your license at any time. There is no cost to reassigning users to your license.

On the “Manage Users” page, you can see everyone who has access to Power Pack functionality, and when they were licensed.

To add users, type one or more usernames (separated by commas) and click Add Users.

To remove users, click the checkbox next to each user you want to remove and click Remove.

You can add or remove users on the command line using the license-powerpack-users and unlicense-powerpack-users management commands.

Note

If a user is marked as inactive or deleted from the database, they’ll automatically be removed from the license. There’s no need to remove the user from the license manually.

Importing Users¶

If you already have a lot of users on your install, you can add them to your license all at once:

On the “Manage Users” page, click Import users.
Choose what to import:
- All users will import all users on your server.
- From group will import users from a specific review group.
  
  This can be repeated for multiple groups.
Click Import Users to begin the import.

Users will be added up to the maximum amount allowed by your license.

Automatic User Licensing¶

If you don’t want to manage licensed users by hand, you can configure Power Pack to automatically add users for you:

On the “Manage Users” page, click Automatic user licensing.
Choose when to automatically add users:
- Disabled will prevent any automatic licensing from occurring.
- All new users will add users when they create an account on Review Board.
- Users who join groups will add users when they join one of the specified review groups.
Click Save to save the new settings.

Note that this will not add any existing users to the license. For that, you’ll need to import users separately.

You can configure auto-adding on the command line with the config-powerpack-license management command.