Enterprise Installation

Transcription

1 Enterprise Installatin Mnnit Crpratin Versin

2 Cntents Prerequisites... 3 Web Server... 3 SQL Server... 3 Installatin... 4 Activatin Key... 4 Dwnlad... 4 Cnfiguratin Wizard... 4 Activatin... 4 Create Gateway Service... 6 Website Cnfiguratin... 6 Database Cnfiguratin... 7 SMTP Cnfiguratin... 8 Autmated and Gateway Cnfiguratin... 9 Firewall Rule Cnfiguratin Wireless Gateway Server Test System Setup First Lgin Accunts Management Adding Gateways and Sensrs Other manual cnfiguratin ptins Trubleshting errr in website Server Errr in '/' Applicatin IIS Cnfiguratin Errrs... 14

3 Prerequisites Web Server Install / Enable IIS 7 Server OS (ex: server 2008) Lk inside Server Manager, Add Rll Web Server (IIS) When Adding the This Rle Make sure t add ASP.NET Desktp OS (ex: Windws 7) - Lk fr turn windws features n r ff under Prgram and features under cntrl panel and then pen Internet infrmatin services. Check web management tls and WWW services. Under www services check all under Applicatin dev features. See belw. When yu hit OK it will start t recnfigure the PC and must rebt. Yu may als get an errr message saying, Nt all changes were made. If this ccurs, the changes will be applied after rebting. Install ASP.NET MVC4 frm the Web Platfrm Installer. Dwnlad frm here: Install an instance f Micrsft.Net framewrk 4.5. Dwnlad frm here: Nte: Fllw these steps in rder t ensure the smthest installatin pssible. SQL Server Install an instance f SQL Server (2005 r later) Fr small implementatins (single r few netwrks) Express is sufficient: Dwnlad and install Service Packs as needed During installatin make sure that yu use mixed authenticatin mde Create lgin credentials that can be used by the applicatin t access the database SQL Express default server is (the cmputer name)\sqlexpress During setup yu must select either SQL Authenticatin r Mixed Mde Authenticatin (Windws Authenticatin and SQL Authenticatin) Yu can use the default administrative accunt sa r create a secndary user and assign permissins t that user. Make sure yu use a strng passwrd (i.e. at least 8 characters, letters, numbers, and special characters.) Yu can use SQL Server Management Studi t check and manage user permissins. Nte: SQL Server Management Studi 2012 requires Micrsft.net 3.5 service pack 1, in Server 2008 yu need t g t server manager --> Features --> click add Feature and add.net If yu are unfamiliar with managing SQL Server yu may need t cntract the aid f a database administratr t assist with the setup and cnfiguratin f the database and applicatin.

