Managing hosts with the CLI

The HostTool enables you to add or remove entries from the Hosts table in the database. This is the information you see in the repository manager.

There are a number of reasons why you should have to do this manually, including, for example, the need to change the port of a pre-8.0 agent if its port changes.

The HostTool enables you to query the entries in following ways, and enables you to initiate a secure tunnel to an agent:

By agent name: --query --agent agentname
By agent OID: --query --agentOID hi_lo_typeid
By hostname, optionally specifying a port should more than one agent exist on that host: --query --host hostname [--port port_number]
By IP address, optionally specifying a port should more than one agent exist on that host: --query --ip [--port port_number]
By those pending an agent (entries that have no agent are automatically updated when an agent connects from that host): --query-all-pending-agents
By verification date/time: --query-all-unverified-host-info OR --query-unverified-host-info

This section includes commands that enable you to perform the following tasks:

Click here to view options that you can use with the host command...

The following table contains the options that you can use with the host command:

Option	Argument	Description
--add	Not applicable	Primary command is to add a host entry.
--agent	Agent Name	Agent name.
--agentOID	hi_low_typeid	Object identifier of the agent.
--as-host	Host Name	Application Service host.
--as-port	Port Number	Application Service port.
--clear-unverified-host-info	YYYY-MM-ddHH:mm:ss	Clear host information that has not been verified since the date and time specified.
--host	Host Name	Host name.
--init-tunnel	Not applicable	Primary command to initiate a Secure Tunnel to the agent on the specified host or IP address.
--ip	IP Address	IP address of a host.
--port	Port	Port of the agent on a host.
--query	Query	Primary command is to query host entries.
--query-all-pending-agents	Not applicable	Query all host entries that have not been associated with an agent.
--query-all-unverified-host-info	Not applicable	Query host information that has not been verified.
--query-unverified-host-info	YYYY-MM-ddHH:mm:ss	Query host information that has not been verified since the date and time specified.
--remove	Not applicable	Primary command is to remove a host entry.
-h	Not applicable	Prints usage information.
-p	Password	Password.
-s	Not applicable	Specify password via stdin. This is mutually exclusive with -p.
--stdin	Not applicable	Specify password via stdin. This is mutually exclusive with -p.
-v	Not applicable	Run in verbose mode.

Managing hosts with the CLI

On this page