1.2. Using the Red Hat Update Infrastructure Manager

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

Procedure 1.1. Starting Red Hat Update Infrastructure Manager

  1. Start Red Hat Update Infrastructure Manager by running the rhui-manager command from the command prompt: 
    # rhui-manager
  2. If Red Hat Update Infrastructure Manager has not already stored a password for you, it will ask you to login. Once you have successfully authenticated, Red Hat Update Infrastructure Manager will display a prompt, ready to accept commands: 
    rhui (home) =>
  3. When a menu is displayed, Red Hat Update Infrastructure 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, Red Hat Update Infrastructure Manager is connected to rhua.example.com, and the current screen is the Home screen: 
    		Connected: rhua.example.com
----------------------------------------------
rhui (home) =>

Procedure 1.2. Logging Out of the Red Hat Update Infrastructure Manager

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

Procedure 1.3. Exiting the Red Hat Update Infrastructure Manager

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

    Note

    Quit and exit perform the same operation. Credentials for a session are still valid after executing any of the two commands.

Procedure 1.4. Navigating around Red Hat Update Infrastructure Manager

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

Red Hat Update Infrastructure Manager Screens

Red Hat Update Infrastructure 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 delivery 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 1.2. The Home Screen

This example shows the Home screen on a typical Red Hat Update Infrastructure 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
   i   manage identity certificate

   <   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) =>
Report a bug