Troubleshoot Authoring and Review
Recover draft and review work using current content, correct permissions, and resource-specific validators.
Start with the failed task, not a service restart. Policy tracks draft work, governed revisions, and protection progress separately. A healthy service does not prove that a policy protects its targets.
Use this table to choose the troubleshooting guide that matches the symptom:
| Symptom | Next Task |
|---|---|
| Cannot save, submit, request changes, or approve | Follow authoring and review troubleshooting. |
| Approval succeeded, but publication or withdrawal stopped | Follow publication and withdrawal recovery. |
| Publication reports a missing or conflicting native identity | Follow policy ownership reconciliation. |
| Need to remove saved ownership mappings across policies | Follow verified-stale binding cleanup. |
| Approved output does not reflect changed source information | Follow automatic recompilation troubleshooting. |
| Cannot reach Policy, authenticate, or start workloads | Follow installation, identity, and routing troubleshooting. |
| Identity provider (IdP) connection data remains empty after installing Policy later than Traverse | Check known issues and workarounds. |
| Need to identify an error or prepare a support handoff | Use common errors and diagnostics. |
Complete the following steps:
Do not share credentials or invent another user’s audit identity. Owner or editor access does not grant every command capability. Refer to roles and permissions.
An ordinary author might lack access to restricted diagnostics or operations. Retain the visible error and ask an authorized operator to investigate. A support reference does not grant diagnostic access. Policy does not provide universal self-service recovery for audit-only evidence. Use the glossary to distinguish authentication tokens, version validators, and delivery evidence.
Use the diagnostic handoff when the next action requires authority you do not have. Keep the recovery directory for links to earlier recovery topics.
Recover draft and review work using current content, correct permissions, and resource-specific validators.
Identify reported Policy installation limitations, their workarounds, and the evidence required before declaring recovery.
Find a failed publication or removal request, identify who can resolve its error, and retry only after checking the cause.
Resolve a missing or conflicting PIM object mapping using the identifiers and actions returned by the reconciliation API.
Enumerate saved bindings and forget only mappings that complete live inventory and current Policy evidence prove safe to remove.
Distinguish unchanged output, failed refreshes, blocked cycles, and deferred publication without inventing a manual recompilation trigger.
Identify the right evidence and recovery task for common Policy failures.
Collect accessible evidence and prepare a safe handoff without assuming cluster or administrator access.
Find the canonical recovery task without confusing deployment retry, ownership repair, and platform recovery.
Isolate platform startup, access, and route failures without weakening authentication or assuming a safe database rollback.
Was this page helpful?