Reviewing log data
When working with BlueCat Overlay for Microsoft, information is logged into the default /logs/ directory that is defined when starting the Gateway container. If you suspect that the data is not processed as intended, review the log files within this directory.
Reviewing common errors
When reviewing the execution logs, you might see errors and warnings when importing
data from your Microsoft DNS and DHCP servers.
Attention: You must set
the logging level of BlueCat Gateway to DEBUG to retrieve the
execution logs.
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. |
| 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. |
| Failed to authenticate the <username> with negotiate | The Windows user might not have the correct roles configured. | Set the Disallow Negotiate Authentication value to Disable for WinRM Service and add the user to the Remote Management Users group. For more information, refer to Configuring Non-Administrative Windows Accounts. |
| Windows server exception: Access is denied. To run this cmdlet, start Windows PowerShell with the \ Run as administrator\ option | The Windows user might not have the correct roles configured. | This error occurs when clicking the Test button with non-administrative credentials within the BlueCat Overlay for Microsoft UI. This is a false positive. You can proceed to click Add to add the server. |
| Windows server exception: Cannot connect to CIM server. Access denied | The Windows user might not have the correct roles configured. | Verify that WMI access is correctly configured. For more information, refer to Configuring Non-Administrative Windows Accounts. |
| No DHCP Scopes or DNS Zones are returned and there are no errors | The Windows user might not have the correct roles configured. | Ensure that the user is added to the necessary AD groups and that the WMI namespace access is configured. For more information, refer to Configuring Non-Administrative Windows Accounts. |