Skip to main content

Name and tag a node

A node starts with the name it was created with, often a machine's host name. Once you have more than a few, give each a name people recognize, tags for what it is good at (such as gpu or primary), and a note for whoever looks after it. The Machines list's search matches all three, so the right node is one search away.

Who can do this: the permission to edit nodes. Without it, the node's Properties tab says Read-only — editing needs the nodes:edit permission. and every field is locked.

  1. In the sidebar, select Directory, then the Machines tab.

  2. Select the node's name. Its details open beside the list.

  3. Select the Properties tab. The Identity group holds Name, Tags and Description.

    The Identity group of a node's Properties tab: Name, Tags, NodeVault, Identity key and Description

  4. In Name, type the new name. It must be unique in your organization, and it is shown wherever the node appears.

  5. In Tags, type words separated by commas, such as gpu, primary.

  6. In Description, write a note for people: what the node is for, who to ask about it.

  7. Select Save. Saved shows above the tabs.

  8. To check, go back to the list and type a tag in Search. The list narrows to the nodes whose name, tag or description contains it.

Org admins see a Host group under Identity on the same tab, with Jaah home and Auto-update: see Keep a node up to date. Which projects the node runs is set by node groups: see Run a project on some nodes only.

  • Read a node's status — whether a node is online, how loaded it is, and whether anything is wrong.
  • How nodes work — where a node comes from and how it takes tasks.
  • Machines — every column, filter and tab, including Properties.