1. Pre-installation checks:

   • Red Hat Insights is supported in Satellite 5.7 and later. For more information, refer to the Cloud Deployment Matrix for Predictive Analysis.

   • Satellite Organizations with Insights must be running in Connected mode. Any firewalls or proxies through which the Satellite server communicates to Red Hat must allow https communications to https://access.redhat.com .

2. 1

   Activate your evaluation.

   Note: If you have purchased an Insights subscription, skip this step and proceed to the next step.

   To begin evaluating Red Hat Insights, visit https://access.redhat.com/insights/evaluation to activate any available evaluations associated with your account. This step must be completed prior to any system registration with Insights.

3. 2

   Enable Red Hat Insights.

   Log in to the Satellite administrator account. Navigate to Admin --> Insights. Before enabling Insights, click Test Conection to Red Hat Insights API. If the test is successful, a circled green checkmark appears.

   If unsuccessful, a red circle and a log appear. When the test is successful, select Enable Insights Service then click Update. The Red Hat Insights GUI pieces now appear in Satellite.

4. 3

   Install RPM and register to Red Hat Insights.

   There are multiple ways to automate this process. We've provided several options for popular configuration management tools below:

   Puppet

   Chef

   Ansible

   To install and register a system manually:

   [root@server ~]# yum install insights-client

   ​​[root@server ~]# insights-client --register

   To install and register a system through Red Hat Satellite:

   Navigate to Systems > Insights > Setup as an Organization Administrator. Select the systems to install the redhat-access-insights RPM onto, then click "Apply."

   

   Check the status of the RPM installation by navigating to Schedule > Pending Actions.

   

   The RPM installation will be shown on the Completed Actions page when finished.

   

5. 4

   See your results.

   Shortly after you execute insights-client --register on at least one machine, navigate to Systems > Overview in Satellite. Find the system you registered. The status should either be a green check or a red exclamation symbol.

   
   

   If you see a red exclamation symbol, click it to see reports about your system.

   To see an overview of all system reports, navigate to Systems > Insights > Overview.

   
   

   

1. Pre-installation checks:

   • Red Hat Insights is supported in Satellite 6.1 and later. For more information, refer to the Cloud Deployment Matrix for Predictive Analysis.

   • Ensure that you’ve synchronized the latest RHEL 6.7 and RHEL 7.1.z RPMs to your Satellite, and made them available to your clients.

   • To make the Red Hat Satellite Server an Insights client, follow the Customer Portal registration instructions and run the following command prior to installing the redhat-access-insights client:

     ​[root@server ~]# yum update python-requests

   • ​Satellite Organizations with Insights must be running in Connected mode. Any firewalls or proxies through which the Satellite server communicates to Red Hat must allow https communications to https://cert-api.access.redhat.com .

2. 1

   Activate your evaluation.

   Note: If you have purchased an Insights subscription, skip this step and proceed to the next step.

   To begin evaluating Red Hat Insights, visit https://access.redhat.com/insights/evaluation to activate any available evaluations associated with your account. This step must be completed prior to any system registration with Insights.

3. 2

   Subscribe Insights clients to Satellite server.

   This step is typically already performed as part of a Satellite host configuration. Only RHEL hosts registered to the a particular Satellite server will have reports available in the Satellite UI.

4. 3

   Verify connection to Red Hat Insights.

   Verify that the Satellite server can successfully communicate with Red Hat Insights. In the Satellite UI, navigate to Insights > Manage. Verify that the engine connection status is "Connected" and the account number displayed is correct for your organization.

   

5. 4

   Install the Insights RPM and register your system to Red Hat Insights.

   There are multiple ways to automate this process. We've provided several options for popular configuration management tools below:

   • Puppet
   • Chef
   • Ansible

   If you are using Red Hat Satellite’s configuration management provided by Puppet this process can be automated by applying the preinstalled Puppet class access_insights_clients. This class can be imported from the Puppet Master into the appropriate Puppet environment and applied to hosts that you wish to subscribe to Red Hat Insights. For more information on this topic, refer to the Creating a Host Group chapter in the official Satellite 6 User Guide .

   To install and register a system manually:

   [root@server ~]# yum install insights-client

   ​​[root@server ~]# insights-client --register

