4.2. Using RHUI Manager

RHUI Manager operates using an interactive shell. This section describes how to interact with RHUI Manager, including common concepts and commands.

Starting RHUI Manager

  • Start RHUI Manager by running the rhui-manager command from the command prompt: 
    $ rhui-manager
  • If RHUI Manager has not already stored a password for you, it will ask you to login. Once you have successfully authenticated, RHUI Manager will display a prompt, ready to accept commands: 
    rhui (home) =>
  • When a menu is displayed, RHUI Manager will display the name of the server it is connected to at the bottom, immediately above the prompt. At the prompt, the text in the parentheses ( ) indicates which screen you are currently viewing. In this example, RHUI Manager is connected to rhua.example.com, and the current screen is the Home screen: 
    		Connected: rhua.example.com
----------------------------------------------
rhui (home) =>

Logging out of RHUI Manager

  • The logout command is accessible at any time. Logging out will remove any stored authentication credentials that were saved when first logging in to RHUI Manager. Next time RHUI Manager is run, the user will be prompted to log in again.
  • To log out of RHUI Manager, type logout at the prompt. You will be returned to the command line: 
    rhui (home) => logout
[user@example]$

Exiting RHUI Manager

  • To exit RHUI Manager, type q, quit, or exit at the prompt. You will be returned to the command line: 
    rhui (home) => quit
[user@example]$
  • RHUI Manager can also be exited by typing Ctrl+C from within the interface.

Navigating around RHUI Manager

There are several commands that can be used at any time to navigate around RHUI Manager:
  • < to move to the previously viewed screen
  • home or ^ to return to the home screen
  • clear or / to clear the screen
  • help or ? to display the help screen
    The help screen is divided into screen and shell commands. Screen commands are used at the RHUI Manager prompt, and shell commands are used at the shell prompt. For more information about using RHUI Manager from the shell prompt, see Section 4.3, “Using RHUI Manager from the Shell Prompt”

RHUI Manager Screens

RHUI Manager uses screens to provide access to functions. Each screen has its own menu of related commands
Home
The Home screen is the first screen displayed after logging in. It provides access to the other screens.
Repository Management
The Repository Management screen is used to list, add, and delete repositories. You can also create and upload packages to custom repositories.
CDS Management
The CDS Management screen is used to list, add, and delete content distribution server (CDS) instances.
From this screen, you can also access the CDS Repository Management screen, which allows you to view and change information for individual CDS instances. While in this screen, the prompt will indicate the hostname of the CDS being edited: 
rhui (cds1.example.com) =>
Synchronization Status
The Synchronization Status and Scheduling screen is used to display and change the synchronization schedules for CDS instances and repositories, and view past synchronizations. You can also trigger individual synchronizations.
Client Entitlement Management
The Client Entitlement Management screen is used to create new entitlement certificates and client configuration RPMs.
Entitlements Manager
The Entitlements Manager screen is used to list entitled products in the current content certificate and upload new certificates.
User Manager
The User screen is used to change the user password.

Example 4.2. The Home Screen

This example shows the Home screen on a typical RHUI Manager setup. Return to this screen at any time by typing home or ^ at the prompt: 
------------------------------------------------------------------------------
             -= Red Hat Update Infrastructure Management Tool =-


-= Home =-

   r   manage repositories
   c   manage content delivery servers (CDS)
   s   synchronization status and scheduling
   e   create entitlement certificates and client configuration RPMs
   n   manage Red Hat entitlement certificates
   u   manage users

   <   move to the previous screen
   ^, home
       move to the home screen
   /, clear
       clears the screen
   ?, help
       display help
   q, quit, exit
       exit

                                                           Connected: rhua.example.com
------------------------------------------------------------------------------
rhui (home) =>