Einrichten CNTK mit Skript auf Windows
Wenn Sie CNTK aus Quellcode erstellen möchten und das Entwicklerinstallationsskript verwenden möchten, ist diese Seite für Sie geeignet.
Wenn Sie nach einer anderen Unterstützung suchen, wenn Sie eine CNTK Buildumgebung einrichten oder CNTK auf Ihrem System installieren möchten, sollten Sie stattdessen hier gehen.
Für Ihre Erwägung
Nachfolgend finden Sie Empfehlungen, um sicherzustellen, dass Sie CNTK erfolgreich erstellen können:
- Das Systemschema auf dem Buildcomputer sollte auf eine Sprache mit einem "lateinischen" basierten Zeichensatz festgelegt werden.
- Vermeiden Sie extrem lange Pfadnamen. Die Buildprozedur verwendet Kopiervorgänge (XCOPY), die Probleme mit dem Pfadausdruck mit über 256 Zeichen in Länge ausführen können.
64-Bit-Betriebssystem
CNTK erfordert eine 64-Bit-Windows Installation. Wir haben den Buildprozess auf Windows 8.1, Windows 10 und Windows Server 2012 R2 und höher getestet. Andere Umgebungen werden nicht offiziell unterstützt. Bei Kompatibilitätsproblemen überprüfen Sie CNTK Produktionsbuild- und Testkonfiguration.
Vorbereitung
Es sind Schritte erforderlich, um eine CNTK Entwicklungsumgebung auf Ihrem Computer zu erstellen:
- Installation der erforderlichen Tools
- Visual Studio 2017
- NVIDIA CUDA 9.0
- Git
- Klonen des CNTK Quellcodes
- Ausführen des Entwicklerinstallationsskripts
- Festlegen von Befehlszeilenoptionen zum Konfigurieren des Skriptvorgangs
- Ausführen des Skripts
- Erstellen und Testen
Diese Seite führt Sie durch alle diese Schritte. Die skriptgesteuerte Installation erstellt eine Entwicklungsumgebung mit allen optionalen Komponenten, einschließlich NVIDIA-Tools, der Python-Umgebung, OpenCV und Komprimierungsbibliotheken. Das Skript unterstützt optionale Parameter, um die Installation auf Ihr System zu optimieren (z. B. das Anaconda-Installationsverzeichnis usw.), details sind hier verfügbar.
Installation der erforderlichen Tools
Visual Studio 2017
Installieren Sie Microsoft Visual Studio 2017 für Windows. Ein Link zum Download finden Sie hier. Sie benötigen ein Microsoft-Konto und entweder eine kostenlose Mitgliedschaft im Abonnement Visual Studio Dev Essentials oder ein gültiges MSDN-Abonnement. Wenn Sie kein Microsoft-Konto haben, wird ihnen die erforderliche Abonnementmitgliedschaft oder beides zur Registrierung angeboten.
Die Community Version von Visual Studio 2017 reicht aus, um CNTK zu erstellen.
Wählen Sie während des Installationsvorgangs "Universelle Windows-Plattform Entwicklung", ".NET-Desktopentwicklung", "Desktopentwicklung mit C++" und "Python-Entwicklung"-Workloads aus:
Stellen Sie auf dem Bildschirm der einzelnen Komponenten sicher, dass Sie "VC++ 2017 Version 15.4 v14.11 toolset" und "Visual C++-Laufzeit für UWP" zu Ihrer Installation hinzufügen:
Fügen Sie schließlich "Windows 10 SDK (10.0.16299.0) für Desktop C++ [x86 und x64]" hinzu:
Bereits vorhandene Visual Studio 2017-Installation
Sie müssen das Toolset "VC++ 2017 Version 15.4 v14.11", "Visual C++-Runtime für UWP" und "Windows 10 SDK (10.0.16299.0) für Desktop C++ [x86 und x64]" auf Ihrem System installiert haben. Um das Windows "Systemsteuerung -> Programme -> Programme und Features" zu überprüfen, und wählen Sie "Visual Studio Community 2017" aus der Liste der installierten Programme aus. Dadurch wird das Visual Studio Setup erneut gestartet und ermöglicht Es Ihnen, sicherzustellen, dass die oben genannten Komponenten auf Ihrem System installiert sind (siehe Abbildung oben).
Hinweis
Wenn VS2017INSTALLDIR die Umgebungsvariable vom Visual Studio Installer nicht festgelegt wurde, legen Sie sie manuell fest. Das genaue Installationsverzeichnis hängt von der Version (2017 in diesem Fall) und dem Angebot (Community, Enterprise usw.) von Visual Studio ab, entsprechend dem folgenden Muster: C:\Program Files (x86)\Microsoft Visual Studio\<version>\<offering>
Führen Sie für Visual Studio 2017 Enterprise Edition Folgendes aus:
setx VS2017INSTALLDIR "C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise"
Führen Sie für Visual Studio 2017 Community Edition Folgendes aus:
setx VS2017INSTALLDIR "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community"
NVIDIA CUDA 9
Wichtig
Wenn Sie eine erstmalige Visual Studio 2017-Installation wie oben beschrieben haben, müssen Sie NVIDIA CUDA 9 jetzt installieren, auch wenn Sie bereits eine vorhandene Installation von CUDA 9 haben! Die NVIDIA CUDA 9-Installation unterstützt die NVIDIA-Entwicklungstools zur Visual Studio Umgebung, die zum erfolgreichen Erstellen CNTK erforderlich ist.
CNTK wird auf den Build mit CUDA 9.0 festgelegt. Laden Sie das NVIDIA CUDA 9.0 Toolkit herunter und installieren Sie sie:
- Laden Sie das erforderliche Paket auf dieser Downloadseite herunter.
- Ausführen der Installationsprozedur
Hinweis: Wenn Sie kein System mit einer NVIDIA CUDA 9.0 kompatiblen Grafikkarte haben, gibt das CUDA-Installationsprogramm eine Warnung aus. Führen Sie das Installationsprogramm fort, wenn Sie diese Warnung erhalten, werden die CUDA-Tools installiert, und Sie können eine aktivierte NVIDIA-GPU-Version von CNTK auf Ihrem System erstellen.
Git
Git ist erforderlich, um die CNTK Codebasis zu klonen. Es stehen verschiedene Git-Clienttools zur Verfügung. Sie können auch direkt mit Git in Visual Studio arbeiten. Hier wird davon ausgegangen, dass Sie Git für Windows installiert haben. Wir gehen davon aus, dass Sie Git mithilfe der Standardoptionen im Git-Installationsprogramm installiert haben (Insbesondere "Git aus der Windows Befehlszeile verwenden" und mit der Option "Auschecken Windows-Format, Commit UNIX-Formatzeilenende" bei der aktivierten Eingabeaufforderung "Konfigurieren von Zeilenendes".
Klonen des CNTK Quellcodes
Wir erstellen einen Klon des CNTK Quellcodes im c:\repos\cntk. Wenn Sie einen anderen Speicherort bevorzugen, müssen Sie die Befehle entsprechend anpassen.
Öffnen sie eine Standard-Windows-Befehlsshell, und führen Sie diesen Befehl aus.
c: && md \repos && cd \repos
git clone --recursive https://github.com/Microsoft/cntk
cd cntk
Das Untermodul Multiverso wird verwendet, um DataParallelASGD für Schulungen zu aktivieren. Wenn Sie keine DataParallelASGD-Unterstützung benötigen, fügen Sie die Umgebungsvariable CNTK_ENABLE_ASGD hinzu, und legen Sie den Wert auf "false" fest. Führen Sie dies z. B. in einer CMD-Eingabeaufforderung aus, und öffnen Sie dann ihre CMD-Shell(n) und Visual Studio, um die Änderung aufzunehmen:
setx CNTK_ENABLE_ASGD false
Ausführen des Entwicklerinstallationsskripts
Das Entwicklerinstallationsskript (devInstall.ps1) ist ein PowerShell-Skript im Unterverzeichnis im tools Stammverzeichnis des CNTK-Repositorys. Es installiert alle erforderlichen und optionalen Tools, um CNTK auf Ihrem System zu erstellen. Außerdem werden die erforderlichen einstellungen für die lokale Benutzerumgebung erstellt. Nachdem das Skript gestartet wurde, ist keine zusätzliche Benutzereingabe erforderlich, obwohl Sie die Installation von Programmen oder die Erstellung von Umgebungsvariablen bestätigen müssen, je nach Einstellung "Benutzerkontensteuerung".
Konfigurationsoptionen
Standardmäßig sind keine zusätzlichen Optionen erforderlich, um das Installationsskript auszuführen. Es gibt verschiedene zusätzliche Optionen zum Anpassen der Skriptfunktionen an Ihre Anforderungen. Weitere Details sind hier.
Ausführen des Installationsskripts
Standardmäßig erlaubt PowerShell die Ausführung von Skripts nicht. So können Sie die Ausführung des Installationsskripts aus einem Standard-Windows Befehlsshell starten PowerShell durch:
start powershell -executionpolicy remotesigned
Angenommen, Sie haben den CNTK Quellcode in das Verzeichnis geklont, ändern Sie sich innerhalb der PowerShell-Sitzung in das c:\repos\cntk Verzeichnis mit dem Installationsskript innerhalb des geklonten CNTK-Repositorys und starten Sie das Installationsprogramm in diesem Verzeichnis:
cd C:\repos\cntk\Tools\devInstall\Windows
.\DevInstall.ps1
Das Skript überprüft Ihr System und bestimmt die Voraussetzungen, die fehlen. Sie werden über die vorgeschlagenen Installationsschritte benachrichtigt. Wenn Sie mit den vorgeschlagenen Änderungen zufrieden sind, können Sie mit der tatsächlichen Installation fortfahren. Weitere Informationen zu Befehlszeilenoptionen finden Sie hier.
Das Skript lädt erforderliche Komponenten aus dem Web herunter, daher ist eine Verbindung mit dem Internet erforderlich. Diese Komponenten werden ausgeführt, und gemäß der Einstellung von UAC (Benutzerkontensteuerung) auf Ihrem System werden Sie aufgefordert, die Ausführung und Installation dieser Komponenten zu bestätigen.
Je nach Geschwindigkeit Ihres Systems und Ihrer Internetverbindung kann der gesamte Prozess zwischen 20 und 30 Minuten dauern. Vor allem die Anaconda3-Installation ist sehr zeitaufwendig, ohne fortschrittsanzeigen, bitte patientenfrei sein. Die heruntergeladenen Dateien aus dem Internet werden im Verzeichnis c:\installCacheCntk zwischengespeichert und ermöglicht es Ihnen, das Installationsprogramm erneut auszuführen, ohne den Komponentendownload erneut zu durchlaufen. Wenn Sie probleme haben, können Sie das Installationsprogramm erneut starten, wird es nicht bereits erfolgreich installierte Komponenten neu installiert.
Hinweis: Wenn das Installationsprogramm unterbrochen wird, müssen Sie PowerShell möglicherweise neu starten, um die neuen Umgebungsvariablen zu verteilen.
Erstellen und Testen
An diesem Punkt werden alle erforderlichen Komponenten zum Erstellen von CNTK auf Ihrem System installiert. Sie können die hier gefundenen Schritte ausführen, um CNTK zu erstellen und zu testen.
Hinweis
Wenn Sie die CNTK Auswertungsbibliothek für Universelle Windows-Plattform (UWP) erstellen möchten, müssen Sie die weiteren Installationsschritte hier ausführen.
Neu in CNTK Version 2.1.