6. 5

   See your results.

   After registration, the Insights client will upload initial system metadata to Red Hat Insights. You can immediately see your system in the Satellite UI or in the Insights user interface at https://access.redhat.com/insights/ (if the Show Satellite Systems setting is enabled for the account).

7. 6

   Assign Red Hat Insights roles to users.

   By default, only administrators can view Insights Report and Configuration screens. However, you can give non-admin users access to the Insights screens by assigning them the appropriate roles as follows:

   • To give users access to all Insights screens, including the Manage screen, assign them the Insights Admin role. Users must also be granted the view_content_host permission.

   • To give users Insights report and rule viewing access, assign them the Insights Viewer role. These users must also be granted the view_content_host permission.

   For more information on roles, refer to the official Satellite 6 documentation .

1. Pre-installation checks:

   • Red Hat Insights is supported in Red Hat CloudForms version 4.0 and later. For more information, refer to the Cloud Deployment Matrix for Predictive Analysis.

   • The CloudForms appliance must either be registered to a Satellite Server, version 6.1.5 or later, or to the Customer Portal Subscription Management hosted subscription service.

   • Smart State Analysis capability is enabled for Red Hat Enterprise Linux virtual machines.

2. 1

   Activate your evaluation.

   Note: If you have purchased an Insights subscription, skip this step and proceed to the next step.

   To begin evaluating Red Hat Insights, visit https://access.redhat.com/insights/evaluation to activate any available evaluations associated with your account. This step must be completed prior to any system registration with Insights.

3. 2

   Register all systems for updates in order to resolve software dependencies.

   ​[root@server ~]# subscription-manager register --auto-attach

4. 3

   Verify CloudForms appliance registration.

   All appliances configured for the UI role to view Red Hat Insights reports must be registered for Red Hat updates. In the CloudForms Management Engine UI, navigate to Configure > Configuration. Select a zone and verify that the appropriate appliance is registered.

   Note: The Satellite Server organization to which the CloudForms appliance is registered must have Insights enabled.

   

5. 4

   Configure Smart State Analysis.

   Configure the Smart State Analysis profile for your appliances to collect the contents of the file / etc/insights-client/machined-id .

   

6. 5

   Install the Insights RPM and register your system to Red Hat Insights.

   Important: All virtual machines must be registered to the same Red Hat account as the CloudForms appliance.

   There are multiple ways to automate this process. We've provided several options for popular configuration management tools below:

   • Puppet
   • Chef
   • Ansible

   To install and register a system manually:

   [root@server ~]# yum install insights-client

   ​​[root@server ~]# insights-client --register

   Note: If you have a web-based proxy between your system and the Internet, you can configure the Insights client to connect through it. For more information, refer to How to access Red Hat Insights through a firewall/Proxy?

7. 6

   Run Smart State Analysis on RHEL virtual machines.

   A Smart State Analysis must be run once on all RHEL virtual machines you have registered to Red Hat Insights. This step is only required once. If a new virtual machine is created afterward, then a Smart State Analysis need only be run on that new virtual machine after it has been registered to Insights.

   For more information on how to configure and run Smart State Analysis, see the official CloudForms documentation .

8. 7

   See your results.

   After registration, the Insights client will upload initial system metadata to Red Hat Insights. You should be able to immediately see your system in the Insights user interface at https://access.redhat.com/insights/ .

9. 8

   Assign Red Hat Insights to user roles.

   By default, only super administrators can view Insights Report and Configuration screens. You can give non-admin users access to the Insights screens by assigning the appropriate features to their roles.

   ​​​​​​​

   In addition to the feature controls above, a user can only view Insights reports on those virtual machines to which the user has permission to view in CloudForms.

