The commands in this section are useful for all the other commands. They are used to find the values of other parameters. For example, if you have a command that needs a distribution name, run the -ld command to get the list of valid input.
This section includes the following:
The list-distributions command outputs the supported distributions on your local system.If you add the -all flag, all Sun Update Connection – Enterprise supported distributions are output.
Use this command to get valid values for the -D (distribution) parameter used in other CLI commands.
Flag |
-all – List all distributions supported by Sun Update Connection – Enterprise. Without this flag, only the distributions that have been locally activated are listed. |
|
Syntax |
uce_cli -ld [-all] -u username -p password |
|
Example |
uce_cli -ld -u admin -p 123 |
|
Result Example |
|
|
Example |
uce_cli -ld -all -u admin -p 123 |
|
Result Example |
|
The find-component command returns the exact names of components.
Use this command to get the values for the -T or -pT parameter used by other commands.
The list-all-hosts command outputs a complete list of all managed hosts in the system. Use this command to get values for the -h parameter of other parameters.
Parameter |
-dlt delimiter – Specify the delimiter for the output. |
Syntax |
uce_cli -lah [ -dlt "delimiter" ] -u username -p password |
Example |
uce_cli -lah -u admin -p 123 |
The list-host command outputs the properties (such as IP address, distribution, and so on) of a given host.
Parameter |
-h hostname – Specify the host name. |
|
Syntax |
uce_cli -lh -h hostname -u username -p password |
|
Example |
uce_cli -lh -h webserver2 -u admin -p 123 |
|
Result Example |
|
To get valid values for the -h parameter, use the -lah command.
Note that even if a managed host is not connected to Sun Update Connection – Enterprise at the time of the command, the data is still retrieved. An error number will be given (example: FailedErrCode = 34014464) if the host is not online.
The list-host-inventory command outputs the list of software installed on a given host.
Parameter |
|
|
Syntax |
uce_cli -lhi -h hostname [ -dlt "delimiter" ] -u username -p password |
|
Example |
uce_cli -lhi -h lnx013 -dlt " " -u admin -p 123 |
|
Result Example |
|
To get valid values for -h, use the -lah command.
The list-group command lists all the groups. Use this command to get values for the -g parameter used in other CLI commands.
Parameter |
-dlt delimiter – Specify the delimiter for the output. |
|
Syntax |
uce_cli -lg [ -dlt "delimiter" ] -u username -p password |
|
Example |
uce_cli -lg -u admin -p 123 |
|
Result Example |
|
Notice that nested groups are listed in a path. For any command that calls for the -g parameter to list a group, if you want a nested group, type its complete group path.
Groups that are named distribution_architecture hosts are default distribution groups. When an agent registers with the SDS, its distribution is recognized and the host is added to the appropriate distribution group. Each distribution group contains all the managed hosts of that distribution. The distribution groups’ host lists are system-defined and cannot be manually changed.
The All Hosts group is also a default group. It contains the complete list of managed hosts in your environment.
The list-group-hosts command outputs the hosts that are assigned to a given group.
Parameter |
|
|
Syntax |
uce_cli -lgh -g "groupname" [ -dlt "delimiter" ] -u username -p password |
|
Example |
uce_cli -lgh -g "topGroup/nestedGroup" -u admin -p 123 |
|
Result Example |
(Note that quotations are required for group paths and for group names that contain spaces.) |
|
Example |
uce_cli -lgh -g "nestedGroup" -u admin -p 123 |
|
Result Example |
Error: Requested group not found. (Error indicates that parent-group path is required for nested groups.) |
To get valid values for the -g parameter, use the -lg command.
The list-profiles command outputs a list of all existing profiles.
Use this command to get values for the -P parameter of other CLI commands.
Parameter |
-dlt delimiter – Specify the delimiter for the output. |
|
Syntax |
uce_cli -lp [ -dlt "delimiter" ] -u username -p password |
|
Example |
uce_cli -lp -u admin -p 123 |
|
Result Example |
|
Note that the profiles listed in the result example are the default, predefined profiles. Even if you have not yet created profiles, this command will have output.
The list-policies command outputs a list of all existing policies, predefined answers for a dependency resolver (DR). Use this command to get values for the -C parameter of other CLI commands.
Parameter |
-dlt delimiter – Specify the delimiter for the output. |
|
Syntax |
uce_cli -lc [ -dlt "delimiter" ] -u username -p password |
|
Example |
uce_cli -lc -dlt ", " -u admin -p 123 |
|
Result Example |
|
The Always Ask Me policy is the default policy. Even if you have not yet created policies, this command will have output.
The list-profile-attribute command outputs the attributes, the component-requirement combinations that make up a profile.
Parameter |
|
|
Syntax |
uce_cli -lpa -P "profile" [ -dlt "delimiter" ] -u username -p password |
|
Example |
uce_cli -lpa -P "create WebServer" -u admin -p 123 |
|
Result Example |
|
To get valid values for -P, use the -lp command.
If a predefined profile is used for the -P parameter, the output will be just the name of the profile.
Notice that the action is listed under the component (node). Although the action is listed as install or uninstall or upgrade or downgrade, a profile checks compliance. If the component is already installed and the action is “Install,” nothing is done and the profile succeeds.
The list-policy-attribute command outputs the attributes, the component-action-answer combinations, that make up a confirmation policy.
Parameter |
|
|
Syntax |
uce_cli -lca -C "policy" [ -dlt "delimiter" ] -u username -p password |
|
Example |
uce_cli -lca -C SWAutoYes -u admin -p 123 |
|
Result Example |
|
To get valid values for -C, use the -lc command.
The list-logs command outputs logs for actions on selected components of a host or of a group. You might ask to see, for example, uninstallation actions on Local RPMs for the WebServers group, installations of Networking components on one host, or any install or uninstall of Software on All Hosts.
Parameter |
|
Syntax |
uce_cli -ll -A action [ -dlt "delimiter" ] ( -g group | -h host ) -u username -p password |
Example |
uce_cli -ll -A Installs -h lnx13 -u admin -p 123 |
Result Example |
Tue May 4 16:32:17 2004 lnx13 Install httpd-devel-2.0.3-1 (RH9_IA32) Job_buildWebServer rochelle Explanation: time, host name, action, component, distribution, job name, and user name. |
Use the -lg to get values for the -g. Use the -lah to get values for the -h. Use the -ld to get values for the -D. Use the -fc to get values for the -T.
The list-job-status command outputs a list of jobs that you created with the current user name, according to the status criteria that you choose.
Parameter |
-dlt delimiter – Specify the delimiter for the output. |
|
Flag | ||
Syntax |
uce_cli -ljs [ -dlt "delimiter" ] ( -all | -ok | -fl | -pr | -wc ) -u username -p password |
|
Example |
uce_cli -ljs -ok -u admin -p 123 |
|
Result Example |
Explanation: job name, mode, start time, status; for two jobs: “makeWebServer” and “anotherJob.” |
The list-job-status-attributes command outputs status information (current status, profile data, and so on) of one job that you created with the current user name.
Parameter |
|
|
Syntax |
uce_cli -ljsa -j "jobname" [ -dlt "delimiter" ] -u username -p password |
|
Example |
uce_cli -ljsa -j ProvServer -u admin -p 123 |
|
Result Example |
Explanation: job name, job mode, start time, and status. |
To get valid values for the -j parameter, use the -ljs command.
If a host did not end successfully, more host and profile information is output.
The list-saved-snapshots command outputs a list of saved snapshots. When you save an inventory of a host or of a group, you create a snapshot. A snapshot is also saved, for each selected host, before a job is deployed.
Parameter |
|
|
Syntax |
uce_cli -lss ( -g group | -h host ) [ -dlt "delimiter" ] -u username -p password |
|
Example |
|
You must specify either -h or -g.
To get valid values for the -h parameter, use the -lah command. To get valid values for the -g parameter, use the -lg command.