Skip to main content

Management-Server Commands

The commands described in this section are used for managing the management servers (Key Manager Servers) that are part of your Key Manager system.

list-mgmt-servers

Syntax:

ssh-mgr-client list-mgmt-servers [options] \
[-F <filter>] [-vvv] [-U <url>] [-o <format>] [-C <columns>] [-H] \
[-O <sort-order>] [-S <start-from>] [-M <max-results>] [-E <delim>] [-B]

The default command lists all the Key Manager back ends in the system:

$ ssh-mgr-client list-mgmt-servers

backend01.example.com,1,True,True,0.0,16.8,0 minutes,
...

The following columns can be used for filtering (-F) and output formatting (-C):

backend

Is this server configured to act as a backend

fqdn

Fully qualified domain name of the server

frontend

Is this server configured to act as a frontend

hostkey

Hostkey of the server. Only usable for output formatting (-C).

id

Numeric identifier for the server

last_updated

When the server was last running a backend. Only usable for output formatting (-C).

load

Current load of the server. Only usable for output formatting (-C).

memory_usage

Current memory usage on the server. Only usable for output formatting (-C).

port

Agent listener port on the server. Only usable for output formatting (-C).

tags

Tags the server has been tagged with

timesince_last_updated

How long ago the server was last running a backend. Only usable for output formatting (-C).

uniqueid

Unique identifier for the server. Only usable for output formatting (-C).

username

Unix username used by the server. Only usable for output formatting (-C).

Example for listing all the Key Manager Servers that act as both front ends and back ends:

$ ssh-mgr-client list-mgmt-servers -F 'backend=True&&frontend=True'