Chapter 4. Migrating Hosts From Katello Agent to Remote Execution
Remote Execution is the preferred way to manage package content on hosts. The Katello Agent is deprecated and will be removed in a future Satellite version. Follow these steps to switch to Remote Execution.
Prerequisites
- You have enabled the Red Hat Satellite Client 6 repository on Satellite Server. For more information, see Enabling the Red Hat Satellite Client 6 Repository in Installing Satellite Server in a Connected Network Environment.
- You have synchronized the Red Hat Satellite Client 6 repository on Satellite Server. For more information, see Synchronizing the Red Hat Satellite Client 6 Repository in Installing Satellite Server in a Connected Network Environment.
-
You have previously installed the
katello-agent
package on content hosts.
Procedure
-
If you have Remote Execution configured to use
ssh
mode, distribute the remote execution SSH keys to the hosts. For more information, see Section 12.14, “Distributing SSH Keys for Remote Execution”. -
If you have Remote Execution configured to use
pull-mqtt
mode, deploy the remote execution pull client to the hosts. For more information, see Section 12.5, “Configuring a Host to Use the Pull Client”. Stop the goferd service on content hosts:
# systemctl stop goferd
Disable the goferd service on content hosts:
# systemctl disable goferd
Remove the Katello agent on content hosts:
WarningIf your host is installed on Red Hat Virtualization version 4.4 or lower, do not remove the
katello-agent
package because the removed dependencies corrupt the host.# dnf remove katello-agent
- In the Satellite web UI, navigate to Administer > Settings.
- Select the Content tab.
- Set the Use remote execution by default parameter to Yes.
The Satellite server now uses host management by remote execution instead of Katello Agent.
The following table shows the remote execution equivalent commands to perform specific package actions. See hammer job-invocation create --help
to learn how to specify search queries to determine the target hosts or host collections.
Action | Katello Agent | Remote Execution |
---|---|---|
Install a package |
|
|
Install a package (host collection) |
|
|
Remove a package |
|
|
Remove a package (host collection) |
|
|
Update a package |
|
|
Update a package (host collection) |
|
|
Update all packages |
|
|
Install errata |
|
|
Install errata (host collection) |
|
|
Install a package group |
|
|
Install a package group (host collection) |
|
|
Remove a package group |
|
|
Remove a package group (host collection) |
|
|
Update a package group |
|
|
Update a package group (host collection) |
|
|