Stems
Grid Grouper: Administrators Guide | Developers Guide | caGrid: Documentation Guides
Overview
In Grouper/Grid Grouper groups are organized into namespaces or stems. Stems are organized in a tree hierarchy starting with the root stem, each stem can have a set of child stems and set of child groups with exception to the root stem which cannot have any child groups. Each stem has the following properties:
| Property |
Description |
|---|---|
| Stem Id |
Unique identifier assigned to the Stem by Grid Grouper. |
| Display Extension |
Display name of the stem. |
| System Extension | System name of the stem. |
| Display Name | Full display name of the stem within the context of the grouper tree hierarchy. |
| System Name | Full System name of the stem within the context of the grouper tree hierarchy. |
| Description | Description of the stem. |
When registering a stem each stem is given a System Extension and a Display Extension. The system extension provides a system name for the stem and the display extension defines how the stem will be presented to users. The System Name attribute is the full system name of the stem within the context of the grouper tree hierarchy and consists of the concatenation (delimited by a : ) of all of the stem's parents system extensions along with the stem's system extension. Similiar is true for the Display Name which is the full display name of the stem within the context of the grouper tree hierarchy. For example suppose a stem with the system extension of OSU and display extension of Ohio State University has a child stem with the system extension CS and the display extension Computer Science. Then the system name of the child stem would be OSU:CS and the display name of the child stem would be Ohio State University:Computer Science.
The Stem hierarchy in Grid Grouper is publicly visible to anyone accessing the service, however the ability to view a group within a stem publicly depends on the privileges for the group. In addition each stem has a set of privileges that can be granted to users for administrating the stem. Below is a table containing the pivileges that a user can be granted on a stem:
| Privilege |
Description |
|---|---|
| Stem |
Give users the right to create, modify, and remove child stems. |
| Create |
Gives the users the right to create, and remove child groups. |
In the remainder of this guide we will provide details on administrating stems with Grid Grouper, this include viewing stems, managing privileges, managing child stems (adding and removing), and managing child groups (adding and removing).
Viewing Stems
|
The GAARDS UI provides a mechanism for administrating stems, to administrate stems with the GAARDS UI complete the following steps:
|
On the right of the screen, a tab will open entitled with the stem's name. This tab contains four sub tabs: (1) Details, (2) Privileges, (3) Child Stems, (4) Groups. The Details tab contains information that identitifies the stem. The Privileges tab allows users with the Stem privilege to manage the privileges for the stem. The Child Stems tab allows users with the Stem privilege to manage child stems. The Groups tab allows users with the Create privilege to create and remove groups on the stem. In the remainder of this section we will discuss the Details tab, the Privileges, Child Stems, and Groups tabs will be discussed later in this guide.
The Details tab contains attributes that identitfy the stem, the table below lists and provides a description of each of the attributes:
| Attribute |
Description |
|---|---|
| Grid Grouper |
The URL of the Grid Grouper in which the stem is contained. |
| Stem Id |
Unique identifier assigned to the Stem by Grid Grouper. |
| Display Name |
Full display name of the stem within the context of the grouper tree hierarchy. |
| System Name |
Full System name of the stem within the context of the grouper tree hierarchy. |
| Display Extension | Display name of the stem. |
| System Extension | System name of the stem. |
| Created |
The date and time the stem was created. |
| Created By |
The identity of the user that created the stem. |
| Last Modified |
The date and time the stem was last modified. |
| Last Modified By |
The identity of the user that last modified the stem. |
| Description |
A description of the stem. |
Of the attributes listed in the above table, only the display extension and description may be updated. To update one of these attributes, make the desired modifications and click the Update button.
Managing Privileges
|
Users can be granted privileges on a stem managed by Grid Grouper such that they may administrate a stem, create a sub stem, or create a group on the stem. Users granted the Stem privilege on a stem may administrate the Stem or create child stems. Users granted the Create privileges on a stem may create groups on the stem. The GAARDS UI provides a mechanism for granting and revoking the privileges on stems. To view all the existing privileges on a stem, please complete the following steps:
This will list all the privileges granted on the stem in the table below the Search button. Privileges are organized in the table by user. To grant or revoke privileges to a user with existing privileges select the listing for that user in the table and click the View button. If you wish to grant privileges to a user that has not been granted privileges or is not listed in the table click the Add button. In either case the Stem Privilege Window will launch. If you are granting privileges to users without any existing privileges (clicked the Add button), you will need to specify the user's grid identity in the Identity text box. Under the Identity text box are the privileges that can be granted or revoked on the stem. To grant a privilege select the check box for that privilege. To revoke a privilege deselect the check box for that privilege. Once you have made the changes you desire, click the Update Privilege(s) or the Add Privilege(s). Once you have clicked the button the privileges your granted or revoked will immediately take effect. |
Managing Child Stems
|
Each stem in Grid Grouper can have a set of child stems, the GAARDS UI provides a means of listing, creating, and removing child stems. Since stems are publicly readable any user may view the stem hierarchy, however only user's with the Stem privilege may create and remove stems. To view the child stems for a given stem complete the following steps:
Viewing StemsYou can view the details of a given child stem by selecting the stem in the table and by clicking the View button. Create a Child StemA user with the Stem privilege may add a child stem to the stem. This can be done by entering a system extension for the new stem in the Local Name text box and a display extension for the new stem in the Local Display Name text box. Finally click the Add button to add the stem as a child to the current stem. Remove a Child StemA user with the Stem privilege may remove a stem by selecting the stem to remove in the table and by clicking the Remove button. In order to remove a stem, all child stems and groups associated with the stem must be removed prior to removing the stem. |
Managing Groups
|
Each stem in Grid Grouper can have a set of groups, the GAARDS UI provides a means of listing, creating, removing and managing groups. Whether or not a user can see a given group depends on whether or not the user has the View privilege on the group. By default, the View privilege is granted to all users, however this does not mean that the administrator of that group has not revoked this privilege. For more information on groups and group privileges check out the group administration guide. To view the groups for a given stem complete the following steps:
Viewing GroupsYou can view the details of a given group by selecting the group in the table and by clicking the View button. For more information on viewing groups check out the group administration guide. Create a GroupA user with the Create privilege may add group to the stem. This can be done by entering a system extension for the new group in the Local Name text box and a display extension for the new group in the Local Display Name text box. Finally click the Add button to create the group on the current stem. Remove a GroupUser's with the Admin privilege on a group may remove the group, for more information on privileges on groups check out the group administration guide. A group can be removed by selecting the group to remove in the table and by clicking the Remove button. |





