N1 Grid Service Provisioning System 5.0 Command-Line Interface Reference Manual

hdb.h: Managing Hosts

The hdb.h commands manage target hosts: physical and virtual hosts whose applications you are managing with the N1 Grid Service Provisioning System software.

Table 7–9 Summary of hdb.h Commands


Command	Description
hdb.h.add	Adds a new host.
hdb.h.del	Deletes a host
hdb.h.la	Lists all hosts.
hdb.h.lo	Retrieves information about a host.
hdb.h.lq	Queries for matching hosts.
hdb.h.mod	Modifies an existing host.

hdb.h.add

This command adds a new host to the host repository.

Table 7–10 Arguments and Results for the hdb.h.add Command


Argument/Result		Syntax	Description
name	[R]	String	The host name
desc	[O]	String	The host description
tID	[R]	HostTypeID	The ID of the host type
attr	[O]	Hashtable	The host attributes
hide	[O]	Boolean	Whether the host is hidden, default false
pID	[O]	HostID	The ID of the parent host if virtual, or empty if physical
result		Host	The new host

Note –

The -attr argument only sets the overrides. Attributes not explicitly included retain their default value.

hdb.h.del

This command deletes a host.

Table 7–11 Arguments and Results for the hdb.h.del Command


Argument/Result		Syntax	Description
ID	[R]	HostID	The host ID

hdb.h.la

This command lists all hosts in the repository.

Table 7–12 Argument and Result for the hdb.h.la Command


Argument/Result		Syntax	Description
sh	[O]	Boolean	Whether hidden hosts are shown, default false
result		HostArray	The hosts

hdb.h.lo

This command retrieves information about a host from the repository.

Table 7–13 Argument and Result for the hdb.h.lo Command


Argument/Result		Syntax	Description
ID	[R]	HostID	The host ID
result		Host	The host

hdb.h.lq

This command queries for hosts that match either specified criteria or a specified filter.

Note –

You must call this command with either a query (with -query) or a filter (with -filt or -phys).

Table 7–14 Arguments and Result for the hdb.h.lq Command


Argument/Result		Syntax	Description
query	[O]	AttributeCriteriaList	The query criteria
filt	[O]	AppTypeCriteria	The application type filter
phys	[O]	PhysicalCriteria	A filter to restrict to physical or virtual hosts
sh	[O]	Boolean	Whether hidden hosts are shown, default false
result		HostArray	The hosts

hdb.h.mod

This command modifies the specified attributes of an existing host. Omitted arguments preserve current values.

Table 7–15 Arguments and Result of the hdb.h.mod Command


Argument/Result		Syntax	Description
ID	[R]	HostID	The host ID
name	[O]	String	The host name
desc	[O]	String	The host description
tID	[O]	HostTypeID	The ID of the host type
attr	[O]	Hashtable	The host attributes
hide	[O]	Boolean	Whether the host is hidden
pID	[O]	HostID	The ID of the parent host if virtual, or “<null>” if physical
result		Host	The modified host

Note –

Use the -attr argument to specify the attributes whose values you want to modify. Attributes not explicitly specified retain (or are reset to) their default values.