Organisations

An organisation on a Nexus Telemetry Fleet server is a separate tenant, with its own terminals, its own users and its own certificate authority. Organisations form a tree: a reseller has customer organisations beneath it. Each organisation has a display name, which can be changed, and a short name, which is fixed and forms its web address, the address its users sign in at. The Organisations page is open to the Owner and Admin roles only. See Users and roles for the roles.

# Current organisation

Clicking the initials at the top right of the dashboard opens a panel with the signed-in user’s name, role and, under Organisation, the short name of their organisation.

# Organisations page

Organisations lists the signed-in user’s own organisation and every organisation beneath it. Each row gives the organisation’s name and its web address.

The counts in a row include every organisation beneath it. Expand all and Collapse all act on the whole tree. Find an organisation filters by name and web address as it is typed, and keeps a match’s parents in view. Cancelled organisations are hidden until Show removed is pressed. Suspended by parent means the organisation was not suspended itself, and is suspended because an organisation above it is.

# Actions

Each row’s menu opens Groups, Users, Alerts, Report and Audit for that organisation, and offers these actions.

Suspend stops the organisation and every organisation beneath it: their collectors cannot connect and their users cannot sign in. Nothing is deleted. Resume restores everything.

Cancel organisation asks for the organisation’s short name to confirm. Where the branch has enrolled collectors, it also asks for an acknowledgement that each must be enrolled elsewhere to keep reporting. A cancelled organisation stays under Show removed with the status Cancelled, and offers Resume until its data is deleted.

The signed-in user’s own organisation, and the platform organisation created at the fleet server’s first run, never offer Suspend, Move to another parent or Cancel organisation.

# Branch rule

A user can see and change their own organisation and the organisations beneath it, and nothing else. A customer’s Admin sees the customer alone. A request for a parent or a sibling organisation gets a not found response. A suspension applies to every organisation beneath the suspended one.

# Reseller tree

A reseller’s Admin sees its customers’ terminals on the dashboard, with their certificates and audit history, and can change them. Each customer sees only itself. Tokens are per organisation: the Tokens page generates tokens for the signed-in user’s own organisation only, so a customer’s tokens are generated by the customer’s own Admin, or at the command line.

# Web addresses

The short name of a child of the platform organisation is made from the name typed at creation. The short name of a child of any other organisation is its parent’s short name, a hyphen, and the name typed: <parent>-<child>, at every level. The short name is fixed at creation, so an organisation moved to a new parent keeps its original web address.

# Platform and customer administrators

# Command line

There is no rename command. The display name is changed on the page. See Command line for every flag.