Troubleshooting - Adaptive Applications - BlueCat Gateway - 20.8.1

BlueCat Overlay for Microsoft

Product name
BlueCat Gateway

Reviewing log data

When working with BlueCat Overlay for Microsoft, information is logged into different mounted directories that are defined when starting the Gateway container.
  • /logs/: Includes BlueCat Gateway system logs.
  • /app_log/: Includes logs specific to the BlueCat Overlay for Microsoft application.
  • /app_data/: Includes JSON-formatted files that contain data gathered from Microsoft servers.

If you suspect that the data is not processed as intended, review the log files within the /app_log/ directory. For further troubleshooting, you can review the JSON files within the /app_data/ directory to analyze the data that has been imported from the Microsoft servers.

Reviewing common errors

When reviewing the execution logs, you might see errors and warnings when importing data from your Microsoft DNS and DHCP servers. Log files use the following naming convention: overlay_YYYYMMDD_HHMMSS.

The following table outlines error messages that can be found in the log files, including a possible cause of the error and suggested actions to resolve the issue.

Log message Possible cause Suggested action
Option ID <id>, MSFT Name: <option name> not implemented yet The specified DHCP option is not yet supported. If this option is critical to your infrastructure, contact Customer Care for assistance.
Unable to add DNS record <record> zone (<zone name>). Missing Linked DNS Record The associated host record does not exist in Address Manager. Verify if that host record was skipped due to a missing network or due to an invalid format. Ensure the host record exists in DNS and can be added to Address Manager successfully.
Unable to add the IP addresses to Host record. Network not found. The IP address could not be added to a Host record, as a network in Address Manager could not be found. Import the network if it belongs to a DHCP Scope. Otherwise, consider creating the network manually.
Unable to add range due to overlap with gateway. A DHCP range cannot start with first address in the network. Verify if the range overlaps with default gateway or router address.
Too many DHCPv4 roles in network The network cannot have more than 2 DHCP Roles. This can indicate a rogue or misconfigured DHCP Server, or that there is an overlapping network deployed to different DHCP servers. Verify that the DHCP network does not overlap with an existing "managed" network in Address Manager. Alternatively, you can import this network in a new configuration.
Invalid MAC address for IP The MAC address is not a valid 12 digit hexadecimal number. This occurs if the DHCP server recorded client UID instead of the hardware address. If the IP address is a reservation, consider updating the MAC address.
No data returned by server This error can be logged for different reasons that can result in the unsuccessful execution of remote Powershell commands. The most common failures are due to the following:
  • Invalid CSV file format
  • Invalid credentials
  • Incorrect SSL flag (HTTP or HTTPS)
In some cases, this can occur if the Windows server is not running DNS or DHCP services.
Verify the connection information and ensure that the Windows Server is running DNS or DHCP services.
Zone Primary could not be found or Zone Type not supported The DNS Zone configuration did not return a valid IP address of the Primary DNS Server. This can also occur if the zone type is not supported by the solution. Verify the DNS configuration on the Microsoft Windows DNS Server for valid IP address or name.