2. How to... : Manage GitCentric Groups
   
Manage GitCentric Groups
GitCentric groups are derived from Gerrit Code Review groups. See the Gerrit Code Review documentation for details about how groups are implemented. The following section describes how to administer groups in the GitCentric context.
To View and Access Groups
Groups can be viewed, defined, and modified by clicking People from the GitCentric Administration menu:
Add a Group
To add a group to GitCentric:
1. Click the Administration button, then click the People menu to display the Groups page. (See Chapter 5 Administration for reference information.)
2. Enter a name in the Create New Group field on the Groups panel.
3. Click Create Group.
Add a Member to a Group
Note: Any member you wish to add to a group must exist in the AccuRev Server with which GitCentric was configured during installation. You cannot use this procedure to create members.
To add a user to a GitCentric group:
1. Click the Administration button, then click the People menu to display the Groups page. (See Chapter 5 Administration for reference information.)
2. Click the group to which you wish to add a member from the Group Name column.
The page is refreshed to show general content.
3. Click the Members menu.
4. Click the Add button for the members table.
A new panel appears to allow you to specify the user by name or email:
5. Start to enter a value in the Name or Email field. GitCentric provides type-ahead choice of valid users.
6. Select the user you wish to add and click Save.
AccuRev Groups
AccuRev groups are a special case handled by GitCentric.
If your account is a member of a group in AccuRev, that group will be created in GitCentric as soon as you log in, and the group will be named with the format: Accurev.<accurevGroupName>
Note that AccuRev group hierarchies are not replicated in Git Centric: if you belong to “Group1” and also to a subgroup of Group1 named “Group2:, GitCentric creates two peer-level groups: Accurev.Group1 and AccuRev.Group2.
If you have upgraded to GitCentric from the Kando 2012.1 release, you probably have a kando_admin administrators group on your AccuRev server. If so, when GitCentric creates the Accurev.kando_admin group, it automatically grants this group "Administer Server" permission. You can check this using the Global-Capabilities section on the Repositories page. (Click the Administration button, then click Repositories. On the Repositories, page, click the All-Projects repository and the Access menu.)
Note: If you have multiple AccuRev servers, groups with the same name from all AccuRev servers are combined in GitCentric.
AccuRev groups created in GitCentric are read-only in the UI: you can see the properties and current members, but you cannot modify them.
Membership in an AccuRev group in GitCentric is only updated upon login. If you change a user's group membership in AccuRev, it will not change for the GitCentric user until that user logs out (either explicitly, or due to a session time-out) from Git Centric and then logs back in.