Chapter 1. Accessing 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.

1.1. Installing the Katello Root CA Certificate

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

Prerequisites

Your Red Hat Satellite is installed and configured.

Procedure

  1. Identify the fully qualified domain name of your Satellite Server:

    # hostname -f
  2. Access the pub directory on your Satellite Server using a web browser pointed to the fully qualified domain name:

    https://satellite.example.com/pub
  3. When you access Satellite for the first time, an untrusted connection warning displays in your web browser. 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. Ensure that the Satellite URL is valid before you accept the security exception.
  4. Select katello-server-ca.crt.
  5. Import the certificate into your browser as a certificate authority and trust it to identify websites.

Importing the Katello Root CA Certificate Manually

If you cannot add a security exception in your browser, import the Katello root CA certificate manually.

  1. From the Satellite CLI, copy the katello-server-ca.crt file to the machine you use to access the web UI:

    # scp /var/www/html/pub/katello-server-ca.crt \
    username@hostname:remotefile
  2. In the browser, import the katello-server-ca.crt certificate as a certificate authority and trust it to identify websites.

1.2. Logging on to Satellite

Use the web user interface to log on to Satellite for further configuration.

Prerequisites

Ensure that the Katello root CA certificate is installed in your browser. For more information, see Section 1.1, “Installing the Katello Root CA Certificate”.

Procedure

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

    https://satellite.example.com/
  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 problems logging on, you can reset the password. For more information, see Section 1.5, “Resetting the Administrative User Password”.

1.3. Navigation Tabs in the Satellite Web UI

Use the navigation tabs to browse the Satellite web UI.

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.

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.

Insights

Provides Red Hat Insights management tools.

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.4. 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.5. Resetting the Administrative User Password

Use the following procedures to reset the administrative password to randomly generated characters or to set a new administrative password.

To Reset the Administrative User Password:

To reset the password to randomly generated characters, complete the following procedure:

  1. Log on to the base operating system 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. Use this password to reset the password in the Satellite web UI.
  4. Edit the ~/.hammer/cli.modules.d/foreman.yml file on Satellite Server to add the new password:

    #  vi ~/.hammer/cli.modules.d/foreman.yml

Unless you update the ~/.hammer/cli.modules.d/foreman.yml file, you cannot use the new password with Hammer CLI.

To Set a New Administrative User Password:

To change the administrative user password to a new password, complete the following steps:

  1. Log on to the base operating system where Satellite Server is installed.
  2. To set the password, enter the following command:

    # foreman-rake permissions:reset password=new_password
  3. Edit the ~/.hammer/cli.modules.d/foreman.yml file on Satellite Server to add the new password:

    #  vi ~/.hammer/cli.modules.d/foreman.yml

Unless you update the ~/.hammer/cli.modules.d/foreman.yml file, you cannot use the new password with Hammer CLI.

1.6. 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.