CNTK instellen met script op Windows

Als u CNTK wilt bouwen vanuit de broncode en het script Developer Install wilt gebruiken, is deze pagina voor u.

Als u op zoek bent naar andere soorten ondersteuning bij het instellen van een CNTK build-omgeving of het installeren van CNTK op uw systeem, moet u hierheen gaan.

Voor uw overweging

Hier volgen aanbevelingen om ervoor te zorgen dat u CNTK kunt bouwen:

De landinstelling van het systeem op de buildcomputer moet worden ingesteld op een taal met een 'Latijnse' tekenset.
Vermijd extreem lange padnamen. De buildprocedure maakt gebruik van kopieerbewerkingen (XCOPY) die problemen kunnen ondervinden met padexpressie met meer dan 256 tekens.

64-bits besturingssysteem

CNTK moet een 64-bits Windows installeren. We hebben het buildproces getest op Windows 8.1, Windows 10 en Windows Server 2012 R2 en hoger. Andere omgevingen worden niet officieel ondersteund. Voor compatibiliteitsproblemen controleert u CNTK configuratie van productiebuild en -test.

Voorbereiding

Er zijn stappen vereist voor het maken van een CNTK ontwikkelomgeving op uw computer:

Installatie van vereiste hulpprogramma's
- Visual Studio 2017
- NVIDIA CUDA 9.0
- Git
- De CNTK broncode klonen
Het installatiescript voor ontwikkelaars uitvoeren
- Opdrachtregelopties instellen om scriptbewerking te configureren
- Het script uitvoeren
Bouwen en testen

Op deze pagina wordt u begeleid bij al deze stappen. De scriptgestuurde installatie maakt een ontwikkelomgeving met alle optionele onderdelen, waaronder NVIDIA-hulpprogramma's, de Python-omgeving, OpenCV- en compressiebibliotheken. Het script ondersteunt optionele parameters om de installatie af te stemmen op uw systeem (zoals de Installatiemap van Anaconda, enzovoort), hier vindt u meer informatie

Installatie van vereiste hulpprogramma's

Visual Studio 2017

Installeer Microsoft Visual Studio 2017 voor Windows. Hier vindt u een koppeling naar de download. U hebt een Microsoft-account nodig en een gratis lidmaatschap van het abonnement Visual Studio Dev Essentials of een geldig MSDN-abonnement. Als u geen Microsoft-account, het vereiste abonnementslidmaatschap of beide hebt, wordt u aangeboden om u in te schrijven.

De communityversie van Visual Studio 2017 is voldoende om CNTK te bouwen.

Selecteer tijdens het installatieproces 'Universeel Windows-platform ontwikkeling', '.NET Desktop development', 'Desktop development with C++' en 'Python development' workloads:

im1

Bovendien moet u op het scherm met afzonderlijke onderdelen 'VC++ 2017 versie 15.4 v14.11 toolset' en 'Visual C++ runtime voor UWP' toevoegen aan uw installatie:

im1

Voeg ten slotte 'Windows 10 SDK (10.0.16299.0) toe voor Desktop C++ [x86 en x64]':

im1

Bestaande Visual Studio 2017-installatie

U moet beschikken over de hulpprogrammaset 'VC++ 2017 versie 15.4 v14.11', 'Visual C++ runtime voor UWP' en 'Windows 10 SDK (10.0.16299.0) voor Desktop C++ [x86 en x64]' op uw systeem. Als u het Windows 'Configuratiescherm - Programma's -> Programma's -> Programma's en onderdelen' wilt controleren en 'Visual Studio Community 2017' wilt selecteren in de lijst met geïnstalleerde programma's. Hiermee start u de Visual Studio setup opnieuw en kunt u ervoor zorgen dat de bovengenoemde onderdelen op uw systeem zijn geïnstalleerd (zie de bovenstaande afbeelding).

Notitie

Als VS2017INSTALLDIR de omgevingsvariabele niet is ingesteld door het Visual Studio-installatieprogramma, stelt u deze handmatig in. De exacte installatiemap is afhankelijk van zowel de versie (2017 in dit geval) als het aanbieden (Community, Enterprise, enzovoort) van Visual Studio, volgens het volgende patroon: C:\Program Files (x86)\Microsoft Visual Studio\<version>\<offering>

Voer voor Visual Studio 2017 Enterprise Edition het volgende uit:

setx VS2017INSTALLDIR "C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise"

Voor Visual Studio Community-editie van 2017 voert u het volgende uit:

setx VS2017INSTALLDIR "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community"

NVIDIA CUDA 9

Belangrijk

Als u voor het eerst een Visual Studio 2017-installatie hebt zoals hierboven beschreven, moet u NVIDIA CUDA 9 nu installeren, zelfs als u al een bestaande installatie van CUDA 9 hebt! De installatie van NVIDIA CUDA 9 voegt ondersteuning toe aan de NVIDIA-ontwikkelhulpprogramma's aan de Visual Studio-omgeving, die nodig is om CNTK succesvol te bouwen.

CNTK is ingesteld op build met CUDA 9.0. Download en installeer de NVIDIA CUDA 9.0-Toolkit:

