Chapter 2. Accessing Red Hat Satellite
After Red Hat Satellite has been installed and configured, use a browser to log in to the Satellite web UI interface. From the Satellite web UI, you can manage and monitor your Satellite infrastructure.
2.1. Logging in to the Satellite web UI Copy linkLink copied to clipboard!
Use the web user interface to log in to Satellite for further configuration.
Prerequisites
- Ensure that the Katello root CA certificate is installed in your browser. For more information, see Section 2.2, “Importing the Katello root CA certificate”.
Procedure
Access Satellite Server using a web browser pointed to the fully qualified domain name:
https://satellite.example.com/- 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.
Next steps
- If you have problems logging in, you can reset the password. For more information, see Section 2.3, “Resetting the administrative user password”.
2.2. Importing the Katello root CA certificate Copy linkLink copied to clipboard!
The first time you log in 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 imported in the browser. Use the following procedure to locate the root CA certificate on Satellite and to import it into your browser.
To use the CLI instead of the Satellite web UI, see CLI procedure.
Prerequisites
- Your Red Hat Satellite is installed and configured.
Procedure
Identify the fully qualified domain name of your Satellite Server:
# hostname -fAccess the
pubdirectory on your Satellite Server using a web browser pointed to the fully qualified domain name:https://satellite.example.com/pub- 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.
-
Select
katello-server-ca.crt. - Import the certificate into your browser as a certificate authority and trust it to identify websites.
CLI procedure
From the Satellite CLI, copy the
katello-server-ca.crtfile to the machine you use to access the Satellite web UI:# scp /var/www/html/pub/katello-server-ca.crt username@hostname:remotefile-
In the browser, import the
katello-server-ca.crtcertificate as a certificate authority and trust it to identify websites.
2.3. Resetting the administrative user password Copy linkLink copied to clipboard!
You can reset the administrative password to randomly generated characters or set a new administrative password for a specific user. This might be useful when you forget the password, when the administrative user is deleted, or for assigning administrative privileges to a user.
Procedure
- Log in to the base operating system where your Satellite Server is installed.
Reset the administrative user password:
To set a randomly generated administrative user password:
# foreman-rake permissions:reset Reset to user: admin, password: qwJxBptxb7Gfcjj5To set a new administrative user password:
# foreman-rake permissions:reset username=My_User_Name password=My_New_PasswordReplace
My_User_Namewith the username of the user whose password you want to reset.NoteBe aware of the following behaviors:
-
If you enter a username that does not exist, the
foreman-rakeutility creates a new administrative user with the defined password. - If you enter a username of a user without administrative privileges, that user gains administrative privileges.
-
If you do not enter a username, the password resets for the
adminuser by default.
-
If you enter a username that does not exist, the
To use the new password with the Hammer CLI, add the password and username to the
~/.hammer/cli.modules.d/foreman.ymlfile on your Satellite Server:# vi ~/.hammer/cli.modules.d/foreman.yml
Verification
- Use the new password to log in to the Satellite web UI.
2.4. Setting a custom message on the Satellite web UI login page Copy linkLink copied to clipboard!
You can change the default text on the login page to a custom message you want your users to see every time they access the page. For example, your custom message might be a warning required by your company.
Procedure
- In the Satellite web UI, navigate to Administer > Settings, and click the General tab.
- Enter your custom message in the Login page footer text field.
- Click Submit.
Verification
- Log out of the Satellite web UI and verify that the custom message is now displayed on the login page.