Skip to content

Guardian Essentials

Workflow 5 min read View Markdown

Connection Managers#

A Connection Manager is a small service you run on a host in your network. It reaches CIs over WinRM (Windows) or SSH (Linux and macOS) so Guardian can scan them without an agent.

Connection Managers are organised into Connection Manager groups, such as one per data centre. A CI scanned agentlessly is assigned to a group, and any Connection Manager in that group can scan it.

Create a group and add a Connection Manager#

  1. Open CM Groups and select Add Connection Manager. Name the new group (for example, London DC Group).
  2. Choose where the Connection Manager will run:
    • Windows: download the installer and run it on the host that will do the scanning. It needs the Microsoft Visual C++ 2015 Redistributable (x64). Set the service to run as a user with administrator rights on the CIs it scans.
    • Linux: run the one command shown. It installs and registers the Connection Manager on Debian, Ubuntu, RHEL, CentOS and Amazon Linux.
  3. Paste the credentials shown in Guardian into the Connection Manager's registration screen.
  4. Wait for it to check in. Guardian shows it as connected once it does, and you can continue to add a CI.

You can add more Connection Managers to a group later, for capacity or resilience.

Check a group's health#

Open a group to see its Connection Managers, their Connection Health and Last Activity, and the CIs assigned to it.

If no Connection Manager checks in

Check that the service is running on the host, and that the host can reach Guardian over the network. A group with no Connection Manager can't scan its CIs.

Next#

Store the credentials your Connection Managers use: see Credentials.