Python Offline installieren

Diese Anleitung zeigt, wie Sie Python auf einem mindzieStudio Enterprise Server installieren, der keinen Internetzugang hat. Sie laden alles auf einem Computer mit Internetzugang herunter, kopieren einen Ordner auf den Server und installieren von dort aus. Keiner der Schritte auf dem Server benötigt eine Internetverbindung.

Planen Sie etwa 30 Minuten ein, plus einen Server-Neustart am Ende.

Wann Sie Python brauchen

Python wird nur für diese Funktionen benötigt:

Wenn Sie diese Funktionen nicht nutzen, müssen Sie Python nicht installieren.

Übersicht

Was Sie brauchen

• Einen Computer mit Internetzugang, auf dem Python installiert ist. Er kann Windows, macOS oder Linux verwenden, und jede aktuelle Python-Version. Er wird nur zum Herunterladen von Dateien verwendet.
• Eine Möglichkeit, einen Ordner auf den Server zu kopieren, z. B. ein USB-Laufwerk, eine Dateifreigabe oder das genehmigte Dateitransferverfahren Ihrer Organisation.
• Administratorzugang auf dem mindzieStudio Server.
• Mindestens 500 MB freien Speicherplatz auf dem Server.

Wählen Sie eine Python-Version

Verwenden Sie Python 3.13 (64-Bit). Diese Anleitung nutzt Python 3.13 in allen Beispielen.

Teil 1: Auf dem Computer mit Internetzugang

Schritt 1: Erstellen Sie den Offline-Ordner

Erstellen Sie einen Ordner namens python-offline mit einem darin liegenden Ordner packages. In PowerShell:

New-Item -ItemType Directory -Force -Path C:\python-offline\packages

Alles, was Sie herunterladen, kommt in diesen einen Ordner.

Schritt 2: Laden Sie den Python-Installer herunter

1. Gehen Sie zur Seite Python Releases for Windows
2. Finden Sie die neueste Python 3.13 Version
3. Klicken Sie auf Windows installer (64-bit). Die Datei heißt etwa python-3.13.15-amd64.exe
4. Speichern Sie die Datei in C:\python-offline

Schritt 3: Listen Sie die benötigten Pakete auf

Erstellen Sie eine Textdatei namens requirements.txt in C:\python-offline, mit jeweils einem Paketnamen pro Zeile.

Schließen Sie immer pandas und numpy ein. Jede Python Anreicherung und Python Script Aktion benötigt diese. Fügen Sie requests hinzu, wenn Ihre Skripte Webservices oder firmeneigene APIs aufrufen.

pandas
numpy
requests

Fügen Sie dann eine Zeile für jedes andere Paket hinzu, das Ihre Skripte verwenden. Schauen Sie sich die import-Zeilen in Ihrem Python-Code an. Einige Pakete werden unter einem anderen Namen installiert als importiert:

python -m pip freeze > requirements.txt

Schritt 4: Laden Sie die Pakete herunter

Öffnen Sie PowerShell und führen Sie aus:

cd C:\python-offline
python -m pip download -r requirements.txt -d packages --only-binary=:all: --platform win_amd64 --python-version 3.13

Was jede Option bewirkt:

Dank dieser Optionen muss der Computer, auf dem Sie herunterladen, nicht Windows oder dieselbe Python-Version wie der Server haben.

Der Befehl endet mit Successfully downloaded gefolgt von Paketenamen. Der Ordner packages enthält jetzt .whl Dateien wie pandas-3.0.5-cp313-cp313-win_amd64.whl. Der Teil cp313 zeigt an, dass die Dateien für Python 3.13 gebaut sind.

Schritt 5: Kopieren Sie den Ordner auf den Server

Kopieren Sie den gesamten Ordner python-offline auf den Server. Diese Anleitung geht davon aus, dass Sie ihn nach C:\python-offline auf dem Server kopieren.

Der Ordner sollte so aussehen:

C:\python-offline\
    python-3.13.15-amd64.exe
    requirements.txt
    packages\
        numpy-2.5.3-cp313-cp313-win_amd64.whl
        pandas-3.0.5-cp313-cp313-win_amd64.whl
        requests-2.34.2-py3-none-any.whl
        ... und weitere .whl Dateien

Ihre Versionsnummern können abweichen.

Teil 2: Auf dem mindzieStudio Server

Schritt 6: Installieren Sie Python für alle Benutzer

