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

Comments