Managing Grouper Groups
CUIT will create a Grouper group for a given application or resource, and then assign one or more designated individuals as administrators. The group administrators can then manage membership using the Grouper Web application. Members of groups are generally those who will be assigned access to the specific application or resource associated with the group.
Every Grouper group has a Group Name and a Group ID. The examples in this document use the Group Name “Science Fiction Movie Club” and the Group ID sciencefictionmovieclub.
- The Group Name is a short proper name for the group.
- We suggest that all Group IDs be four characters or more and reflect the purpose of the group.
- All Group IDs must begin with a letter or digit. They may contain letters, digits, dashes, and underscores, but they may not contain any spaces.
- For most groups (mailing list groups, LionMail groups/Google groups, etc.), we encourage people to suggest a Group ID that is all lower case but that is not a requirement. However for training groups, we always use mixed case (e.g. AlumniOffice).
- We cannot create a mailing list Group ID or a Google Group ID (LionMail Group ID) that matches an existing UNI, username, email alias or simple mailing list - we will let you know if there is a duplicate and will request another Group ID suggestion.
- For mailing list groups and LionMail Groups (Google Groups), the Group ID is the group’s email address, in this example the email address is email@example.com. Note that email addresses are case-insensitive, so using all lower case for the Group ID is simplest.
- Mailing list groups and LionMail groups (Google groups) may contain UNIs, external users, and other groups. All other groups may contain UNIs and other groups only.
- An external user is someone who has no UNI, e.g. firstname.lastname@example.org, or someone who prefers to use their non-Columbia email address, e.g. email@example.com. An external user is specified by entering the person's first name, last name, and email address, and can currently only be a member of the mailing list groups and LionMail groups (Google groups).
Navigate to the Group
Go to the Grouper User Interface.
There are several ways to select the group you want to update from the Grouper home page.
- If the desired group is included under "Recent activity" you can click on the Group Name (Science Fiction Movie Club).
- You can click "My groups" under the "Quick links" navigation bar to see all the groups you own, then click on the desired Group Name.
- Enter the Group Name (Science Fiction Movie Club) or the Group ID (sciencefictionmovieclub) in the Search field to find the desired group.
- Use the "Browse folders" navigation bar to find the desired group.
- Click the plus sign next to "Columbia University" to see the folders it contains.
- Click the plus sign next to "Applications" to see the folders it contains.
- Click the plus sign next to the desired folder (Access, Google, Mailing List) to see the folders and groups contained in that folder. Training and Wiki are folders inside the Access folder.
- Click the desired Group Name (Science Fiction Movie Club.
Examine Group Info
Click "More" to display detailed information about your group.
Group info includes the Group ID and other useful information.
Add Group Member (UNI)
To add a UNI as group member click the "Add Members" button in the upper right corner.
Type the UNI of the person you want to add. You will see a list of matching people in a drop-down menu. Click on the person in the drop-down menu.
Click the "Add" button to add this person to the group.
Add Group Member (Group)
To add another group as a member of the currently selected group, click the "Add Members" button in the upper right corner. Type the Group Name or the Group ID of the group you want to add. You will see a list of matching groups in a drop-down menu. Click on the desired group in the drop-down menu.
Click the "Add" button to add this group as a member of the group.
You can see that "Star Wars Movie Club" is now a member of "Science Fiction Movie Club" and the members of "Star Wars Movie Club" are displayed as indirect members of "Science Fiction Movie Club."
Add Group Member (External User)
(This section currently applies only to mailing list groups and LionMail groups/Google groups; external users cannot be added to other types of Grouper groups.)
To add an external user as a group member click the "More Actions" menu in the upper right corner, then click "Add external user" from the drop-down menu.
Enter the external user’s first name, last name, and email address, then click the "Update" button.
The external user will be displayed in the list of group members.
Remove Group Member
Click the "Actions" menu next to the member you want to remove, then click "Revoke membership" to remove that member from the group.
Add Group Administrator
To add a group administrator, you need to give someone the Admin group privilege. Click on the privileges tab to see current privileges for your group.
To add a new administrator:
- Click the "Add members" button in the upper right corner
- Type the UNI of the person you want to add
- Click the person's name in the drop-down menu
- Check the "Admin" checkbox (also check "Member" if this person should be a group member)
- Click the "Add" button.
The new administrator will be displayed in the Privileges tab.
Remove Group Administrator
Make sure you are in the Privileges tab of the desired group. Click the checkmark next to a person's name to remove that person's Admin privileges.
A composite group is a group that uses set arithmetic to determine group membership. It can be the intersection of two groups (include only people who are members of both groups) or the difference between two groups (the members of the first group minus the members of the second group). For example, a composite group can be used to make sure group members are automatically removed when they are no longer affiliated with a certain school or department. If you want the members of the "Science Fiction Movie Club" to include only Columbia University employees, the Email Team would create a regular group called "Science Fiction Movie Club Members" with Group ID sciencefictionmovieclub_members and then they would create a composite group called "Science Fiction Movie Club" which is defined as the intersection of "Columbia University Employees" and "Science Fiction Movie Club Members." Individual UNIs could be added to "Science Fiction Movie Club Members" by the list administrators and they would remain members of the group "Science Fiction Movie Club" as long as they remain Columbia University employees.
You don't need a composite group to implement the union operator. In that case you would simply add both groups as members of the desired group.