AMDAPPSDKv2.9InstallationNotes 1Overview TheMicrosoftWindowsinstallerisdeliveredasself-extractingexecutablefilesfor32-or64bitsystems.TheLinuxinstallerisdeliveredaspressedtararchivefor32-or64-bitsystems. TheAMDAPPSDKv2.9isprovidedtothemunitytoeleratetheprogramminginaheterogeneousenvironment.Thepackageconsistsofsamplesthatserveasexamplesforawideclassofdevelopersondifferentfacetsofheterogeneousprogramming. TheAMDAPPSDKpackagecontainstheruntimeforCPUhardwareonly.TheGPUruntimeisincludedintheCatalystdriver. ForMicrosoftWindowsplatforms,theAMDAPPSDKinstallerinstallsthefollowingpackagesonyoursystembydefault(unlessyouchoosetocustomizetheinstall):
1.AMDAPPSDKCPURuntimepackage.2.AMDAPPSDKDeveloperpackage.Thisincludes: –theOpenCLpiler,–pointerstothelatestversionsofthedeveloperdocumentation,includingtotheAMDMath Libraries.3.AMDAPPSDKSamplespackage.Thisincludes: –sampleapplications,–sampledocumentation. ForLinuxplatforms,theAMDAPPSDKconsistsofonepackage.Toensureproperinstallation,seeSection3.2,“OnLinuxSystems,”page4. TheAMDAPPSDKDeveloperinstallationincludesthefollowingfolders: bin-ThisincludestoolspilingOpenCLapplications,aswellastheOpenCLdynamic libraryforrunningthem. lib-ThiscontainsthebaseOpenCLCPUruntimelibrarytowhichtheapplicationslinkon Windowssystems. include-ThiscontainstheheaderfilesfortheOpenCLruntime.docs-ThiscontainsdeveloperdocumentationfortheAMDAPPSDK.Additionaldeveloper documentationisavailableonlineat:elerated-parallel-processing-app-sdk/documentation/ InstallationNotes 1of6 TheAMDAPPSDKCPUruntimeinstallationforWindowsaddsthevariableAMDAPPSDKROOTtoyourenvironment.ThispointstothelocationwhereyouhaveinstalledtheSDKdevelopmentpackage.TheWindowsinstalleralsoaddsthelocationsoftheOpenCLdynamiclibrariestoyoursystemPATHvariable,soapplicationsknowwheretofindit. TheAMDAPPSDKSamplesinstallationincludesthefollowingfolders: bin-Thisincludespre-builtbinariesanddynamiclibrariesforrunningAMDAPPsamples.lib-ThiscontainsAMDAPPSDKutilitylibrariestowhichsampleapplicationslink.include-Thiscontainstheheaderfilesforutilitiesandtoolsusedbythesamples.samples-ThiscontainssampleapplicationsforOpenCL,,C++AMP,Bolt,Aparapi,and OpenCV. TheAMDAPPSDKSamplesinstallerforWindowsaddsthevariableAMDAPPSDKROOTtoyourenvironment.ThispointstothelocationwhereCPUrun-timefilesareinstalled.Thesampleapplicationsareinstalledtothepathasspecifiedduringinstallationortothedefaultpath"C:\Users\\AMDAPPSDK\2.9". 2Prerequisites ToinstallandruntheAMDAPPSDKv2.9requiresthatyouhave: administrativeprivilegesonthesystem.oneofthefollowing: –Windows8.1 –Windows8 –Windows7 Forrunningthepre-builtsamples,theMicrosoftVisualStudio2012redistributablemustbeinstalled. Optionally(forbuildingtheMicrosoftVisualStudioprojects):MicrosoftVisualStudio2010orMicrosoftVisualStudio2012. BoltsamplesrequireMicrosoftVisualStudio2010orMicrosoftVisualStudio2012. BoltandOpenCVsamplesrequirepiledbinariesandrequiretheEnvironmentvariablepathtobeset.FordetailsaboutthesetupforBOLTandOpenCV,seetheAMDAPPSDKGettingStartedGuide. DirectXsamplesrequiretheinstallationoftheMicrosoftDirectXSDK(June2010).TheSDKcanbedownloadedfrom/en-us/download/details.aspx?
id=6812 C++AMPsamplesrequireMicrosoftVisualStudio2012. installedthelatestversionoftheAMDCatalystdriveronyoursysteminordertotake advantageoftheAMDGPU’scapabilitieswithOpenCL.ThesamplescanberunwithouttheCatalystdriver,inwhichcasetheywillrelyontheCPUruntime. Torunpre-builtBoltandC++Ampsamples,MicrosoftVisualStudio2012mustbeinstalledonthehostoperatingsystem. 2of6 InstallationNotes C++AmpsamplescanbebuiltandexecutedonlywithMicrosoftVisualStudio2012.BoltsamplescanbebuiltandexecutedwithMicrosoftVisualStudio2012andVisualStudio2010. 3InstallingtheSDK StartingwithAPPSDK2.9,multipleversionsofAPPSDKreleasescanco-exist.Installinganewversiondoesnotrequireuninstallingthepreviousversion. Theonlycaveat,however,isthattheAMDAPPSDKROOTenvironmentvariablewillpointtotheOpenCLruntimebinariesofthelatestreleaseinstalled.Ifsamplesfromthepreviousreleasesaretobeused,theymustpiledandvalidatedtobuildcorrectlywiththelatestruntimes.Ifissuesur,developerscanpointAMDAPPSDKROOTtotheearlierversionoftheOpenCLruntimeinorderpileandrunsamplesfrompreviousreleases. 3.1OnWindowsSystems Step1.ChoosetheAMDAPPSDKexecutableappropriateforyoursystem,anddouble-clickit. –For32-bitWindows8.1,Windows8,andWindows7SP1systems,chooseAMD-APP-SDK-v2.9.x.y-Windows-32.exe. –For64-bitWindows8.1,Windows8,andWindows7SP1systems,chooseAMD-APP-SDK-v2.9.x.y-Windows-64.exe. TheInstallShieldWizardscreenappears.Click"Next".TheEndUserLicenseAgreementappears.ClickeptandClick"Next". Step2.Thescreenletsyouchoosethetypeofinstallation.Completeinstallationinstallsthefollowingpackages: AMDAPPSDK2.9CPURuntime AMDAPPSDK2.9Developerpackages AMDAPPSDK2.9Samples CPURuntimeandDeveloperpackagesareinstalledtothedefaultlocation(AMDAPPSDKROOT)andSamplesareinstalledtothedefault("C:\Users\\AMDAPPSDK\2.9")location.CustominstallationinstallstheCPURuntimeandDeveloperpackagesandletsyouselectthetypeofsamplestoinstall.IfyouselectCustom,continuewithStep3.IfyouselectComplete,skiptoStep4. Step3. IntheCustominstallationwizard,developerscaneitherselectallthesamplesorpickandselectaspecificcategoryofsamplessuchasOpenCL,Bolt,C++AMP,APARAPIand/orOpenCV-CLsamples.Selectponent(s)youwanttoinstall,andclickNext. Step4.Click"install"andaprogressbarappears,followedbyaconfirmationscreenthattheinstallationplete.ClickFinishpletetheinstallation. WithSDK2.9orlater,clinfo.exeiscopiedunderC:\windows\system32\. ManuallySettingEnvironmentVariables Ifyourenvironmentvariablesecorrupted,ensurethepropersettingsforthefollowing. InstallationNotes 3of6 TheAMDAPPSDKROOTvariablemustbesetto: C:\ProgramFiles\AMDAPPSDK\2.9(for32-bitsystems)C:\ProgramFiles(x86)\AMDAPPSDK\2.9(for64-bitsystems) Ifthedefaultconfigurationwasnotused,modifythevaluetothelocationspecifiedduringtheinstallation. Thepathvariablemustinclude: $(AMDAPPSDKROOT)\bin\x86 (for32-bitsystems) $(AMDAPPSDKROOT)\bin\x86_64 (for64-bitsystems) 3.2OnLinuxSystems NotethattheLinuxOpenCLruntimeisintegratedwiththeCatalystLinuxdriver13.11betaV1orlater. YoumusthaverootpermissionstoinstallthisSDK.AlsonotethatthelatestversionoftheCatalystdrivermustbeinstalledseparately.
1.UntartheSDKtoalocationofyourchoice. For32-bitsystems,unzipthe.tgzfilebyenteringtar-xvzfAMD-APP-SDK-v2.9.x.y-lnx32.tgz.For64-bitsystems,unzipthe.tgzfilebyenteringtar-xvzfAMD-APP-SDK-v2.9.x.y-lnx64.tgz.2.Runsudo./Install-AMD-APP.sh.Notethatthispletesthefollowing: a.RegisterstheICD. b.Globallysetstheenvironmentalvariables.Theyarereflectedtoallusers.Itisnotnecessarytosetthelibrarypath.ItisnotnecessarytoexportAMDAPPSDKROOT.ItisnotnecessarytoexporttheLD_LIBRARY_PATH. c.InstallstheLinuxAPPSDKdeveloperandsamplefiles/binariesunder/opt/AMDAPP/.d.InstallstheLinuxAPPSDKCPUruntimefilesunder/opt/AMDAPP/lib. Notes: a.Iftheerror“pathnotfound”whileclearingthecacheisgeneratedonOpenSUSE/Ubuntu,ignoreit. b.Ifyouwanttoinstallunderadifferentpaththan/opt/AMDAPP,updatethedefault-install_lnx_32.plordefault-install_lnx_64.plfile,asappropriate,withthepathtothenewlocation. c.Tochangeorupdatetheenvironmentvariables: i.Openetc/profile;thenchecktheAMDAPPSDKROOTandLD_LIBRARY_PATHsettings.ii.Check/etc/ld.so.conf.d/amdapp_x86.confand /etc/ld.so.conf.d/amdapp_x86_64.conf. 4of6 InstallationNotes 4ModifyingandUninstallingAPPSDKComponents 4.1OnWindowsSystems StartingwithAPPSDK2.9,theinstallerallowsyoutomodifyorrepairanalready-installedAPPSDKsamplespackage. 4.1.1ModifyorRepairAPPSDKsamplesStep1.OntheWindowsStartmenu,goto"ControlPanel"->"ProgramsandFeatures".Step2.Select"AMDAPPSDK2.9",andclickUninstall.Step3.SelecttheModifyoptionandclickNext.Step4.Addand/orponentsasneeded.Step5.ClickNextpletetheinstallation. Thestepsforrepairingsamplesaresimilartothestepsmentionedabove.InStep3,selecttheRepairoptioninsteadoftheModifyoption. 4.1.2UninstallAPPSDKsamples ThisactionwillremovetheCPURuntime,Developerpackages,andSamplepackages. Step1.Step2.Step3.Step4. OntheWindowsStartmenu,goto"ControlPanel"->"ProgramsandFeatures".Select"AMDAPPSDK2.9"andclickUninstall.SelecttheUninstalloptionandclickNext.Completetheuninstallsteps. Note:TouninstallanypreviousAMDAPPSDKversion,followthestepsoutlinedintheAMDAPPSDKInstallationNotesguidecorrespondingtothatAMDAPPSDKversion. 4.2OnLinuxSystems
1.DeletethedirectorypointedtotheAMDAPPSDKROOTenvironmentvariable.2.RemovetheAMDAPPSDKROOTandLD_LIBRARY_PATHenvironmentvariables.3.Deletetheamdocl[32][64].sofrom/etc/OpenCL/vendors.4.ManuallyremovetemporaryandnewfilescreatedwithOpenCL. InstallationNotes 5of6 Contact 6of6 AdvancedMicroDevices,Inc.OneAMDPlaceP.O.Box3453Sunnyvale,CA,94088-3453Phone:+1.408.749.4000 ForAMDeleratedParallelProcessing: URL:Developing:Forum: /appsdk//openclforum ThecontentsofthisdocumentareprovidedinconnectionwithAdvancedMicroDevices,Inc.(“AMD”)products.AMDmakesnorepresentationsorwarrantieswithrespecttotheuracypletenessofthecontentsofthispublicationandreservestherighttomakechangestospecificationsandproductdescriptionsatanytimewithoutnotice.Theinformationcontainedhereinmaybeofapreliminaryoradvancenatureandissubjecttochangewithoutnotice.Nolicense,whetherexpress,implied,arisingbypelorotherwise,toanyintellectualpropertyrightsisgrantedbythispublication.ExceptassetforthinAMD’sStandardTermsandConditionsofSale,AMDassumesnoliabilitywhatsoever,anddisclaimsanyexpressorimpliedwarranty,relatingtoitsproductsincluding,butnotlimitedto,theimpliedwarrantyofmerchantability,fitnessforaparticularpurpose,orinfringementofanyintellectualpropertyright. InstallationNotes AMD’sproductsarenotdesigned,intended,authorizedorwarrantedforuseponentsinsystemsintendedforsurgicalimplantintothebody,orinotherapplicationsintendedtosupportorsustainlife,orinanyotherapplicationinwhichthefailureofAMD’sproductcouldcreateasituationwherepersonalinjury,death,orseverepropertyorenvironmentaldamagemayur.AMDreservestherighttodiscontinueormakechangestoitsproductsatanytimewithoutnotice.CopyrightandTrademarks©2013AdvancedMicroDevices,Inc.Allrightsreserved.AMD,theAMDArrowlogo,ATI,theATIlogo,Radeon,FireStream,binationsthereofaretrademarksofAdvancedMicroDevices,Inc.OpenCLandtheOpenCLlogoaretrademarksofAppleInc.usedbypermissionbyKhronos.Othernamesareforinformationalpurposesonlyandmaybetrademarksoftheirrespectiveowners.