Sun Update Connection - Enterprise 1.0 Administration Guide

Executing CLI Commands

The command-line interface commands start with uce_cli. To get help, type the man uce_cli command.

To execute the command in the command line, type uce_cli -<command> [-<parameter> <value>] [...] [-<flag>] [...]

To execute the command in a script, type the commands in a shell script, just as you would embed other Linux commands.

Summary of Commands

This section lists command-line operations used to start, stop, restart, or check the status of any of the applications after installation. They all start up automatically after installation, except for the console. Status checks and restart commands are helpful when troubleshooting an application.

The following sections contain the command syntax for the different applications:

Starting Applications

The agent starts automatically, but if needed, you can restart the agent.

The following table provides the syntax for the commands that start the different applications.

Table 1–1 Starting Applications

Application  

Syntax  

To start the console 

uce_console

To start the agent 

/etc/init.d/uce_agent start

To start dependency manager 

/etc/init.d/uce_engine start

To run the CLI 

uce_cli

(without a parameter, a list of commands is displayed) 

To start the SDS 

/etc/init.d/uce_server start


Note –

If you receive a failed login request error message when attempting to log into the console, see Troubleshooting.



Example 1–1 To Start a Console

The console is the interface to the other applications, the control center for Sun Update Connection – Enterprise.

  1. On the console system, type uce_console.

  2. Wait until the Login window appears.

    If this is the first time you have run Sun Update Connection – Enterprise, and there are no local users yet, log in as admin, with the password 123. After the first login, you are prompted to change the password.

    When the console appears, you can begin managing hosts.


Stopping Applications

The following table provides the syntax for the commands that stop the different applications.

Table 1–2 Stopping Applications

Application  

Syntax  

To stop the agent 

/etc/init.d/uce_agent stop

To stop the dependency manager 

/etc/init.d/uce_engine stop

To stop the SDS 

/etc/init.d/uce_server stop


Example 1–2 To Stop an Agent

  1. Open a terminal window on the managed host.

  2. Type the following command:


    # /etc/init.d/uce_agent stop
    

Restarting Applications

The following table provides the syntax for the commands that restart the different applications.

Table 1–3 Restarting Applications

Application  

Syntax  

To restart the agent 

/etc/init.d/uce_agent restart

To restart the dependency manager 

/etc/init.d/uce_engine restart

To restart the SDS 

/etc/init.d/uce_server restart


Example 1–3 To Restart an Agent

  1. Open a terminal window on the managed host.

  2. Type the following command:


    # /etc/init.d/uce_agent restart
    

Checking the Application Status

The following table provides the syntax for the commands that check the application status.

Table 1–4 Checking the Application Status

Application  

Syntax  

To get the status of an agent 

/etc/init.d/uce_agent status

To get the status of the dependency manager 

/etc/init.d/uce_engine status

To get the status of the SDS 

/etc/init.d/uce_server status


Example 1–4 To Check the Status of an Agent

  1. Open a terminal window on the managed host.

  2. Type the following command:


    # /etc/init.d/uce_agent status