Problem: UCS@school: User Import in the School Console Fails with 503 Errors

Knowledge Base Community
, , ,
1

UCS@school: User Import in the School Console Fails with 503 Errors

Problem:

In a UCS@school 5.0 environment, the user import in the School Console (Schulkonsole) no longer functions.
When opening the user import module, the following error message appears in the log file:

Log file: /var/log/univention/management-console-module-schoolimport.log

13.11.25 11:34:00.577  MODULE      ( PROCESS ) : Der UCS@school Import API HTTP Server konnte nicht erreicht werden. Es scheint, dass dieser fehlkonfiguriert, nicht installiert ist oder er durch eine Proxy/Firewall blockiert wird.
13.11.25 11:34:00       ERROR      (     7660) : 503 POST /univention/command/schoolimport/schools (0.0.0.0) 21.56ms
13.11.25 11:34:00.607  MODULE      ( PROCESS ) : Received request 'schoolimport/jobs/query': ('Administrator', None, None, 'de_DE.UTF-8')
13.11.25 11:34:00.618  MODULE      ( PROCESS ) : Der UCS@school Import API HTTP Server konnte nicht erreicht werden. Es scheint, dass dieser fehlkonfiguriert, nicht installiert ist oder er durch eine Proxy/Firewall blockiert wird.
13.11.25 11:34:00       ERROR      (     7660) : 503 POST /univention/command/schoolimport/jobs/query (0.0.0.0) 10.82ms
13.11.25 11:34:00.666  MODULE      ( PROCESS ) : Received request 'schoolimport/userroles': ('Administrator', None, None, 'de_DE.UTF-8')
13.11.25 12:32:21.145  DEBUG_INIT

The School Console reports that the UCS@school Import API HTTP Server cannot be reached, indicating that it may be misconfigured, not installed, or blocked by a proxy/firewall.

Root Cause:

This problem typically occurs when one or more of the following UCS@school backend services are not running properly:

  • ucs-school-import-http-api.service
  • ucs-school-import-celery-worker.service
  • univention-management-console-server.service
  • univention-directory-manager-rest.service

A temporary issue or failure in the Univention Management Console (UMC) services may prevent the user import module from communicating with the backend import API, resulting in 503 errors.

Solution:

Restart the affected services to reinitialize the UCS@school import backend and the UMC infrastructure.

Run the following command on the affected system:

systemctl restart ucs-school-import-http-api.service \
                 ucs-school-import-celery-worker.service \
                 univention-management-console-server.service \
                 univention-directory-manager-rest.service

After the restart, open the School Console again and attempt the user import once more.