299000 - Backend Operation Failed

Agent error code #299000 is the fallback the agent reports when a backend operation failed without supplying a specific reason. It carries no detail of its own, so the useful information is in the agent log rather than in this message.

Every backend has its own error codes for the failures it can identify. Seeing this generic code means the failure did not match any of them.

Common causes include:

• The device or service returned an error that does not map to one of its specific codes
• An unexpected condition arose while the change was being applied
• A backend that does not yet publish a specific code for the operation that failed

Steps to Resolve

Check the Agent Log

This is the first and most useful step. The agent log records the underlying error with the knoc, the address and the operation that failed. The log entry carries detail this message deliberately does not.

1. On the agent host, inspect the agent log around the time of the failed grant
2. Look for the entry naming the knoc and the address from the failed operation

Retry the Operation

If the underlying cause was transient, retrying the grant from the Knocknoc admin interface succeeds.

Confirm the Backend Configuration

Open the knoc and check the backend configuration against the setup guide for that backend type. If the backend supports validation, run Validate to have the agent check its own configuration and report what is wrong.

Contact Support

If the code persists and the agent log does not make the cause clear, send the log entries covering the failed operation, the backend type and the agent version to [email protected].