Het vereiste pakket downloaden van deze downloadpagina
De installatieprocedure uitvoeren

Opmerking: Als u geen systeem hebt met een NVIDIA CUDA 9.0-compatibele grafische kaart, geeft het CUDA-installatieprogramma een waarschuwing. Ga verder met het installatieprogramma als u deze waarschuwing ontvangt. De CUDA-hulpprogramma's worden geïnstalleerd en u kunt een nvidia GPU-versie van CNTK op uw systeem bouwen.

Git

Git is vereist om de CNTK codebasis te klonen. Er zijn verschillende Git-clienthulpprogramma's beschikbaar. U kunt ook rechtstreeks vanuit Visual Studio met Git werken. Hier gaan we ervan uit dat u Git hebt geïnstalleerd voor Windows. We gaan ervan uit dat u Git hebt geïnstalleerd met behulp van de standaardopties in het Git-installatieprogramma (met name 'Git gebruiken vanaf de Windows opdrachtprompt' en met de optie 'Uitchecken Windows stijl, doorvoeren UNIX-stijl regeleinden' bij de prompt Regeleinden configureren ingeschakeld.

De broncode van de CNTK klonen

We maken een kloon van de CNTK broncode in de c:\repos\cntk. Als u de voorkeur geeft aan een andere locatie, moet u de opdrachten dienovereenkomstig aanpassen.

Open een standaard Windows-opdrachtshell en voer deze opdracht uit

c: && md \repos && cd \repos
git clone --recursive https://github.com/Microsoft/cntk
cd cntk

De submodule Multiverso wordt gebruikt om DataParallelASGD in te schakelen voor training. Als u geen ondersteuning voor DataParallelASGD nodig hebt, voegt u de omgevingsvariabele CNTK_ENABLE_ASGD toe en stelt u de waarde ervan in op onwaar. Voer dit bijvoorbeeld uit in een CMD-prompt en open vervolgens uw CMD-shell(s) en Visual Studio opnieuw om de wijziging op te halen:

setx CNTK_ENABLE_ASGD false

Het installatiescript voor ontwikkelaars uitvoeren

Het installatiescript voor ontwikkelaars (devInstall.ps1) is een PowerShell-script in de tools submap in de hoofdmap van de CNTK-opslagplaats. Hiermee worden alle vereiste en optionele hulpprogramma's geïnstalleerd om CNTK op uw systeem te bouwen. Ook worden de vereiste omgevingsinstellingen voor de gebruiker gemaakt. Zodra het script is gestart, is er geen extra gebruikersinvoer nodig, hoewel u de installatie van programma's of het maken van omgevingsvariabelen moet bevestigen, afhankelijk van uw instelling 'Gebruikersaccountbeheer'.

Configuratie-opties

Standaard zijn er geen extra opties vereist om het installatiescript uit te voeren. Er zijn verschillende extra opties om de scriptfuncties aan te passen aan uw vereisten. Meer informatie vindt u hier.

Het installatiescript uitvoeren

Standaard staat PowerShell de uitvoering van scripts niet toe. PowerShell starten door het uitvoeren van het installatiescript vanuit een standaard Windows opdrachtshell toe te staan:

start powershell -executionpolicy remotesigned

Ervan uitgaande dat u de CNTK broncode in de c:\repos\cntk map hebt gekloond, wijzigt u in de PowerShell-sessie in de map met het installatiescript in de gekloonde CNTK opslagplaats en start u het installatieprogramma in die map:

cd C:\repos\cntk\Tools\devInstall\Windows
.\DevInstall.ps1

Het script inspecteert uw systeem en bepaalt de vereisten die ontbreken. U ontvangt een melding over de voorgestelde installatiestappen. Als u tevreden bent met de voorgestelde wijzigingen, kunt u doorgaan met de daadwerkelijke installatie. Zie hier voor meer informatie over opdrachtregelopties.

Het script downloadt de benodigde onderdelen van het web, dus er is een verbinding met internet vereist. Deze onderdelen worden uitgevoerd en volgens de instelling van UAC (User Account Control) op uw systeem wordt u gevraagd om de uitvoering en installatie van deze onderdelen te bevestigen.

Afhankelijk van de snelheid van uw systeem en uw internetverbinding kan het hele proces tussen 20 en 30 minuten duren. Vooral de Anaconda3-installatie is erg tijdrovend zonder enige voortgangsindicatie, wees geduldig. De gedownloade bestanden van internet worden in de cache opgeslagen in de map c:\installCacheCntk en u kunt het installatieprogramma opnieuw uitvoeren zonder het onderdeel opnieuw te downloaden. Als er problemen zijn met het opnieuw opstarten van het installatieprogramma, wordt het installatieprogramma niet opnieuw geïnstalleerd. Opmerking: Als het installatieprogramma wordt onderbroken, moet u PowerShell mogelijk opnieuw opstarten om de nieuwe omgevingsvariabelen door te geven.

Bouwen en testen

Op dit moment worden alle vereiste onderdelen voor het bouwen van CNTK op uw systeem geïnstalleerd. U kunt de hier gevonden stappen volgen om CNTK te bouwen en te testen.