mindzieStudio läuft unter seinem eigenen Windows-Konto, nicht unter Ihrem. Es kann nur Python verwenden, das für alle Benutzer installiert und zum System-PATH hinzugefügt wurde.

Installieren Sie Python entweder über das Installationsfenster oder mit einem einzigen PowerShell-Befehl.

Option A: Installationsfenster

1. Rechtsklicken Sie auf python-3.13.15-amd64.exe und wählen Sie Als Administrator ausführen
2. Aktivieren Sie im ersten Bildschirm Add python.exe to PATH, dann klicken Sie auf Customize installation
3. Im Bildschirm Optional Features stellen Sie sicher, dass pip aktiviert ist, dann klicken Sie Next
4. Im Bildschirm Advanced Options:
   • Aktivieren Sie Install Python 3.13 for all users. Der Installationspfad ändert sich zu C:\Program Files\Python313
   • Stellen Sie sicher, dass Add Python to environment variables aktiviert ist
   • Lassen Sie alle Optionen, die mit Download beginnen, deaktiviert. Diese Optionen benötigen eine Internetverbindung
5. Klicken Sie Install, dann Close, wenn die Installation beendet ist

Option B: PowerShell-Befehl

Öffnen Sie PowerShell als Administrator und führen Sie den folgenden Befehl aus. Ersetzen Sie den Dateinamen durch den Namen des heruntergeladenen Installers.

Start-Process -FilePath "C:\python-offline\python-3.13.15-amd64.exe" -ArgumentList "/quiet InstallAllUsers=1 PrependPath=1 Include_test=0" -Wait

InstallAllUsers=1 installiert Python für alle Benutzer. PrependPath=1 fügt Python zum System-PATH hinzu. Der Befehl zeigt kein Fenster und beendet sich, wenn die Installation abgeschlossen ist.

Schritt 7: Überprüfen Sie die Python-Installation

Schließen Sie alle geöffneten PowerShell-Fenster. Öffnen Sie ein neues PowerShell-Fenster als Administrator. Ein neues Fenster wird benötigt, damit die aktualisierte PATH-Variable erkannt wird.

Führen Sie aus:

python --version
where.exe python

Erwartete Ausgabe:

Python 3.13.15
C:\Program Files\Python313\python.exe

Schritt 8: Installieren Sie die Pakete aus dem Ordner

Führen Sie im selben PowerShell-Fenster mit Administratorrechten folgendes aus:

python -m pip install --no-index --find-links C:\python-offline\packages -r C:\python-offline\requirements.txt

--no-index sagt pip, nicht ins Internet zu gehen. --find-links gibt an, dass pip aus Ihrem Ordner packages installieren soll.

Der Befehl endet mit Successfully installed gefolgt von den Paketnamen.

Bestätigen Sie, dass die Pakete geladen werden:

python -c "import pandas, numpy; print('pandas', pandas.__version__, 'numpy', numpy.__version__)"

Erwartete Ausgabe (Versionsnummern können abweichen):

pandas 3.0.5 numpy 2.5.3

Schritt 9: Starten Sie den Server neu

Starten Sie den Windows-Server neu.

mindzieStudio prüft bei Start, ob Python vorhanden ist, und muss die aktualisierte System-PATH sehen. Ein Neustart des Servers ist die zuverlässige Methode, dies sicherzustellen. Ein Recycling des mindzieStudio Application Pools reicht nicht aus.

Schritt 10: Überprüfen Sie Python in mindzieStudio

Überprüfen Sie das Enterprise Configuration Tool

1. Öffnen Sie das Enterprise Configuration Tool auf dem Server
2. Gehen Sie zum Tab Server Setup
3. Im Bereich Python zeigt Status Installed mit Ihrer Python-Version, z. B. Installed (3.13.15)

Führen Sie eine Test-Anreicherung aus

1. Öffnen Sie ein Projekt in mindzieStudio und gehen Sie zu einem Anreicherungs-Notebook
2. Fügen Sie einen Python Anreicherungsblock hinzu
3. Stellen Sie sicher, dass Python Image auf LOCAL gesetzt ist
4. Geben Sie folgenden Code ein. Fügen Sie für jedes weitere Paket, das Sie installiert haben, eine import-Zeile hinzu:

import pandas
import numpy

5. Berechnen Sie die Anreicherung. Sie wird ohne Python-Fehler abgeschlossen.

Spätere Paketinstallation

