Nodes

A node is an instance of software used for building connections, managing compute resources, and deploying software.

Node Types

A node can be installed on a hardware appliance, as a virtual appliance (Vsphere and Hyper-V), and deployed in a public cloud (Amazon AMI, Google, Microsoft). There are three main types of nodes - Edge, Gateway, and Management.

All Trustgrid nodes run on a hardened Ubuntu operating system. Nodes are managed through the Trustgrid portal or via the API (requires authentication token). A local UI exists to support the reconfiguration of an ethernet interface and diagnostic/network tests prior to connection to the Portal.

Edge Nodes

Edge Nodes build outgoing TLS tunnels to Gateway Nodes. Bidirectional traffic is supported through this tunnel, subject to ACLs and security policy restrictions. Edge Nodes will only require a firewall rule change if outbound internet restrictions are in place. Edge nodes can be a target for software deployment. Edge Nodes can be deployed with a single or multiple ethernet connections to support deployments behind a firewall or adjacent to a firewall (public WAN / private LAN).

Gateway Nodes

Gateway Nodes accept incoming TLS tunnels from Edge Nodes. Traffic on these tunnels is bidirectional, as permitted by ACLs or policy. Gateway Nodes usually require a firewall change to permit the incoming traffic. Gateway Nodes are identical to Edge Nodes but with a gateway configuration applied. Gateway nodes only connect to other gateways if one is of type hub. Read more about gateway configuration.

Management Nodes

Management Nodes are not like other nodes because they do not connect to the data plane, only the control plane. Management Nodes are deployed by Trustgrid for each customer and are multi-tenant like other control plane components. Customers may elect to deploy their own Management Nodes in place of multi-tenant Management Nodes. Management Nodes facilitate the monitoring, management, and support of Edge and Gateway Nodes.

Node Form Factors

Nodes are available in two form factors:

  • Appliance - This is a combination of a fully managed operating system and Trustgrid software pre-installed.
  • Agent - This is a software package that can installed on supported operating systems. Users can install additional software and configure the operating system as needed.
FunctionalityAgentAppliance
Gateway CapabilitiesNoneData Plane or ZTNA
Operating SystemMultiple Supported OS, install additional softwareFully managed OS and Trustgrid service, no additional software permitted
UpdatesManaged by user via OS native toolsOS and Trustgrid updates managed via Trustgrid
Interface IP ManagementManaged by user via OS native toolsConfigurable via Trustgrid portal or local console
Layer 3 VPNSingle Virtual Network connectivitySupport for multiple Virtual Networks
Layer 4 ProxyFull SupportFull Support
ComputeCommands onlyCommands, Containers or VMs supported

Node List View

Adding Node Appliances - Generating Licenses

Appliance-based nodes need a license generated by the Trustgrid control plane to register with your organization. This license can be generated in the portal from the Nodes page.

  1. Navigate to the Nodes list view.
  2. Click the Add Node button.
    Add Node button on Nodes page
  3. Enter a name for the node and click Create License.
    Node Name prompt
  4. A license key will be generated and displayed. Clicking in the license text window will automatically copy the license into your clipboard, or you can click the Download License button.
    Example license key

Adding Node Agents - Generating Tokens

Agent-based nodes require a token generated by the Trustgrid control plane to register with your organization. This token is also generated in the portal from the Nodes page.

  1. Navigate to the Nodes list view.
  2. Click the Add Agent button.

Adding a Tag as a Column on the Nodes Table

Adding a tag as a column on the nodes tables is good way to make valuable information visible for multiple nodes at the same time. To add the column:

  1. Navigate to the nodes table page
  2. Click Actions and then select Columns from the dropdown

img

  1. Towards the bottom you will see all the available tags in the format tag: tag-name. Select the desired tag and click Save.

img

The column will be added and the table can now be sorted by that column. Any node that does not have that tag set will be listed as blank.

img

Applying a Tag Filter to the Nodes Table

The nodes table can also be filtered to only show nodes with a specific tag name:value.

  1. On the nodes table click Actions and select Add Tag Filter from the drop-down menu.

img

  1. After clicking Add Tag Filter, select the tag-name field and you will see a list of tag-names available. Select the desired tag.

img

You can also start typing to filter what tag names are shown.

  1. Select the tag value field and you will see a list of available values. Select the desired value.

  2. (Optional) Click Add Tag Filter to include an additional filter. Note that the two filters will be applied using AND only nodes with both tag name:value combinations matching will be shown.

  3. Click Apply Tag Filter and the table will only show matching nodes.

img


Agent Nodes

Documentation of Trustgrid agent-based node configuration and functionality

Appliance Nodes

Documentation of Trustgrid appliance-based node configuration and functionality

Agent and Appliance Shared Configuration

Shared configuration options and functionality available on both agent and appliance nodes