Red Hat Training
A Red Hat training course is available for Red Hat Satellite
Chapter 4. Users and Roles
4.1. Creating and Managing Users
4.1.1. Creating a User
Procedure 4.1. To Create a User:
- Navigate to Administer → Users and then click New User.
- On the User tab, enter the required details.
- On the Locations tab, select the required locations for this user.
- On the Organizations tab, select organizations accessible to this user. The current active organization is selected by default. If you specify multiple organizations, you can select the default organization for user login from the drop-down list.
- On the Roles tab, select the required roles for this user. Active roles are displayed in the right panel.
- Click Submit to create the user.
4.1.2. Editing a User
Procedure 4.2. To Edit an Existing User:
- Navigate to Administer → Users.
- Click the user name of the user to be altered. General information about the user will appear on the right.
- In the User tab, you can modify the user's user name, first name, surname, email address, default location, default organization, language, and password.
- In the Locations tab, you can modify the user's assigned locations.
- In the Organizations tab, you can modify the user's assigned organizations.
- In the Roles tab, you can modify the user's assigned roles.
- Click Save to save your changes.
4.1.3. Assigning Roles to a User
Procedure 4.3. To Assign a Role to a User:
- Navigate to Administer → Users. If a user account created is not listed, check that you are currently viewing the right organization. To list all users in Satellite, click Default Organization and then Any Organization. The organization view is changed to Any Context.
- Click the user name of the user that you want to modify. General information about the user appears on the right.
- Click the Locations tab, and select a location if none is assigned.
- Click the Organizations tab, and check that an organization is assigned.
- Click the Roles tab to display the list of available role assignments.
- Select role you want to assign to the user in the Roles list. The list contains the predefined roles, as well as any custom roles, see Table 4.1, “Predefined Roles Available in Red Hat Satellite”. Alternatively, select the Administrator check box to assign all available permissions to the selected user.
- Click Save.
4.1.4. Configuring Email Notifications
Important
Procedure 4.4. To Configure Email Notifications:
- Navigate to Administer → Users.
- Click the Username of the user you want to edit.
- On the User tab, check the Email address field. Ensure that it contains a valid email address. The address will be associated with the user account, and the notifications selected in the following steps will be sent there.
- Click the Email Preferences tab and select Mail enabled to enable email notifications.
- Select the notifications you want the user to receive.
- Audit summary is a summary of all activity audited by the Satellite Server. To enable these notifications, select the frequency of emails from the drop-down list that offers Daily, Weekly, or Monthly updates. Enter a query in the associated query field to narrow the audit activity included.
- Host built is a notification sent when a host is built. To enable these notifications, select Subscribe from the drop-down menu.
- Host errata advisory is a summary of applicable and installable errata for hosts managed by the user. To enable these notifications, select the frequency of emails from the drop-down list that offers Daily, Weekly, or Monthly updates.
- OpenSCAP policy summary is a summary of OpenSCAP policy reports and their results. To enable these notifications, select the frequency of emails from the drop-down list that offers Daily, Weekly, or Monthly updates.
- Promote errata is a notification sent only after a Content View promotion. It contains a summary of errata applicable and installable to hosts registered to the promoted Content View. This allows you to monitor what updates have been applied to which hosts. To enable these notifications, select Subscribe from the drop-down menu.
- Puppet error state is a notification sent after a host reports an error related to Puppet. To enable these notifications, select Subscribe from the drop-down menu.
- Puppet summary is a summary of Puppet reports. To enable these notifications, select the frequency of emails from the drop-down list that offers Daily, Weekly, or Monthly updates.
- Sync errata is a notification sent only after synchronizing a repository. It contains a summary of new errata introduced by the synchronization. To enable these notifications, select Subscribe from the drop-down menu.
- Click Submit.
To test email delivery to the email address associated with a user account, open the Satellite web UI, navigate to Administer → Users, click on the user name, click the Email Preferences tab and click Test email. A test email message is then sent immediately to the user's email address. If it does not arrive, first verify the user's email address, then the Satellite Server's email configuration, after which you may need to examine firewall and mail server logs.
To verify that your subscription to selected email notifications is valid, you can have all periodic notifications sent to you on request. Note that it will trigger all notifications scheduled for the specified frequency, and affect all users who have subscribed to it. Sending on request notifications to individual users is currently not supported.
# foreman-rake reports:frequency
- daily
- weekly
- monthly
4.1.5. Removing a User
Procedure 4.5. To Remove a User:
- On the main menu, click Administer → Users to open the Users page.
- Click the Delete link to the right of the user name you want to delete.
- In the alert box, click OK to delete the user.