When on-boarding a new host insight, a failure may occur due to several reasons, including policies, agent issues, or network issues. This troubleshooting guide will help identify and resolve the most common errors for host insights.

If a host insight is encountering issues it will be marked as Needs attention in the State column of the Host fleet page. You can verify the specific issue by clicking the i info button, this will display an error code that provides details on the issue and helps guide you through the troubleshooting process. The following is a list of all host insight error codes and how to solve them.

• OPSI_HCP_1000: Unable to update the instance.

  The manage instance-family policy is missing, to resolve add the following policies:

  • Allow group <group-name> to manage instance-family in compartment <compartment>
  • Allow any user to manage instance-family in compartment <compartment> where ALL { request.principal.type = 'opsihostinsight' }
  To create and manage policies see: Create and Manage Policies With Policy Advisor.
• OPSI_HCP_1001: Unable to list management agents from the instance.
  The manage management-agents policy is missing, to resolve add the following policies:

  • Allow group <group-name> to manage management agents in compartment <compartment>
  • Allow any user to manage management agents in compartment <compartment> where ALL { request.principal.type = 'opsihostinsight' }

  To create and manage policies see: Create and Manage Policies With Policy Advisor.
• OPSI_HCP_1002: The agent has failed, been deleted, is inactive, or is in silent mode.
  The agent is neither ACTIVE, nor AVAILABLE, to resolve follow these steps:

  1. Restart the management agent.
  2. If the error persists, check the management agent logs for any errors.
  3. If there is no clear error message, contact the management agent team.
  4. If the agent was deleted, disable the host insight first, then delete it.
  5. After deletion, create a new host insight with an existing management agent.
• OPSI_HCP_1003: The operation timed out while waiting for the agent.

  This is caused by a possible network configuration issue. To resolve, check the instance network configuration. The management agent may not have access to the internet.

• OPSI_HCP_1004: Unable to get host plugin Id.
  The manage management-agents policy is missing, to resolve add the following policies:

  • Allow group <group-name> to manage management agents in compartment <compartment>
  • Allow any user to manage management agents in compartment <compartment> where ALL { request.principal.type = 'opsihostinsight' }

  To create and manage policies see: Create and Manage Policies With Policy Advisor.
• OPSI_HCP_1005: Unable to fetch management agent.

  The manage management-agents policy is missing, to resolve add the following policies:

  • Allow group <group-name> to manage management agents in compartment <compartment>
  • Allow any user to manage management agents in compartment <compartment> where ALL { request.principal.type = 'opsihostinsight' }
  To create and manage policies see: Create and Manage Policies With Policy Advisor.
• OPSI_HCP_1006:The management agent was deleted.
  The agent is not AVAILABLE, to resolve follow these steps:

  1. If the agent was deleted, disable the host insight first, then delete it.
  2. After deletion, create a new host insight with an existing management agent.
• OPSI_HCP_1007: Unable to deploy the plugin to the agent.

  The manage management-agents policy is missing, to resolve add the following policies:

  • Allow group <group-name> to manage management agents in compartment <compartment>
  • Allow any user to manage management agents in compartment <compartment> where ALL { request.principal.type = 'opsihostinsight' }
  To create and manage policies see: Create and Manage Policies With Policy Advisor.
• OPSI_HCP_1008: Unable to create host source.

  The manage management-agents policy is missing, to resolve add the following policies:

  • Allow group <group-name> to manage management agents in compartment <compartment>
  • Allow any user to manage management agents in compartment <compartment> where ALL { request.principal.type = 'opsihostinsight' }
  To create and manage policies see: Create and Manage Policies With Policy Advisor.
• OPSI_HCP_1009:The operation timed out during the deployment of the host plug in.

  To resolve, retry the enable host insight operation.

• OPSI_HCP_1010:The operation timed out while handling the host source operation.

  To resolve, retry the enable host insight operation.