.. SPDX-FileCopyrightText: 2026 Univention GmbH
..
.. SPDX-License-Identifier: AGPL-3.0-only

.. _ox-connector-troubleshooting:

***************
Troubleshooting
***************

Use this chapter to diagnose and resolve OX Connector provisioning problems.
It describes the available troubleshooting resources.

:ref:`ox-connector-troubleshooting-manage-provisioning-tasks`
    Check provisioning health, handle failed or blocked tasks,
    and re-provision data.

:ref:`ox-connector-troubleshooting-ucs`
    Inspect log files and resolve deployment-specific problems,
    including stale OX database IDs, duplicate display names,
    missing group members, and invalid identifiers.

:ref:`ox-connector-troubleshooting-kubernetes`
    Read OX Connector and Provisioning Service logs,
    and resolve deployment-specific provisioning problems.

:ref:`ox-connector-troubleshooting-migration`
    Recover shared accounts after an interrupted migration
    from functional accounts.

:ref:`ox-connector-troubleshooting-collect-support-information`
    Gather log messages, reproduction steps, expected behavior,
    and affected provisioning data for Univention Support.

.. toctree::
   :caption: Contents

   manage-tasks
   ucs
   kubernetes
   migration-to-shared-accounts
   support-ticket