1. Pre-installation checks:

   Important: Insights for OpenShift is available as a Technology Preview feature. As such, it is not suitable for production environments. Learn more about Technology Preview features.

   Before installing Red Hat Insights, the following prerequisites must be met:

   OpenShift deployment must be version 3.2 or later.

   Firewall rules must allow Red Hat Insights to make outbound connections to https://api.redhat.com:443 and https://cert-api.access.redhat.com:443 .
2. 1

   Activate your evaluation.

   Note: If you have purchased an Insights subscription, skip this step and proceed to the next step.

   To begin evaluating Red Hat Insights, visit https://access.redhat.com/insights/evaluation to activate any available evaluations associated with your account. This step must be completed prior to any system registration with Insights.

3. 2

   Install the Insights client.

   Install the Insights client using the following commands, and use a unique cluster identifier of your choosing:
   

   [root@server ~]$ sudo yum install insights-client

   [root@server ~]$ sudo insights-client --register --group=<Cluster-ID>

   You will use the unique cluster ID to filter nodes in the Red Hat Insights UI on the Customer Portal. Creating a unique cluster ID of your choice will simplify locating it among the systems listed in Insights.

   Note: If you have a web-based proxy between your system and the Internet, you can configure the Insights client to connect through it. For more information, refer to How to access Red Hat Insights through a firewall/Proxy?

4. 3

   Repeat steps 1 & 2.

   Repeat steps 1 and 2 on all nodes.

1. Pre-installation checks:

   Important: Red Hat Insights for Red Hat OpenShift image scanning is available as a Technology Preview feature. As such, it is not suitable for production environments. Learn more about Technology Preview features.

   1. If you are using Red Hat Subscription Manager and haven't refreshed the channels recently, or the required repo is reporting as unavailable when attempting to add the repo, you may need to run:

   # subscription-manager refresh

   On the Openshift Master Node (this can be run from any RHEL 7 client host with the Openshift client “oc” installed):

   2. Enable the Red Hat Insights Repository and install the Red Hat Insights client package:

   # subscription-manager repos --enable=rhel-7-server-insights-3-rpms

   3. Install the CLI application RPM:

   # yum install insights-ocp-cli
2. 1

   Deploying the scanning application

   1. Log in to the OpenShift cluster as the cluster administrator:

   # oc login

   2. Create an Insights scanning project and initiate a scan:

   # insights-ocp-cli install --user <redhat-user-name> --password <redhat-password>

   Note: The default scanning limit is two nodes at a time.

3. 2

   Image scanning operations

   Start Scan

   # insights-ocp-cli start-scan

   Stop Scan

   # insights-ocp-cli stop-scan

4. 3

   Viewing scan results

   The results for image scanning are published in the insights-ocp-ui application running within the Openshift cluster. Navigate to the insights-scan project and click on the insights-ocp-ui application link.

   

   Oauth is enabled in the Insight OCP UI and allows you to log in using your OpenShift credentials.

   Following an image scan, it will appear in the list of scanned images in the Insights OCP UI.

   

   Click on the image to view details of the image scan. Select an issue to view the details of that issue, or click Expand All to view the details of all issues found during the scan.

   

1. Uninstalling Insights

   The following command will uninstall Insights from the node, as well as all data from Insights image scans.

   # insights-ocp-cli uninstall

Ansible Playbook Integration

Red Hat Insights has added the ability to deploy maintenance plans as Ansible Playbooks, enabling system administrators to save time, be more productive, eliminate repetitive tasks, and reduce or eliminate errors.

The benefits of Ansible Playbooks can be enabled using the Insights UI and command line, or by using Ansible Tower.

Red Hat Insights UI

To use playbooks from the Red Hat Insights UI in Customer Portal, refer to the instructions in Creating Insights Maintenance Plans with Ansible Playbook Integration.

Ansible Tower

To use playbooks using Ansible Tower, refer to Setting up an Insights Project in the Ansible Tower User Guide.