Chapter 1. Accessing Red Hat Satellite

1.1. Logging in to Red Hat Satellite

After Red Hat Satellite has been installed and configured, use the web user interface to log in to Satellite for further configuration.

Installing the Katello Root CA Certificate

The first time you log in to Satellite, you may see a warning informing you that you are using the default self-signed certificate and you may not be able to connect this browser to Satellite until the proper root CA certificate is installed in the browser. Use the following procedure to locate the root CA certificate on the Satellite server and to install it in your browser.

  1. Browse to http://satellite.example.com/pub
  2. Select katello-server-ca.crt.
  3. Import the certificate into your browser.

To Log in to Satellite:

  1. Access the Satellite Server using a web browser pointed to the fully qualified domain name:

    https://satellite.example.com/

    To identify the fully qualified domain name of your Satellite Server, use the hostname -f command: 

    # hostname -f
    Important

    An untrusted connection warning appears in your web browser when accessing Satellite for the first time. Accept the self-signed certificate and add the Satellite URL as a security exception to override the settings. This procedure might differ depending on the browser being used.

    Only do this if you are sure that the Satellite URL is a trusted source.

    Untrusted Connection Warning
  2. Enter the user name and password created during the configuration process. If a user was not created during the configuration process, the default user name is admin. If you have forgotten the password of the default administrative account, admin, see Section 1.2, “Changing the Password”.

Result

When you have successfully logged in, you are taken to the Satellite dashboard. The dashboard contains an overview of the Satellite and the hosts registered. For more information, see Using the Red Hat Satellite Content Dashboard and Searching and Bookmarking.

The main navigation tabs are as follows:

Table 1.1. Navigation Tabs

Navigation TabsDescription

Any Context

Clicking this tab changes the organization and location. If no organization or location is selected, the default organization is Any Organization and the default location is Any Location. Use this tab to change to different values.

Monitor

Provides summary dashboards and reports.

Content

Provides content management tools. This includes Content Views, Activation Keys, and Life Cycle Environments.

Containers

Provides container management tools.

Hosts

Provides host inventory and provisioning configuration tools.

Configure

Provides general configuration tools and data including Host Groups and Puppet data.

Infrastructure

Provides tools on configuring how Satellite 6 interacts with the environment.

Red Hat Insights

Provides Red Hat Insights management tools.

Red Hat Access

Provides access to Red Hat knowledgebase, Satellite log files, and support cases.

User Name

Provides user administration where users can edit their personal information.

notfications1

Provides event notifications to keep administrators informed of important environment changes.

Administer

Provides advanced configuration for settings such as Users and RBAC, as well as general settings.

1.2. Changing the Password

These steps show how to change your password.

To Change your Red Hat Satellite Password:

  1. Click your user name at the top right corner.
  2. Select My Account from the menu.
  3. In the Current Password field, enter the current password.
  4. In the Password field, enter a new password.
  5. In the Verify field, enter the new password again.
  6. Click the Submit button to save your new password.

1.3. Resetting the Administrative User Password

These steps show how to reset the administrative user password.

To Reset the Administrative User Password:

  1. Log in to the machine where Satellite Server is installed.

  2. Enter the following command to reset the password: 

    # foreman-rake permissions:reset
Reset to user: admin, password: qwJxBptxb7Gfcjj5
  3. Log in to the web user interface and change the password.

1.4. Setting a Custom Message on the Login Page

To Set a Custom Message on the Login Page:

  1. Navigate to Administer > Settings, and click the General tab.
  2. Click the edit button next to Login page footer text, and enter the desired text to be displayed on the login page. For example, this text may be a warning message required by your company.
  3. Click Save.
  4. Log out of the Satellite’s web UI and verify that the custom text is now displayed on the login page below the Satellite version number.