The following commands allow you to view and manage hosts and groups of hosts.
This section includes the following:
The add-host command adds predefined host data to the system before agent installation. The agent on the host adds the host automatically. If there is already a host in the system with the given host name, the command results in an error.
To get valid values for the -D parameter, use the -ld command. The value of -h must not already be in the output of the -lah command.
The delete-host command removes a host from the management of the system. This command is effective only if the agent has been stopped or uninstalled.
Parameter |
-h hostname – Specify the name of the host. |
Syntax |
uce_cli -dh -h hostname -u username -p password |
Example |
uce_cli -dh -h wserver03 -u admin -p 123 |
To get valid values for the -h parameter, use the -lah command.
The rename-host command renames a host, from an existing name to a new name. The name of the host is not the DNS name (Unique String) of the machine, but the Sun Update Connection – Enterprise name of the host. You can change this name at any time without affecting the machine or its configurations.
To get valid values for the -sH parameter, use the -lah command.
A valid value for the -tH parameter is a new, unique host name. This name must not appear in the output of the -lah command.
The add-group command creates a new group of hosts.
To get valid values for the -pG parameter, use the -lg command.
The add-host-group command assigns a managed host to a group.
To get valid values for the -h parameter, use the -lah command.
Valid values and results for the -g parameter:
If the group exists (use the -lg command), the host is added to it.
If the group does not exist, it is created and the host is assigned to it.
If the group exists, but has a parent not given in the CLI command, a new top-level group is created by the same name. You can have same-named groups of different hierarchies.
If the named group is written as a nested group (“parent/nested”), and this group-path does not exist, all the groups are created.
The delete-group command deletes a group and its sub-groups from the system. It does not unregister the managed hosts. It cannot be used on default groups.
Parameter |
-g groupname – Specify the name of the group. |
Syntax |
uce_cli -dg -g "groupname" -u username -p password |
Example |
uce_cli -dg -g WebServers -u admin -p 123 |
To get valid values for the -g parameter, use the -lg command.
The rename-group command renames a group, from an existing name to a new name.
To get valid values for the -sG parameter, use the -lg command.
A valid value for the -tG parameter is a new, unique group name. It must not appear in the output of the -lg command.