RCC Troubleshooting

RCC ist das Kommandozeilenwerkzeug, um mit dem die Python-Environments für Robotmk Framework gebaut werden können.
Das praktische dabei: es kommt sowohl bei der Testentwicklung, als auch während der Ausführung durch Robotmk zum Einsatz. Das garantiert, dass die Scripte immer in einer verlässlichen Umgebung laufen.

Doch manchmal kann es beim Bauen oder Aktivieren der Environments zu Fehlern kommen.
Dieser Artikel fasst die häufigsten Fehlerquellen bei der Arbeit mit RCC zusammen und zeigt, wie man sie effizient behebt.

Allgemeine Fehler

Fehlerhafte Dateiendung

Fehler: Du bekommst eine diese Meldungen:

Lösung:

conda.yaml bzw. robot.yaml kann nicht gefunden werden - stimmen die Dateiendung? (Oft ist die Ursache “yml” statt “yaml”.)

Benutzerprofil mit Leerzeichen

Fehler: RCC gibt bei jedem Aufruf einen Fehler zurück:

Beschreibung: Aus unbekannten Gründen darf das Benutzerprofil keine Leerzeichen enthalten.

Lösung: Ändern Sie den Pfad, in dem RCC die Umgebungen speichern soll:

• Definieren Sie eine neue Umgebungsvariable ROBOCORP_HOME und weisen Sie ihr ein Verzeichnis Ihrer Wahl (ohne Leerzeichen) zu. Beispiel: C:\rcc
• Starten Sie eine neue CMD und versuchen Sie es erneut.

Environment-Erstellung

Erstellung der Umgebung schlägt fehl (Windows, VCRUNTIME140_1.dll / Fehlercode 0xc0000135)

Auf einigen Windows-Systemen fehlt die DLL VCRUNTIME140_1.dll (der Grund dafür ist unbekannt). Das beim bau der Environments verwendete Tool micromamba bricht die Erstellung der Umgebung mit einer nichtssagenden Meldung ab:

Die Ursache kann verifiziert werden, wenn man das in der RCC-Ausgabe aufgeführte Tool micromamba.exe manuell auf der Konsole ausführt.
Fehlt die DLL tatsächlich, erzeugt micromamba diese Fehlermeldung:

Auf Windows 11-Systemen tritt der Fehler auch mit dem Fehlercode 0xc0000135 zu Tage:

Fatal [Micromamba [3221225781/c0000135]]: exit status 0xc0000135

Lösung: Installiere das Microsoft Visual C++ Redistributable von Microsoft - es enthält exakt diese DLL.

Erstellung der Umgebung bricht ab (Windows, 0x80092012 und 0x80092013)

Fehler: RCC (micromamba) kann unter Windows keine Umgebung erstellen und bricht mit folgendem SSL-Fehler ab:

