Managing hosts with the CLI

The Host tool 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 Host tool 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
 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.

Was this page helpful? Yes No Submitting... Thank you

Comments