Adapter Status is Red

Issue Statement

My adapter shows up in IAP but one of the status indicators is red.

What You Can Do

If the first status is red, the adapter did not come up and you should follow the process in the Adapter Not in IAP. If the second status is red, the adapter is up but the healthcheck has failed.

Here are some things that you can do to try to resolve the issue:

• Recheck some of the basic common areas:
  • Make sure the adapter has connectivity.
  • Make sure the adapter has the proper url paths. Especially for the healthcheck. Often the healthcheck is set up as a default path because no path has been determined to be a good healthcheck. This path most likely does not exist in the other system and therefore healthcheck will always fail until a better healthcheck call can be determined and the path set appropriately in the /adapter-home-dir/entities/.system/action.json
  • Make sure the adapter is configured for the correct authentication.
• Put the adapter into debug level logging. This is critical to determine what the adapter is doing and be able to compare it to what it is supposed to do.
  • See article on Why Debug Logs Are Important.
  • It might be easier to run integration testing from the adapter with debug logs turned on to test the healthcheck. You need to set up the integration test to just run the healthcheck and to for proper connectivity to the actual system in the sampleProperties.json. Then you will need to set the log level in the package.jsonto see what is happening.
• Run the command used for healthcheck in Postman or Curl to provide a comparison on what works.
  • You may need to make changes to the healthcheck configuration, namely:
    • Changes to IAP Service Instance Configuration for the adapter.
    • Changes to the healthcheck action defined in the Endpoint Configuration .system entity (/adapter-home-dir/entities/.system). The healthcheck action is used to define the call that will check if the other system is available.

If you are unable to determine the issue by looking at the log, follow the Support process to create a ticket with the log information and the Itential Adapters Team will be happy to assist.