Chapter 9 User Management

Modules about Groups and user management


9.1 Create Terra Group

  1. Launch Terra and sign in with your Google account.

  2. In the drop-down menu on the left, navigate to “Groups”. Click the triple bar in the top left corner to access the menu. Click the arrow next to your name to expand the menu, then click “Groups”. You can also navigate there directly with this link: https://anvil.terra.bio/#groups

    Screenshot of the Terra drop-down menu.  Three items are highlighted: 1) the "hamburger" button for extending the drop-down menu, 2) the arrow next to your username, for extending the drop-down submenu, and 3) the submenu item "Groups".

  3. Click “+ Create a New Group”

    Screenshot of the Terra Group page. The "Create a New Group" button is highlighted.

  4. Enter a name for your group. Names must be unique, so it’s often helpful to include your team’s name, the purpose of the group, and optionally the timeframe, if you will have similar groups in the future.

    Screenshot of the Terra Group page with Create New Group pop out box. The textbox is highlighted and has been filled in with the Group name.

  5. Click “CREATE GROUP”

    Screenshot of the Terra Group page with Create New Group pop out box. The "CREATE GROUP" button is highlighted.

  6. Your new Group should now show up on the Group Management screen. Take note of the email address associated with your group. You will use this email to grant the group access to Billing Projects and Workspaces.

    Screenshot of the Terra Groups page.  The Group email address is highlighted.

9.2 Add Member to Terra Group

  1. Launch Terra and sign in with your Google account.

  2. In the drop-down menu on the left, navigate to “Groups”. Click the triple bar in the top left corner to access the menu. Click the arrow next to your name to expand the menu, then click “Groups”. You can also navigate there directly with this link: https://anvil.terra.bio/#groups

    Screenshot of the Terra drop-down menu.  Three items are highlighted: 1) the "hamburger" button for extending the drop-down menu, 2) the arrow next to your username, for extending the drop-down submenu, and 3) the submenu item "Groups".

  3. Find the name of the Group you want to add someone to, and confirm that you have Admin privileges for the Group (you can only add and remove members to a Group if you are an Admin). Click on the name of the Group to view and manage members.

    Screenshot of the Terra Groups page.  The Group Name and Role are highlighted.

  4. Click on “+ Add User”. You will be prompted to enter the user’s AnVIL ID.

    Screenshot of a Terra Group management page. The "+ Add User" button is highlighted.

  5. Type in the user’s email address. Make sure this is the account that they will be using to access AnVIL.

    Screenshot of the dialog box for adding Terra Group members. The textbox labeled "User email" is highlighted and an email address has been entered.

  6. If this member will need to add and remove other members of the Group, check the box for “Can manage members (admin)”. This will add them as an “Admin” for the Group. Otherwise leave it unchecked, and they will be added as a “Member”.

    • Admins and Members have equal access to any resources shared with the Group.
    • Admins can manage Group membership - they can add, remove, or change the role of other Group members.

    Screenshot of the dialog box for adding Terra Group members. The checkbox labeled "Can manage members (admin)" is highlighted.

  7. Click ADD USER. This will take you back to the Group administration page.

    Screenshot of the dialog box for adding Terra Group members. The button labeled "ADD USER" is highlighted.

  8. The new Group member will now be shown in the list of group members, along with their role. They should now have access to anything that the Group has been given access to.

    Screenshot of a Terra Group management page. The name and role of the new member is highlighted.

If you need to remove members or modify their roles, you can do so at any time by clicking the teardrop button next to their name.

Screenshot of a Terra Group management page. The teardrop button next to one of the members is highlighted.

9.3 Find Group Email

  1. Launch Terra and sign in with your Google account.

  2. In the drop-down menu on the left, navigate to “Groups”. Click the triple bar in the top left corner to access the menu. Click the arrow next to your name to expand the menu, then click “Groups”. You can also navigate there directly with this link: https://anvil.terra.bio/#groups

    Screenshot of the Terra drop-down menu.  Three items are highlighted: 1) the "hamburger" button for extending the drop-down menu, 2) the arrow next to your username, for extending the drop-down submenu, and 3) the submenu item "Groups".

  3. Find the name of the Group, then look in the “Group Email” column to find the email address associated with the Group. Copy this email address and paste it in as the username when adding people to Billing Projects and Workspaces. This will grant everyone in the Group access to the Billing Project or Workspace.

    Screenshot of the Terra Groups page.  A Group email address is highlighted.