Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 4. Running tasks in Red Hat Insights

Red Hat Insights provides built-in task playbooks that you can run on your remote Red Hat Enterprise Linux systems to automate common administrative actions. You can run tasks directly from the Insights UI.

The pre-built tasks that you can run in the Red Hat Insights include:

  • Run the Insights client
  • Run the Ansible ping module
  • Pre-conversion analysis for converting to RHEL
  • Convert to RHEL from CentOS Linux 7
  • Pre-upgrade analysis for in-place upgrade from RHEL 8
  • Initiate update of image mode for RHEL host
  • Initiate update of RHEL AI host

Note: Prerequisites and actions required to run specific Red Hat Insights tasks will vary.

Use the following instructions to run a task in Red Hat Insights:

Prerequisites

  • You are logged in to the Red Hat Hybrid Cloud Console.
  • You are a member of a User Access group with the Tasks administrator role.

  • You have connected systems and addressed dependencies for remote host configuration (rhc), rhc-worker-playbook, and ansible-core, as needed.

  • You have addressed dependencies for Satellite version 6.11 or higher.

Procedure

  1. Navigate to Automation Toolkit > Tasks.
  2. Find a task in the list, and click Select systems. A table that lists the systems eligible to run the specified task is displayed.
  3. Optional: Edit the default task name to customize it with a more meaningful name so that you can find it on the Tasks Activity tab later.
Note

After you run the task, you cannot change the task name again.

  1. Review the task-specific prerequisites shown in the brief description of the task, and take the required actions.

  2. Select the checkbox beside the systems you want to run the task on. You can use filters to search and filter systems by:

    • Name
    • Operating system
    • Tags
    • Task eligibility
  3. Optional: For some tasks, you can configure how the task runs and is logged in Insights. If applicable, click Next and complete the task setup options. If not applicable, proceed to the next step.
  4. Click Run task. The task runs on the selected systems.

Results

A pop-up message is displayed and confirms the task’s success or failure. Click View progress to go to the task activity details page, where you can see how the task is progressing on each of your selected systems and alerts requiring attention.

Important

A status of Completed indicates that the task ran successfully, but does not necessarily mean that the task achieved its intended goal.

Verification

Use the following steps to check the progress of the task and to verify that it ran successfully:

  1. Navigate to Automation Toolkit > Tasks > Activity to see the status of all the tasks you have run, including those in progress.
  2. Tasks are in chronological order, by the most recent run date and time. Use the search, filter, and sort features to find the task you just ran.
  3. Click the task to open the activity details.

  4. Review the Status column to check whether there are any alerts or messages to resolve for your systems.

    • To see the full details of a message or alert, click the Show more caret beside the system name, as outlined in the following screen capture:

      A screen capture showing how to expand the caret icon to view the full status message of the task that ran on the selected system.

Important

A Completed status indicates that the task ran successfully, but does not indicate that the task accomplished its intended goal.

Next Steps

Resolve any errors. For example, you might have an error that occurs because your systems are missing a software patch, update, or other package required by one or more actions in a task.

  • After you resolve those errors, you can rerun the task from the task status details page within the Automation Toolkit > Tasks > Activity page. The task runs on the same systems as before, but you can also add more systems to the job.
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat