Managing ETH groups

From ScientificComputing
Jump to: navigation, search

Introduction

Using ETH groups for user management is the recommended practice on our HPC clusters. An ETH group exported to LDAPS can be used to manage file permissions as well as user membership in a shareholder group. A common scenario is a group DEPT-ISG-GROUP that includes all members in the group's Leitzahl as well as semester students and visiting guests.

Managing ETH groups for use on the central HPC clusters

Our cluster can make use of LDAP groups defined via the ETH Identity and Access Management system. As an ISG you can define a group in the IAM admin tool (main screen→Group management) and export it to LDAPS (Owner & Presence → Target Systems: LDAPS).

Keep the following points in mind:

Type of group
The ETH group needs to be exported to LDAPS. For consistency it is recommended to export it to AD (Active Directory), too.
Do not change the group name
Avoid changing the name of any group or contact us if you plan to do so.
Use only the ETH-wide LDAPS subtree
An ETH-wide group defined by any ISG will be in the
ou=custom,ou=groups,ou=nethz,ou=id,ou=auth,o=ethz,c=ch
subtree of LDAPS. Groups specific to a department can not be used.

We can only use groups from the

ou=custom,ou=groups,ou=nethz,ou=id,ou=auth,o=ethz,c=ch

subtree in LDAPS. That is the only way that we can provide service to and use services from the whole of ETH yet guarantee there are no collisions among group names or ids. Please contact us if you have any questions regarding using the IAM and/or LDAPS groups with our HPC clusters.

Exporting an ETH group to LDAPS

ETH group management
Export ETH group to LDAPS

Adding a subgroup to an ETH group

An ETH group used for cluster access can include entire subgroups. This makes it easy to include, for example, an entire Leitzahl of a shareholder as well as individual guests to the top ETH group since changes to the subgroups are automatically reflected in the top group.

At the moment there is an issue if you add a Leitzahl (0xxxx or Txxxx) group as a subgroup. If you add a Leitzahl subgroup, you will need to contact the IAM team and request that the users from the Leitzahl subgroup are synchronized to the parent group.

Step-by-step instructions for an example of adding the ID-HPC-BETA subgroup to the ID-HPC-EULER top group are shown below. After this is done, ID-HPC-EULER includes everyone in ID-HPC-BETA.

1. Go to the IAM admin tool. From the main screen select “Group management” and then “Select group”:
Home screen → “Group management” → “Select group”
The group search page (“Select a Role”) will open.

2. Enter the name of the the top group and click the green “Search” button:
Enter the name of the the top group and click the green “Search” button.
The group information page (“Role - Summary”) for the top group will open if the group is found.

3. Edit the group by clicking on the pencil icon:
Click the pencil icon to edit the top group.
The group modification page (“Modify Role Data”) will show open.

4. Find the “Subgroup” text box in the “Group role references” section. It is the last box on the page. Click the “(click here to add value)” text line in the box. If the top group already includes several subgroups, then you will need to scroll to the bottom of this text box to find the “(click here to add value)” text line.
Click on the “(click here to add value)” line in the “Subgroup” box of the “Group role references” section.
The text line turns into two icons.

5. Click on the people icon:
Click on the people icon.
A page to select the subgroup (“Select a Privilege”) will show up.

6. Enter the name of the subgroup and click on the green “Search” button:
Enter the name of the subgroup and click on the “Search” icon.
If the group is found then it will be displayed in the table below.

7. Click on the name of the subgroup:
Clock on the name of the subgroup.
The top group's modification page will be shown again (see step 4). You will now see the name of the subgroup in the “Subgroup” text box on the bottom of the page. Click on the blue “Save” button:
Click on the blue “Save” button.