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. |
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 |
The -attr argument only sets the overrides. Attributes not explicitly included retain their default value.
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 |
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 |
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 |
This command queries for hosts that match either specified criteria or a specified filter.
You must call this command with either a query (with -query) or a filter (with -filt or -phys).
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 |
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 |
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.