Access Keys:
Skip to content (Access Key - 0)

Grid Grouper


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:

  1. Launch the GAARDS UI.
  2. Logon to the Grid using your user account.
  3. From the Group Management menu select Group Browser, this will open the Group Browser Window.
  4. Click the Add Grid Grouper button, this will bring the Add Grid Grouper Window.
  5. From the Grid Grouper drop down select the Grid Grouper you wish to communicate with.
  6. From the Credentials drop down select the credential you wish to use.
  7. Click the Add button, this will load the Grid Grouper you specified into the Group Browser window.
  8. Select the stem you want to administer and click the View button.

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:

  1. Launch the GAARDS UI.
  2. Logon to the Grid using your user account.
  3. From the Group Management menu select Group Browser, this will open the Group Browser Window.
  4. Click the Add Grid Grouper button, this will bring the Add Grid Grouper Window.
  5. From the Grid Grouper drop down select the Grid Grouper you wish to communicate with.
  6. From the Credentials drop down select the credential you wish to use.
  7. Click the Add button, this will load the Grid Grouper you specified into the Group Browser window.
  8. Select the stem you want to administer and click the View button.
  9. Click the Privileges tab.
  10. Click the Search button.

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:

  1. Launch the GAARDS UI.
  2. Logon to the Grid using your user account.
  3. From the Group Management menu select Group Browser, this will open the Group Browser Window.
  4. Click the Add Grid Grouper button, this will bring the Add Grid Grouper Window.
  5. From the Grid Grouper drop down select the Grid Grouper you wish to communicate with.
  6. From the Credentials drop down select the credential you wish to use.
  7. Click the Add button, this will load the Grid Grouper you specified into the Group Browser window.
  8. Select the stem you want to administer and click the View button.
  9. Click the Child Stems tab, the child stems will be listed in the table on the Child Stems tab.

Viewing Stems

You 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 Stem

A 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 Stem

A 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:

  1. Launch the GAARDS UI.
  2. Logon to the Grid using your user account.
  3. From the Group Management menu select Group Browser, this will open the Group Browser Window.
  4. Click the Add Grid Grouper button, this will bring the Add Grid Grouper Window.
  5. From the Grid Grouper drop down select the Grid Grouper you wish to communicate with.
  6. From the Credentials drop down select the credential you wish to use.
  7. Click the Add button, this will load the Grid Grouper you specified into the Group Browser window.
  8. Select the stem you want to administer and click the View button.
  9. Click the Groups tab, the groups for the stem will be listed in the table on the Groups tab.

Viewing Groups

You 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 Group

A 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 Group

User'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.

Last edited by
Stephen Langella (1185 days ago)
Adaptavist Theme Builder Powered by Atlassian Confluence