critical libmamba Multiple errors occured:
    Download error (35) SSL connect error [https://conda.anaconda.org/conda-forge/noarch/repodata.json.zst]
    schannel: next InitializeSecurityContext failed: Unknown error (0x80092012)

(Manchmal auch mit Fehlercode 0x80092013)

Beschreibung: Auf Windows verwendet das in RCC eingesetzte micromamba intern libcurl mit dem Schannel-Backend (statt OpenSSL).
Das bedeutet: die Zertifikatsprüfung erfolgt über den Windows Certificate Store und die sogenannten Windows-Revocation-Mechanismen (CRL/OCSP).

Beim Aufbau der HTTPS-Verbindung führt Schannel automatisch eine solche Revocation-Prüfung durch (also die Überprüfung, ob ein Zertifikat vielleicht widerrufen wurde).
Schlägt diese fehl – z. B. weil der Revocation-Server nicht erreichbar ist oder durch Netzwerkregeln blockiert wird – bricht der TLS-Handshake ab.

Ursachen:

• Unternehmensnetzwerke mit Proxy / Gateway (z. B. Cloudflare Gateway)
• von der Firewall blockierter Zugriff auf CRL/OCSP-Server
• Interne oder “intercepted” Zertifikate

Wichtig zu wissen:

• rcc config diagnostics kann erfolgreich sein, da dort keine strikte Revocation-Prüfung erfolgt
• Andere Tools funktionieren ggf. problemlos, weil sie OpenSSL statt Schannel verwenden oder Revocation-Fehler komplett ignorieren
• Das in RCC arbeitende micromamba hingegen verhält sich strikt, da Schannel den Fehler als kritisch bewertet!

Lösung: Deaktiviere die Revocation-Prüfung für micromamba über eine Umgebungsvariable:

MAMBA_SSL_NO_REVOKE=true

Die Variable muss unbedingt als Systemvariable hinterlegt werden (nicht als User-Variable). Danach den Host neu starten und die Erstellung des Environments erneut versuchen.

LongPath Support

Fehler: Beim Aktivieren der erforderlichen LongPath-Unterstützung mit rcc config longpaths -e erscheint diese Fehlermeldung:

WARNING! Long path support failed. Reason: exit status 1. WARNING! Long paths do not work!

Error executing: rcc.exe configure longpaths --enable 
Error code: undefined Error: error Stderr: Failure to modify registry: Access is denied.

Beschreibung: Offensichtlich wird der Windows-Rechner zentral über Gruppenrichtlinien verwaltet, wodurch die LongPath-Richtlinie nicht geändert werden kann.

Lösung: Bitte den für die GPOs zuständigen Administrator, diese Richtlinie zu setzen: Local Computer Policy > Computer Configuration > Administrative Templates > System > Filesystem > NTFS > Enable Win32 long paths > Enabled

Netzwerkzugriff per Proxy

Fehler: Während der Erstellung der Umgebung schlägt RCC aufgrund von Netzwerkfehlern fehl.

Beschreibung: RCC benötigt Internetzugang, um die Installationsdateien und -pakete herunterzuladen.¹ Wenn ein Proxy-Server im Netzwerk verwendet wird, musst Du diesen in einem “Profil” angeben.

So geht’s:

• Lade zunächst die Datei (Vorlage) von hier herunter und speichere sie irgendwo im Dateisystem.
• Öffne die Datei mit einem Editor und gib die Adresse des Proxys in http_proxy und https_proxy an. (Protokoll und Port müssen ebenfalls angegeben werden!)

Beispiel:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

name: MyProxy
description: RCC proxy profile
settings:
  certificates:
    verify-ssl: true
  network:
    no-proxy: 'localhost,127.0.0.1'
    https-proxy: 'http://myproxy.local:3128'
    http-proxy: 'http://myproxy.local:3128'
  meta:
    name: MyProxy
    description: RCC proxy profile
    source: Robotmk

• Führe anschließend die folgenden Befehle aus, um das Profil zu importieren und zu aktivieren.

> rcc config switch # zeigt das aktuelle Profil an (Standard)
> rcc config import -f <Datei>.yaml # importiert das Proxy-Profil
> rcc config switch -p <Profilname> # zum neuen Profil wechseln

Reset auf das Standardprofil (= kein Proxy) ist möglich mit

rcc config switch --noprofile.

Hinweis: Der oben beschriebene Ansatz funktioniert nur, wenn der verwendete Proxy alle Domains prinzipiell/weitestgehend zulässt (→ man spricht dann von einem “transparenten” oder “offenen” Proxy). Sogenannte “Whitelisting"-Proxys sind da schon restriktiver: Sie verwenden eine Liste erlaubter Domains; jeglicher sonstiger Datenverkehr wird standardmäßig blockiert.

Wenn dies bei Dir der Fall ist, musst Du den Proxy-Administrator bitten, die folgenden Domains in die Whitelist aufzunehmen:

anaconda.org
conda.anaconda.org
files.pythonhosted.org  
pypi.org
registry.npmjs.org  
playwright.azureedge.net  
playwright-akamai.azureedge.net  
playwright-verizon.azureedge.net
github.com
githubusercontent.com
raw.githubusercontent.com

VS Code

Environment kann nicht in VS Code benutzt werden

Fehler: Du hast VS Code korrekt aus dem aktivierten Environment heraus gestartet (code .), trotzdem fragt VS Code nach dem Interpreter. Robot Framework kann nicht gefunden werden.

Beschreibung: Seit kurzem installiert sich neben der Python-Erweiterung für VS Code automatisch noch eine weitere namens Python Environments. (Diese soll offensichtlich das Handling von virtuellen environments erleichtern - unterstützt aber nicht RCC-Environments, wie es scheint… )

Lösung: Deinstalliere (bzw. deaktiviere) diese Erweiterung und starte VS Code danach neu.