Um nach der Erstinstallation ein Paket hinzuzufügen, wiederholen Sie die gleichen Schritte nur mit dem neuen Paket:

1. Auf dem Computer mit Internetzugang fügen Sie das Paket zu requirements.txt hinzu und führen den Befehl aus Schritt 4 nochmals aus, mit derselben --python-version
2. Kopieren Sie den aktualisierten packages-Ordner und die requirements.txt auf den Server
3. Führen Sie auf dem Server den Befehl aus Schritt 8 erneut in einem PowerShell-Fenster mit Administratorrechten aus

Ein Neustart des Servers ist nach dem Hinzufügen von Paketen nicht erforderlich.

Fehlerbehebung

"Python executable 'python' was not found"

Symptom: Eine Python Anreicherung oder Python Script Aktion schlägt fehl mit:

Python executable 'python' was not found. Please ensure Python is installed and added to your system PATH environment variable.

Lösung:

1. Wiederholen Sie Schritt 7. where.exe python muss auf C:\Program Files\Python313\python.exe zeigen.
2. Wenn Python nur für Ihr Konto installiert wurde, installieren Sie es für alle Benutzer neu (Schritt 6).
3. Starten Sie den Server neu (Schritt 9).

"ModuleNotFoundError: No module named ..."

Symptom: Eine Python Anreicherung oder Python Script Aktion schlägt fehl mit ModuleNotFoundError: No module named 'openpyxl' (oder einem anderen Paketnamen).

Lösung:

1. Führen Sie in einem PowerShell-Fenster mit Administratorrechten python -m pip show openpyxl aus (verwendet den Paketnamen aus Schritt 3).
2. Wenn pip meldet Package(s) not found, ist das Paket nicht installiert. Laden Sie es herunter (Schritt 4), kopieren Sie es auf den Server, und installieren Sie es (Schritt 8).
3. Wenn die Zeile Location auf einen Ordner unter C:\Users\ zeigt, wurde das Paket ohne Administratorrechte installiert. Führen Sie python -m pip uninstall openpyxl aus und wiederholen Sie Schritt 8 als Administrator.

"No matching distribution found" beim Herunterladen

Symptom: Der Befehl aus Schritt 4 schlägt fehl mit ERROR: No matching distribution found for gefolgt von einem Paketnamen.

Lösung:

• Überprüfen Sie die Schreibweise. Verwenden Sie den Paketnamen, nicht den Importnamen (siehe Tabelle in Schritt 3).
• Wenn die Zeile eine Versionsnummer enthält, ist diese für Ihre Python-Version möglicherweise nicht verfügbar. Entfernen Sie die Versionsnummer oder wählen Sie eine neuere Version.
• Wenn Ihre requirements.txt von pip freeze stammt, löschen Sie jede Zeile mit @ file:. Diese Pakete wurden von lokalen Dateien installiert und können nicht heruntergeladen werden.

"Could not find a version that satisfies the requirement" auf dem Server

Symptom: Der Befehl aus Schritt 8 schlägt fehl mit Could not find a version that satisfies the requirement gefolgt von einem Paketnamen.

Lösung:

• Der packages-Ordner enthält dieses Paket nicht, oder die Dateien wurden für eine andere Python-Version heruntergeladen.
• Vergleichen Sie python --version auf dem Server mit dem cp-Teil der Dateinamen. Für Python 3.13 müssen die Dateien cp313 enthalten (Dateien, die mit py3-none-any.whl enden, funktionieren mit jeder Version).
• Laden Sie auf dem Computer mit Internetzugang erneut herunter, mit --python-version passend zum Server, und kopieren Sie den packages-Ordner erneut.

Python Image zeigt "Python not configured"

Symptom: Eine Python Anreicherung, Python Script Aktion oder AI Case Prediction Anreicherung zeigt Python not configured in der Einstellung Python Image.

Lösung: Anreicherungen und Aktionen, die vor der Python-Installation erstellt wurden, behalten diesen Wert. Ändern Sie Python Image auf LOCAL und berechnen Sie erneut.

Verwandte Dokumentation

• Python installieren - Python auf einem Server mit Internetzugang installieren
• Python Anreicherung - Benutzerdefinierte Datenumwandlungen mit Python
• Python Script Aktion - Automatisierte Ausführung von Python-Skripten
• AI Case Prediction - Vorhersagen mit maschinellem Lernen
• Technische Anforderungen - Serveranforderungen