Managing Grouper Groups

CUIT uses Grouper groups to control group access to applications and resources. Some examples include:

  • Mailing lists
  • LionMail groups (Google groups)
  • Wiki groups
  • StridePoint training groups
  • ...and more

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 groupsLionMail 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 sciencefictionmovieclub@columbia.edu. 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. sam.spade@google.com, or someone who prefers to use their non-Columbia email address, e.g. abc1234@barnard.edu. 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.

Grouper index page screenshot
  1. If the desired group is included under "Recent activity" you can click on the Group Name (Science Fiction Movie Club).
  2. 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.
  3. Enter the Group Name (Science Fiction Movie Club) or the Group ID (sciencefictionmovieclub) in the Search field to find the desired group.
  4. 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.
select mailing list screenshot

Examine Group Info

Click "More" to display detailed information about your group.

detailed mailing list screenshot

Group info includes the Group ID and other useful information.

Group info includes the Group ID and other useful information screenshot.

Add Group Member (UNI)

To add a UNI as group member click the "Add Members" button in the upper right corner.

To add a UNI as group member click the "Add Members" button in the upper right corner screenshot.

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.

screenshot about the place where you type the UNI of the person you want to add.

Click the "Add" button to add this person to the group.

Click the "Add" button to add this person to the group screenshot.

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.

add group member screenshot.

Click the "Add" button to add this group as a member of the group.

screenshot about how to 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."

screenshot about what the results after you saved.

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.

screenshot about how to add external group member.

Enter the external user’s first name, last name, and email address, then click the "Update" button.

screenshot about how to add external user.

The external user will be displayed in the list of group members.

List of external users showed in screenshot.

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.

how to remove group member screenshot

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.

how to add group administrator screenshot.

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.

screenshot about how to add a new administrator.

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.

how to remove a group administrator

Composite Groups

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.