Chapter 1. Using the Red Hat Update Infrastructure Manager

Red Hat Update Infrastructure Manager is used to interact with Red Hat Update Infrastructure. It allows you to manage CDS instances, repositories, certificates, and users.

1.1. Red Hat Update Infrastructure Manager First Launch

To start Red Hat Update Infrastructure Manager run rhui-manager command from the command prompt. This operation must be performed as the root user in order to obtain the necessary permissions: 
# rhui-manager

Starting the Red Hat Update Infrastructure Manager for the First Time

When Red Hat Update Infrastructure Manager is run for the first time, it will prompt for some extra information before it will start.
Entitlement-Signing CA Certificate and its Private Key
User will be prompted for the entitlement-signing CA certificate and its private key.
Password for CA Certificate (Optional)
Red Hat Update Infrastructure Manager will generate an identity certificate using the entitlement signing CA certificate. If the CA private key requires a password, then you will need to enter that information.
Default Name and Password
Red Hat Update Infrastructure Manager will ask you to log in using the default name admin and password admin: 
--> rhui-manager
Previous authentication credentials could not be found. Logging into the RHUI.

If this is the first time using the RHUI, it is recommended to change the user's password in the User Management section of RHUI Tools.

RHUI Username: admin
RHUI Password: admin
The Home screen will be displayed after the password has been entered.
This login is used for the initial connection to the Red Hat Update Appliance. After the first login, a certificate is stored at ~/.rhui that identifies the user with the Red Hat Update Appliance for all future calls and prevents you from having to log in each time. Red Hat Update Infrastructure Manager will store authentication credentials for one week. Once authentication details have expired, all communications will fail until they have been refreshed. If you are using Red Hat Update Infrastructure when the credentials expire, you will be prompted to renew them the next time they are required for an operation. Otherwise, you will be asked to log in again next time you start Red Hat Update Infrastructure Manager.

Important

Ensure you change the default password for the Red Hat Update Appliance before you begin using the system. For details on how to do this, see Chapter 10, Configuring Users.
New Content Certificate
You will require a Red Hat content certificate and private key in order to access repositories with Red Hat Update Infrastructure Manager. Each product requires its own content certificate, which is provided by Red Hat. Once you have run Red Hat Update Infrastructure Manager for the first time, upload a new content certificate for each product you require by following the directions in Procedure 5.3, “Upload Content Certificate”.
Content certificates are installed to /etc/pki/rhui. This means that you will require write permission for /etc/pki/rhui to be able to install a new content certificate.

Example 1.1. Running Red Hat Update Infrastructure Manager for the First Time

This example shows the information that Red Hat Update Infrastructure Manager requests when being run for the first time. This information must be provided before Red Hat Update Infrastructure Manager can operate. 
# rhui-manager
An entitlement signing CA certificate is required to use RHUI Tools
but was not found.

Full path to the new signing CA certificate:
/root/rhui_certs/ca.crt

Full path to the new signing CA certificate private key:
/root/rhui_certs/ca.key

A RHUI identity certificate is required to use RHUI Tools but was not found.
A new identity certificate will be generated now using the CA certificate
found at /etc/pki/rhui/entitlement-ca.crt.

......................................+++
........................+++
Previous authentication credentials could not be found. Logging into
the RHUI.

If this is the first time using the RHUI, it is recommended to change
the user's password in the User Management section of RHUI Tools.

RHUI Username: admin
RHUI Password:


------------------------------------------------------------------------------
                           -= 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

   logout
      removes stored authentication credentials and exits
   < 
      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