Niagara4InstallationGuide March3,2021 TechnicalDocument 816-347-3500 sales@lynxspring.com 2900 NE Independence Ave Lee's Summit, MO 64064NNiiaaggaarraa44IInnssttaallllaattiioonnGGuuiiddee TTrriiddiiuumm,,IInncc.. 3951WesterreParkway,Suite350 Richmond,Virginia23233 U.S.A. CCoonnffiiddeennttiiaalliittyy TheinformationcontainedinthisdocumentisconfidentialinformationofTridium,Inc.,aDelaware corporation(“Tridium”).Suchinformationandthesoftwaredescribedherein,isfurnishedunderalicense agreementandmaybeusedonlyinaccordancewiththatagreement. TheinformationcontainedinthisdocumentisprovidedsolelyforusebyTridiumemployees,licensees,and systemowners;and,exceptaspermittedunderthebelowcopyrightnotice,isnottobereleasedto,or reproducedfor,anyoneelse. Whileeveryefforthasbeenmadetoassuretheaccuracyofthisdocument,Tridiumisnotresponsiblefor damagesofanykind,includingwithoutlimitationconsequentialdamages,arisingfromtheapplicationofthe informationcontainedherein.Informationandspecificationspublishedherearecurrentasofthedateofthis publicationandaresubjecttochangewithoutnotice.Thelatestproductspecificationscanbefoundby contactingourcorporateheadquarters,Richmond,Virginia. TTrraaddeemmaarrkknnoottiiccee BACnetandASHRAEareregisteredtrademarksofAmericanSocietyofHeating,RefrigeratingandAir- ConditioningEngineers.Microsoft,Excel,InternetExplorer,Windows,WindowsVista,WindowsServer,and SQLServerareregisteredtrademarksofMicrosoftCorporation.OracleandJavaareregisteredtrademarks ofOracleand/oritsaffiliates.MozillaandFirefoxaretrademarksoftheMozillaFoundation.Echelon,LON, LonMark,LonTalk,andLonWorksareregisteredtrademarksofEchelonCorporation.Tridium,JACE, NiagaraFramework,andSedonaFrameworkareregisteredtrademarks,andWorkbencharetrademarksof TridiumInc.Allotherproductnamesandservicesmentionedinthispublicationthatareknowntobe trademarks,registeredtrademarks,orservicemarksarethepropertyoftheirrespectiveowners. CCooppyyrriigghhttaannddppaatteennttnnoottiiccee ThisdocumentmaybecopiedbypartieswhoareauthorizedtodistributeTridiumproductsinconnection withdistributionofthoseproducts,subjecttothecontractsthatauthorizesuchdistribution.Itmaynot otherwise,inwholeorinpart,becopied,photocopied,reproduced,translated,orreducedtoanyelectronic mediumormachine-readableformwithoutpriorwrittenconsentfromTridium,Inc. Copyright©2021Tridium,Inc.Allrightsreserved. Theproduct(s)describedhereinmaybecoveredbyoneormoreU.S.orforeignpatentsofTridium.CCoonntteennttss AboutthisGuide.................................................................................................5 Documentchangelog................................................................................5 Relateddocumentation..............................................................................6 Chapter1Niagara4Installation.......................................................................7 QuickStart.................................................................................................7 PCplatformhardwarerequirements............................................................7 SupportedOSandothersoftware...............................................................8 Licenserequirement.................................................................................11 32-bitvs.64-bitinstallations......................................................................11 Determininginstallationversion(32-bitor64-bit).............................12 Chapter2Commontasks................................................................................13 Downloadingthelatestbuild....................................................................13 InstallingNiagara4..................................................................................13 Runningtheinstallationprogram....................................................14 Confirmthelicense........................................................................18 GettingstartedinWorkbench...................................................................19 Desktopshortcutsandtiles............................................................19 Filelocations..................................................................................21 Performinga“clean”installation...............................................................22 Uninstalling..............................................................................................22 Chapter3Frequentlyaskedquestions...........................................................23 Niagara4FAQs........................................................................................23 GeneralFAQs..........................................................................................24 Glossary............................................................................................................25 March3,20213ContentsNiagara4InstallationGuide 4March3,2021AAbboouutttthhiissGGuuiiddee Thistopiccontainsimportantinformationaboutthepurpose,content,context,andintendedaudiencefor thisdocument. PPrroodduuccttDDooccuummeennttaattiioonn ThisdocumentispartoftheNiagaratechnicaldocumentationlibrary.ReleasedversionsofNiagarasoftware includeacompletecollectionoftechnicalinformationthatisprovidedinbothonlinehelpandPDFformat. TheinformationinthisdocumentiswrittenprimarilyforSystemsIntegrators.Tomakethemostoftheinfor- mationinthisbook,readersshouldhavesometrainingorpreviousexperiencewithNiagarasoftware,aswell asexperienceworkingwithJACEnetworkcontrollers. DDooccuummeennttCCoonntteenntt ThisguideprovidesessentialinstructionsonhowtoinstallNiagara4software. Topicsinthisdocumentincludeinformationonsystemandlicenserequirementsandhowtogetstartedwith Workbench.TopicsalsoincludedescriptionsoftheNiagara4directorystructureandNiagarahomes. DDooccuummeennttcchhaannggeelloogg Changestothisdocumentarelistedinthistopic. MMaarrcchh33,,22002211 Correctiontothesupportedrelationaldatabasestableinthetopic,“Supportedoperatingsystemsandoth- ersoftware”. OOccttoobbeerr66,,22002200 Updatedthetopic,“Supportedoperatingsystemsandothersoftware”,forNiagara4.10. AAuugguusstt77,,22002200 •Updatedinstallationtopicstoexplainthatthe32–bitinstallerisavailableonlyforversionsNiagara4.7 andearlier. •AddedinformationaboutextendingtheLonUSBadaptercapabilityto64–bitoperatingsystemenviron- mentsinNiagara4.9. MMaarrcchh3300,,22002200 Editedthetopic,“Supportedoperatingsystemsandothersoftware”,toupdateitthroughNiagara4.9. AAuugguusstt66,,22001199 Editedthetopic,“Supportedoperatingsystemsandothersoftware”,toupdateitthroughNiagara4.8. NNoovveemmbbeerr22,,22001188 •Editedthetopic,“Supportedoperatingsystemsandothersoftware”,toupdateitthroughNiagara4.7. •Addedacautionarynotetothetopic,“32-bitvs.64-bitinstallations.” FFeebbrruuaarryy2266,,22001188 Intheprocedure,“Runningtheinstallationprogram”,addedacautionarynoteontheimportanceofhaving separatelocationsfortheDaemonUserHomeandtheWorkbenchUserHome. OOccttoobbeerr2200,,22001177 RemovedcontentaddedinSeptember19,2017update. March3,20215Niagara4InstallationGuide SSeepptteemmbbeerr1199,,22001177 Inthetopic“Settingthesystempassphrase”addedinformationaboutnewdefaultpassphrasebehaviorand wizardinNiagara4.4. JJuullyy3311,,22001177 Inthetopic,“Runningtheinstallationprogram,”updatedthenoteonclearingbrowsercache.IntheChap- ter,“Commontasks,”addedanewtopicnamed“SelectingtheDaemonUserHomelocation”. AApprriill33,,22001177 Inthetopic,“Operatingsystemrequirements,”updatedthetableofsupportedwebbrowsersfor Niagara4.3. JJaannuuaarryy99,,22001177 Inthetopic,“Operatingsystemrequirements,”minorchangestothetableofsupportedwebbrowsers. JJuullyy2200,,22001166 Minorchangesthroughouttosupportbranding.Edited“Finishinginstalloptions”topic,addednotedescrib- ingchangeforNiagara4.2. NNoovveemmbbeerr55,,22001155 Edited“Operatingsystemrequirements”and“Finishinginstalloptions”topicstoincludechangesfor Niagara4.1. AAuugguusstt1100,,22001155 Initialrelease. RReellaatteeddddooccuummeennttaattiioonn AdditionalinformationaboutNiagaraplatforms,installationandoperationWorkbenchisavailableinthefol- lowingdocuments. •NiagaraPlatformGuide •GettingStartedwithNiagara March3,20216March3,20217 CChhaapptteerr11NNiiaaggaarraa44IInnssttaallllaattiioonn Topicscoveredinthischapter ♦QuickStart ♦PCplatformhardwarerequirements ♦SupportedOSandothersoftware ♦Licenserequirement ♦32-bitvs.64-bitinstallations Thetopicsinthissectionincludeashortquickstarttaskaswellashardware,licensing,andoperatingsystem requirementsforinstallation. BeforeinitiatingNiagara4installation,verifythatyoucanmeetallhardwareandsoftwarerequirements describedinthissection. QQuuiicckkSSttaarrtt Thisisaquicksummaryofinstallation;seethefollowingsectionsformoredetailedinformation. MMiinniimmuummpprreerreeqquuiissiitteess •IntelPentiumCore2Duo(32-bitor64-bit),2GHz •2GBRAM •2GBHDD •Ethernet100Mbitor1GbitNIC •Validlicense •Internetaccessforlicenseconfirmation Step1Downloadthelatestbuild. Step2Runtheappropriate(32–bitor64–bit)Installerandfollowtheinstallationwizardstepstodefine therequestedinformation,suchas: •Installationlocation. •Installationoptionsincludingtheinstallationofstartmenuanddesktopshortcuts,andtiles. •Finishinstalloptions,includingwhethertolaunchWorkbenchafterinstallationandloadthe startplatformdaemon. NNOOTTEE::Formoreinformationoninstallertype,refertothesectionon32-bitvs.64-bitinstallations. Step3LaunchWorkbenchandconfirmlicense. PPCCppllaattffoorrmmhhaarrddwwaarreerreeqquuiirreemmeennttss TheNiagaraFramework®requiresanadequateprocessor,harddisk,memoryandspeedtoruncomplex buildingmodels. Theminimumhardwarerequirementsinclude: •Processor:IntelPentiumCore2Duo,2GHz •RAMMemory:2GB,with8GBrecommendedifa64-bitinstallation •Harddrivespace:2GBavailable,10GBrecommendedforanySupervisor •Ethernet100Mbitor1GbitNIC(networkinterfacecard)withTCP/IPsupportChapter1Niagara4InstallationNiagara4InstallationGuide •Internetaccessforconfirmingyourlicense. Asamulti-threadingJavaapplication,theNiagaraFramework®cantakeadvantageoftheaddedpower availableinmulti-coreprocessors.Aprocessorthatgoesbeyondminimumrequirements,suchasthecurrent IntelCorei3,i5,i7orAMDA6,A8,A10seriesprocessors,canprovideperformancebenefits. SSuuppppoorrtteeddOOSSaannddootthheerrssooffttwwaarree TheInstallerprogramsupports“Professional”,“Enterprise“,and“Ultimate”leveloperatingsystems(OS)as showninthefollowingtable. SSuuppppoorrtteeddOOppeerraattiinnggSSyysstteemmss OOppeerraattiinnggSSyysstteemmssNNiiaaggaarraa44..44NNiiaaggaarraa44..66NNiiaaggaarraa44..77NNiiaaggaarraa44..88NNiiaaggaarraa44..99NNiiaaggaarraa44..1100 RedHatEnterpriseLinux7 (64-bit) NoNoNoNoNoNo RedHatEnterpriseLinux 7.4(64-bit) YesNoNoNoNoNo RedHatEnterpriseLinux 7.5(64-bit) NoYesYesYesNoNo RedHatEnterpriseLinux 7.7/8.1(64-bit) NoNoNoNoYesYes WindowsServer2008R2 Standard/Enterprise,SP2 (64-bit) NoNoNoNoNoNo WindowsServer2012 Standard/Enterprise,SP2 (64-bit) NoNoNoNoNoNo WindowsServer2012R2 Standard/Enterprise,SP2 (64-bit) YesYesYesNoNoNo WindowsServer2016 YesYesYesYesYesYes WindowsServer2019NoNoNoNoYesYes WindowsServer2019Serv- erCore NoNoNoNoNoNo Windows7Professional/En- terprise/Ultimate (32-bit/64-bit) YesNoYesYesNoNo Windows8Professional/En- terprise/Ultimate (32-bit/64-bit) NoNoNoNoNoNo Windows8.1Professional/ Enterprise/Ultimate(32-bit) YesYesYesYesNoNo Windows8.1Professional/ Enterprise/Ultimate(64-bit) YesYesYesYesNoNo Windows10(32-bit) YesNoNoNoNoNo Windows10(64-bit) YesYesYesYesYesYes VMware-ESXi5.1.0YesYesYesNoNoNo VMware-ESXi5.5NoNoNoYesNoNo VMware-ESXi6.0NoNoNoYes update 5224934 NoNo 8March3,2021Niagara4InstallationGuideChapter1Niagara4Installation OOppeerraattiinnggSSyysstteemmssNNiiaaggaarraa44..44NNiiaaggaarraa44..66NNiiaaggaarraa44..77NNiiaaggaarraa44..88NNiiaaggaarraa44..99NNiiaaggaarraa44..1100 VMware-ESXi6.7NoNoNoNoYes update 5224934 Yes VMware-Server2NoNoNoNo MicrosoftVirtualServer 2008 NoNoNoNoNoNo Hyper-V6.1NoNoNoNoNoNo Hyper-Vversion10.0YesNoNoNoNoNo MicrosoftServer2012Hy- per-V NoYesNoNoNoNo NNOOTTEE::ToinstallNiagaraonaWindowshost,youmustbeloggedintoWindowsasauserwithadministra- torprivileges. JJaavvaassooffttwwaarree TheJavaSERuntimeEnvironment(JRE)8(1.8.0.241.0.1)mustbeinstalledonanyclientPCthatwillaccess thestationwithabrowserandWorkbenchwebprofile.Thefreedownloadisavailableat:java.com/en/ AfterinstallingJRE8,ensurethattheJavapluginforanyearlierversionsisdisabled: 1.UndertheWindowsSSttaarrttmenu,clickAAllllPPrrooggrraammss→→JJaavvaa→→CCoonnffiigguurreeJJaavvaa→→VViieeww. NNOOTTEE::IftheVViieewwbuttonappearsdisabled,thenonlyoneJREversionisinstalled.ClickingJJaavvaa→→AAbboouutt JJaavvaa(undertheWindowsStartmenu)showsinstalledversion(s). 2.ConfirmthatonlytheJRE1.8pluginisenabled,asshownhere.Foranyversionotherthan1.8,clickthe checkboxintheEEnnaabblleeddcolumntodeselect. SSuuppppoorrtteeddwweebbbbrroowwsseerrss UsealateversionHTML5–capablewebbrowser,suchasthoseshowninthefollowingtable. March3,20219Next >