4 Installatin Activatin Key An activatin key is needed t cmplete the installatin. Yu can purchase an activatin key thrugh the Mnnit web stre ( r by cntacting yur sales representative. During the installatin the activatin is dne nline autmatically. This des require temprary internet access fr the cmputer where the installatin is being dne. After yu receive yur activatin key keep it in a safe lcatin! The key will nly allw fr activatin f a single cmputer. Hwever, if yu ever need t re-install the sftware yu can use the same key n the same cmputer. Dwnlad Start by dwnlading imnnit Enterprise installatin files, available fr dwnlad here: Run the installer by duble-clicking it. The installer will add the needed files t yur hard drive. Multiple applicatins will be installed t enable the imnnit Enterprise system t run prperly. There is a step by step cnfiguratin wizard which will guide yu thrugh cnfiguring each f the applicatins. When the installer is finished yu will have a new icn n yur desktp t launch the cnfiguratin wizard. Cnfiguratin Wizard Activatin This is where yu will enter yur Activatin Key fr authenticatin. If yur server is nt cnnected t the Internet, yu will need t use the manual activatin prcess. Shwn in the Manual Offline Activatin under the trubleshting sectin.

5 Manual Offline Activatin Fllw these steps t cmplete yur activatin if the cmputer yu are installing n cannt be given temprary access t the internet fr autmatic activatin. After entering yur Activatin Key, if the cnfiguratin sftware is nt able t cmmunicate t the internet, it will display the required frm values fr yu t use t cmplete activatin manually. Using a web brwser n an internet cnnected device navigate t: Enter the Manual Tken int the frm and press OK. Enter the Manual Key that is generated int the enterprise cnfiguratin tl t cmplete manual activatin.

6 Create Gateway Service This is the server applicatin that Mnnit enabled gateways cmmunicate with. When yu click create yu will see a cmmand windw cme up and disappear. When this finishes yu can then click next t cntinue. Website Cnfiguratin The website is the user prtal yu will use t view and cnfigure Mnnit sensrs. This website will run in Micrsft Internet Infrmatin Services (IIS). IIS shuld have already been enabled as a prerequisite t installatin. Enter the infrmatin fr IIS t be able t create yur persnal website experience. This step creates the website flder, applicatin bindings, and the hsting site.

7 Physical Path - This field is where yu will be string the website flder. This field als cnfigures IIS t where the flder is lcated. IP Address This field is the first f three binding fields. By default this field is set t use all unassigned IP addresses, which means all requests t that server will land at that site. If yu are using the same server fr multiple websites yu may need t cnfigure different IP Addresses. Prt This field is the secnd f three binding fields. By default this field is set t use prt 80, which means all requests t prt 80 n the server s IP address will bring up the site. Hst Name This field is the last f the three binding fields. By default this field is set t be blank. If left blank, IIS will rute all traffic t the cnfigured IP Address and prt t this website. Optinally, yu can cnfigure the hst name s that nly requests with this hst are ruted t the imnnit Enterprise web applicatin. This ptin allws IIS t hst multiple sites n a single IP Address. Database Cnfiguratin Enter the infrmatin t cmmunicate with yur SQL Server Instance. Befre leaving this step yu will have tested cmmunicatin with the database t ensure credentials are prperly cnfigured. Database Server and instance name This field is the server where yur database is lcated. If yu are using an instance name (default with SQL Server Express) the instance name will be included here als. Server can be either a DNS Reslvable hst r an IP Address f the cmputer. Example: COMPUTERNAME/SQLSERVEREXPRESS Database Name This will be the name f the database. If yu are upgrading and have an existing database make sure this name matches. If yu are installing fr the first time, the name entered here will be the name f the database that is created. User Name User authenticated t the database server fr selected database. Passwrd Passwrd fr user t gain access t database.

8 SMTP Cnfiguratin This step creates a cnnectin t yur SMTP server, s that the applicatin can send ntificatins. This infrmatin can pint t an server, a SMTP frwarder, r a transactinal service. SMTP Hst - This field is the address f yur SMTP server i.e. Prt - This field is the prt that yur SMTP server uses. User - This field is the admin accunt that will be used t send ntificatins i.e. username@hstname.cm. Passwrd - This field is fr the passwrd t the accunt which will be used t send ntificatins. Use SSL - This field determines if yur SMTP server uses SSL r nt. Frm Address - This field is the address that will be sending ut the ntificatins. This field can be different frm the User field. Frm Name - This field is used as the name f the cmpany r the name f the persn sending the ntificatin. Return Path - This field is typically the same as the user t negate spam issues with ther SMTP servers.

9 Autmated and Gateway Cnfiguratin This step determines the type f Ntificatins which will be sent, what prt the Gateway Service shuld be using, and if any inbund packets frm all gateways r a specific gateway shuld be lgged in the database. Send Inactivity Ntificatins - This field allws fr inactivity ntificatins t be sent. Send Subscriptin Ntificatins - This field allws fr subscriptin ntificatins t be sent. Send Maintenance Ntificatins - This field allws fr maintenance ntificatins t be sent. Address T Listen On - This field tells the gateway service which prt t listen n fr gateways t send infrmatin. Default is Any: Inbund Packet Retentin- This field determines if any gateway messages are stred in the database fr trubleshting.

10 Firewall Rule Cnfiguratin This step creates an inbund firewall rule in Windws Firewall fr bth TCP and UDP. If yu have additinal firewalls yu will need t als create rules fr traffic cming frm the gateways t the server. Inbund Prt - This field needs t be the same prt used fr Address t Listen On. Wireless Gateway Server Test This step tests if gateways will be able t speak t the database using the gateway service. Because this is run frm the same cmputer as the service is running, it will bypass any firewalls. Hst Address - This field, by default, uses the specific servers NIC Card s IP Address if the test is successful the installatin is cmplete.

11 System Setup First Lgin Navigate in yur brwser t the web applicatin yu created in IIS. The credentials that are set when yu first install the database are: Administrative Accunt Username: Admin Passwrd: passwrd *The Administrative accunt will be used fr adding Accunts/Subaccunt, adding Users, handling permissins, and making changes at the Accunt level. Yu will nt want t add yur Netwrks, Sensrs, and Gateways t this Accunt. Enterprise User Accunt Username: EnterpriseUser Passwrd: passwrd *The EnterpriseUser accunt is where yu will want t add yur Netwrks, Sensrs, and Gateways. It is recmmended yu change the Accunt Name t smething mre apprpriate t yur cmpany. Yu can rename this accunt by visiting the Accunt Settings and clicking the Edit Accunt Infrmatin buttn. T change the name f the user, yu will need t edit the user name. After lgging in the first time, the system will prmpt yu t agree t the End User License Agreement (EULA), n yur secnd lgin, it will prmpt yu t change the passwrd. Accunts Management See included Administratin Guide pdf fr infrmatin n managing multiple accunts. Adding Gateways and Sensrs Enterprise has the ability fr the server t dwnlad the required metadata f the sensrs and gateways frm a central nline repsitry, using the Sensr and Gateway IDs and Cdes. This is nly available if the server hsting the web applicatin has access t the Internet. Adding gateways and sensrs t the database is dne in the same manner as mving them between netwrks after they are in the database. Frm the Manage screen chse Add Gateway/Add Sensr and yu will be prmpted fr the Gateway ID/Sensr ID and Cde. These values are fund n the ID labels affixed t the Mnnit Gateways and Sensrs. As server administratr there is an area available nly t yu, which prvides a methd f adding gateways and sensrs t the database manually. This prcess shuld nly be dne if the server is unable t dwnlad the infrmatin frm the central nline database. G t the accunt and netwrk where yu wuld like t add the device. Under Netwrk Details in the Administratin area yu will

12 find the links t manually add gateways and sensrs. This area als allws yu t quickly mve gateways and sensrs between yur different accunt/netwrks. If it is necessary t manually add the devices int the database yu can lk up the crrect metadata frm the imnnit nline prtal. Using a web brwser navigate t: Enter the sensr r gateway id and check-cde int the frm and the required metadata will be retrieved. Use this infrmatin t cmplete the frm Add new Sensr t ppulate the database fr yur users. Once the sensr has been entered int the database users will be able t mve them between accunts using the device id and cde fund n the device labels. T add a new gateway int the database Select Add New Gateway. Enter the gateway ID frm the sticker n the gateway Name the gateway Chse the crrect gateway type Select the crrect radi band (Management use nly) Enter the crrect APN Firmware Versin (Management use nly) Enter the crrect Gateway Firmware Versin (Management use nly) MAC Address is (nt required) can be entered if yu lk it up n yur netwrk. Press Create T add a sensr. Click Add New Sensr Select the crrect Sensr Prfile (It is critical t peratin that this infrmatin is entered crrectly) Enter the sensr ID frm the bttm f the sensr Name the sensr Chse the crrect type f sensr Cmmercial Cmmercial (AA) Industrial Wi-Fi Enter the firmware versin Select the pwer surce Cmmercial (CR2032)

13 Cmmercial (AA) Line Pwer Vltage Industrial (Tadiran) Industrial Slar (Ind Rech) Custm (AAA) Custm (CR123) Wi-Fi (AA) Other manual cnfiguratin ptins T extend the sessin time ut, add this in the website cnfiguratin file. <sessinstate timeut="60" /> (The number 60 is the number f minutes f inactivity befre the user is lgged ut) Trubleshting 404 errr in website If yu are getting a 404 errr when pening the applicatin in yur brwser, it may be that the.net framewrk isn t registered in IIS. T register r re-register the.net framewrk with IIS, pen a cmmand prmpt as administratr and run the fllwing cmmands: cd \ cd Windws\Micrsft.NET\Framewrk\v4.xxx.xxx aspnet_regiis -i Replace the xxx with the exact versin f the framewrk installed n yur server. Server Errr in '/' Applicatin If while trying t lg in t yur new versin f enterprise yu cme acrss an errr n yur page that says Server Errr in '/' Applicatin. Culd nt lad type 'System.ServiceMdel.Activiatin.HttpMdule' Make sure the applicatin pl in IIS 7 is set t Framewrk 4.X with integrated pipeline mde If Prblem persists re-register the.net framewrk with IIS T register r re-register the.net framewrk with IIS, pen a cmmand prmpt as administratr and run the fllwing cmmands: cd \ cd Windws\Micrsft.NET\Framewrk\v4.xxx.xxx aspnet_regiis /iru Replacing the xxx with the exact versin f the framewrk installed n yur server.

14 IIS Cnfiguratin Errrs If yu are getting an errr f "This access cntrl list is nt in cannical frm and therefre cannt be mdified." Yu mst likely d nt have permissins t write t the flder yu have chsen t save yur website files t. There are tw fixes fr this issue. The first, using File Explrer Navigate t the flder yu chse fr website installatin. Right click n the flder, click prperties, click the security tab and add yur user t the permissins list. This will rerder the Security list and fix the issue The Secnd, chse a different lcatin t stre the website flder and files. That yu knw yu have access t.