BRIGHT-NET INSTALLATIE HANDLEIDING JOS VAN DER SANDEN VERSIE 0.13 3 JAN 2017
INHOUDSOPGAVE 1. Inleiding... 4 2. Server... 5 2.1 Installatie... 5 2.2 Configuratie... 8 2.3 Waarschuwingen... 9 2.4 Beschikbaarheid controleren... 9 3. Cliënt... 13 3.1 Uitvoeren op de PC... 13 3.2 Uitvoeren op de PDA... 13 3.3 Configuratie... 14 3.1 NETWERK INSTELLING OP PDA / MC75 / MC91... 14 4. Agent... 15 4.1 Login... 15 4.2 Diagnose... 16 4.3 Menu... 16 4.4 Monitor... 17 4.5 Client... 17 4.6 Instellingen... 18 4.7 About... 22 BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 2 van 22
REVISIES Hier vind u een overzicht van de versies en de wijzigingen die hierin zijn doorgevoerd. Versie Status Datum Door Wijzigingen 0.1 Concept 30 December 2010 Jos van der Sanden 1 e opzet 0.2 Concept 23 Augustus 2011 Jos van der Sanden Handleiding vervangen door installatie v2.x 0.3 Concept 7 September 2011 Jos van der Sanden Uitgebreid met: - Firewall configuratie - PDA test - SP1 voor.net Framework 3.5 vereist 0.4 Concept 13 september 2011 Jos van der Sanden Active Sync 4.5 internet probleem, zie tip bij handheld test 0.5 Concept 15 december 2011 Jos van der Sanden Aan paragraaf 3.1 ook toegevoegd dat cerdisp gekopieerd moet worden naar BRIGHT\bs_tools 0.6 Concept 25 april 2013 Hennie Bruurs Aan paragraaf 2.4 Tip AVG toegevoegd 0.7 Concept 12 maart 2015 Maartje Woestenberg Bij test vanaf handheld versie 2 en 3 toegevoegd 0.8 Concept 24 november 2015 Jos van der Sanden Installatie beschrijving aangepast (msi/exe) 0.9 Concept 4 december 2015 Ruud Vriens Toevoegen van database koppeling 0.10 Concept 29 december 2015 Jos van der Sanden Agent volledig uitgeschreven 0.11 Concept 23 maart 2015 Jos van der Sanden Agent aanpassingen bijgewerkt 0.12 Concept 13 dec 2016 Jos van der Sanden BSNET-21 Onverwachte fout bij starten 0.13 Concept 3 jan 2016 Jos van der Sanden BSNET-22 Service verbeterd voor.net 4 + Starten verbeterd BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 3 van 22
1. INLEIDING Dit document bevat informatie m.b.t. de installatie van BRIGHT-Net voor zowel de PDA als de server installatie. Indien er tijdens installatie bijzonderheden voorkomen, gelieve dit dan op te nemen in dit document zodat altijd de laatste gegevens m.b.t. de installatie bekend zijn over hoe specifieke problemen zijn opgelost. Dit document is gebaseerd op versie 2.x van BRIGHT-Net. BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 4 van 22
2. SERVER De server is de applicatie die op het systeem wordt geïnstalleerd waar de cliënt applicatie mee communiceert om bij voorbeeld een bestand te versturen of te ontvangen. Dit hoofdstuk bevat de installatie en eventuele uitzonderingen op de standaard installatie. 2.1 INSTALLATIE Om BRIGHT-Net te installeren dien je de BRIGHT-Support applicatie op de PC te hebben geïnstalleerd. Voor meer informatie zie de documentatie van BRIGHT-Support in Evernote. ADMINISTRATOR MODUS Zorg ervoor dat je de applicatie start in Administrator modus. Klik bovenin de balk op de knop Administrator mode indien de knop getoond wordt. De applicatie herstart nu, daarna is de knop niet meer zichtbaar. BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 5 van 22
INSTALL Als eerst geef je de folder op binnen de groep BRIGHT-Net waar de installatie van BRIGHT-Net geplaatst moet worden. Klik vervolgens op Download. Nadat de download voltooid is, kun je d.m.v. de knop Install de nieuwe versie van BRIGHT-Net op het systeem installeren. UITZONDERING:.NET FRAMEWORK INSTALLEREN WINDOWS ONDERDELEN Als tijdens het uitvoeren van setup.exe de een van de onderstaande meldingen komt, kan het.net Framework worden geïnstalleerd d.m.v. Windows onderdelen. Stappen voor desktop systeem: Doorloop de volgende stappen om de installatie uit te voeren d.m.v. het mee geleverde setup.exe bestand en de installatie wordt uitgevoerd op een standaard PC (geen server). Stap Omschrijving Schermafdruk 1 Klik op Start 2 Ga naar Configuratiescherm 3 Klik op Programma`s of Programma`s en onderdelen 4 Klik op Windows-onderdelen in- of uitschakelen 5 Zoek naar Microsoft.NET Framework 3.5.1 BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 6 van 22
6 Vink het veld voor dit onderdeel aan 7 Klik op Ok Stappen voor server systeem: Doorloop de volgende stappen om de installatie uit te voeren d.m.v. het mee geleverde setup.exe bestand en de installatie wordt uitgevoerd op een server installatie. Stap Omschrijving Schermafdruk 1 Klik op Start 2 Ga naar Configuratiescherm 3 Klik op Programma`s of Programma`s en onderdelen 4 Klik op Windows-onderdelen in- of uitschakelen 5 Ga naar links in de lijst naar Onderdelen 6 Klik op Onderdelen toevoegen rechts in het overzicht. 7 Zoek naar Microsoft.NET Framework 3.5.1 8 Vink het veld voor dit onderdeel aan BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 7 van 22
9 Klik bij de controle vraag op de knop Vereiste functies toevoegen. 10 Klik op Volgende 11 Klik op Volgende 12 Klik op Volgende 13 Klik op Installeren 2.2 CONFIGURATIE Nadat BRIGHT-Net geïnstalleerd is, dienen handmatig nog enkele dingen geconfigureerd te worden. FIREWALL Controleer binnen Windows of er een Firewall is ingeschakeld. Indien de Firewall aan staat dient u een extra poort toe te voegen aan de uitzonderingen. Dit probleem doet zich voornamelijk voor bij systemen ouder dan Windows 7. 1) Klik op Start 2) Klik op Configuratiescherm 3) Open Windows Firewall 4) Ga naar tabblad Uitzonderingen 5) Druk op Poort toevoegen 6) Geef de naam BRIGHT-Net op 7) Voer poortnummer 5001 in 8) Laat protocol op TCP staan 9) Klik op OK BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 8 van 22
BRIGHT-SUPPORT Binnen het tabblad Desktop vind je de groep System port (Windows Firewall). Met deze functie kun je een poort openzetten of controleren of deze open staat in de Windows Firewall. 2.3 WAARSCHUWINGEN De volgende problemen kunnen ontstaan indien niet wordt voldaan aan de correcte installatie. Let op! U dient het systeem te voorzien van het.net Framework 3.5 waarbij tevens SP1 voor.net Framework 3.5 geïnstalleerd is. Indien de SP1 niet geïnstalleerd is, kan er geen verbinding gemaakt worden met de host vanuit zowel de Agent als de Monitor. 2.4 BESCHIKBAARHEID CONTROLEREN Nu de installatie volledig is afgerond kan gecontroleerd worden of de service ook daadwerkelijk beschikbaar is. Dit kan op twee manieren. BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 9 van 22
BRIGHT-NET AGENT Een eenvoudige methode is het starten van BRIGHT-Net Agent. Deze cliënt maakt verbinding met de service. 1) Klik op Start 2) Klik op Alle programma`s 3) Klik op BRIGHT-Software B.V. 4) Klik op BRIGHT-Net-Agent 5) Laat de instellingen standaard staan en klik op Connect 6) Nu zie je het scherm rechts, dat betekend dat agent verbonden is met de service. Zo niet krijg je een foutmelding. INTERNET EXPLORER Een andere optie is door het openen van een web pagina. 1) Open Internet Explorer 2) Versie 2: Ga naar http://localhost:5001/io waarbij localhost vervangen kan worden door het IP adres van het systeem Versie 3: Ga naar http://localhost:5001 waarbij localhost vervangen kan worden door het IP adres van het systeem 3) Nu ziet u de pagina zoals rechts weergegeven Nog drie andere services die ook benaderbaar moeten zijn: - http://localhost:5001/basic/monitor - http://localhost:5001/basic/about - http://localhost:5001/basic/setup Tip! Controleer of er een teamviewer service draait. Stop deze allemaal en controleer of de pagina nu wel beschikbaar is. Deze service levert ook wel eens problemen op. Tip! Als je geen verbinding krijgt via http://localhost:5001/io stop AVG virus scanner. Service BRIGHT-NET stoppen en weer starten. Testen of het nu wel werkt. AVG kan weer gestart worden en natuurlijk weer testen of het werkt. BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 10 van 22
TEST VANAF HANDHELD Voer de Internet Explorer test ook uit op de handheld zelf. Echter gebruik daarbij i.p.v. localhost in de URL de host ppp_peer. 1) Open Internet Explorer op de Handheld 2) Versie 2: Ga naar http://ppp_peer:5001/io of ga vervang ppp_peer door het IP adres van de host Versie 3: Ga naar http://ppp_peer:5001/ of ga vervang ppp_peer door het IP adres van de host 3) Nu ziet u de pagina zoals rechts weergegeven Tip! Indien het internet niet werkt op de PDA en u gebruik maakt van Active Sync 4.5 dan dient op het systeem in het register een DWORD met de naam AllowLSP te worden aangemaakt onder HKEY_LOCAL_MACHINE\Software\Microsoft\Windows CE Services. De waarde van AllowLSP moet 0 zijn. Tip! Zet de poort in de firewall altijd open, het kan namelijk zijn dat een scanner wel verbinding kan maken en een andere scanner niet op het zelfde systeem. Dit is eerder ondervonden bij één van onze klanten. Tip! Ga op het mobiele apparaat naar Menu > Settings > Connections > Connections. Kies vervolgens voor tabblad Advanced en dan de knop Select networks. Zorg ervoor dat hier bij de twee keuzelijsten beide gekozen is voor My Work Network wanneer er verbinding gemaakt wordt met een PC in het lokale netwerk. BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 11 van 22
TEST VANAF PC (BRIGHT-SUPPORT) De diagnostic van BRIGHT-Net kun je starten vanaf de BRIGHT-Support tool. Ga naar het tabblad Mobile en voer de volgende gegevens in bij het blok Device execute. Path: Arguments: /BRIGHT/Tools/BRIGHT-Net/BRIGHT-Net-Client-IR.exe "192.168.1.17" "5001" "diagnostic" BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 12 van 22
3. CLIËNT Voor de installatie van BRIGHT-Net Cliënt zijn enkele bestanden meer vereist. 3.1 UITVOEREN OP DE PC De onderstaande stappen dienen uitgevoerd te worden op de PC om de bestanden klaar te zetten voor installatie op de PDA. 1) Ga opnieuw naar http://download.bright-software.nl/bright-net/ 2) Download de onderstaande bestanden: a. BRIGHT-Net IenR Client (laatste versie) b..net Compact Framework (afhankelijk van OS op PDA) c..net Compact Framework Messages (afhankelijk van OS op PDA) 3) Pak de twee ZIP-Bestanden van.net Compact Framework uit zodat je twee CAB-Bestanden hebt 4) Maak op de PDA in de root de map de volgende mappen structuur aan: a. BRIGHT i. bs_tools b. BRIGHT-Download i. BRIGHT-NET 5) Kopieer cerdisp.exe naar de map \BRIGHT\bs_tools op de PDA 6) Kopieer de CAB-Bestanden naar de map \BRIGHT-Download\BRIGHT-Net\ op de PDA a. BRIGHT-Net-Client-IenR-Setup-v2.0.1.cab (of een andere versie) b. NETCFv35.wm.armv4i.cab (of een andere versie) c. NETCFv35.Messages.EN.wm.cab (of een andere versie) 3.2 UITVOEREN OP DE PDA Alle onderstaande stappen dienen te worden uitgevoerd op de PDA zelf. 1) Open de verkenner op de PDA (doormiddel van start > programma`s) 2) Ga naar de map BRIGHT-Download in de root van het apparaat 3) Open de map BRIGHT-Net 4) Installeer alle CAB bestanden in de onderstaande volgorde a. NETCFv35.wm.armv4i.cab (of een andere versie) b. NETCFv35.Messages.EN.wm.cab (of een andere versie) c. BRIGHT-Net-Client-IenR-Setup-v2.0.1.cab (of een andere versie) Voor de installaties kan overal de standaard locatie worden gebruikt. Binnen de BRIGHT-Net Client is de locatie statisch bepaald en komen de bestanden ten aller tijde terecht in \BRIGHT\Tools\BRIGHT-Net\. BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 13 van 22
3.3 CONFIGURATIE De configuratie dient te worden uitgevoerd in de applicatie die gebruik maakt van de BRIGHT-Net Cliënt. Hierin dient het juiste IP adres te zijn geconfigureerd. Indien er geen server IP adres bekend is (voor bijvoorbeeld lokaal gebruik) gebruik dan het IP adres 000.000.000.000. 3.1 NETWERK INSTELLINGEN OP DE PDA / MC75 / MC91 Deze moeten op MY ISP staan! Voor de communicatie met 000.000.000.000 of ook wel PPP_PEER moet de instelling bij intern netwerk op My Work Network staan. Voor communicatie met externe partijen moet de instelling op My ISP staan. BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 14 van 22
4. AGENT De agent is een front-end beheer paneel voor het gebruik van de BRIGHT-Net service. Deze kan ook vanaf een extern systeem verbinding maken met de service. Houd er echter dan wel rekening mee dat bij het plaatsen van instellingen als folders je de folders moet gebruiken op de server en niet de lokale paden. 4.1 LOGIN Hier dient een adres en poortnummer opgegeven te worden. De verbinding wordt vervolgens opgebouwd (de controle op SSL of geen SSL wordt beide getest door de connector zelf). Door op de knop achter het poort veld te klikken gaat de gebruiker naar een diagnose scherm waarbij verschillende gegeven zichtbaar zijn. Zie Diagnose. BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 15 van 22
4.2 DIAGNOSE Op dit scherm zijn verschillende gegevens zichtbaar welke handig kunnen zijn voor de controle op de service. Titel Service beschikbaar Firewall beschikbaar Version 01 Version 02 Version 03 Ok Als de service in de lijst van Windows-Service staat en is en draait gestart is. Als de firewall beschikbaar is (niet uitgeschakeld) en poort [port] open staat Als de service beschikbaar is op http://[ip]:[port]/service (client v1 werkt niet op SSL) Als de service beschikbaar is op http://[ip]:[port]/io (client v2 werkt niet op SSL) Als de service beschikbaar is op http://[ip]:[port]/ of https://[ip]:[port]/ 4.3 MENU Vanuit het menu kunnen de verschillende functies van de agent worden gebruikt. Voor de werking achter de schermen zie de betreffende functies. BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 16 van 22
4.4 MONITOR De monitor geeft weer wat voor acties er op de BRIGHT-Net service voor het laatst zijn uitgevoerd. Daarbij kan de monitor ook rechtstreeks benaderd worden door het argument /monitor te gebruiken bij het opstarten van de agent. Deze snelkoppeling wordt standaard al toegevoegd aan het startmenu. Deze aanvragen zijn enkel zichtbaar van de periode dat de BRIGHT-Net service actief is. Dit betekend dat deze dus niet meer beschikbaar zijn na het herstarten van de BRIGHT-Net service. 4.5 CLIENT In dit scherm wordt getoond welke BRIGHT-Net clients er allemaal verbonden zijn geweest met deze BRIGHT- Net service. Deze worden tevens opgeslagen op het systeem en dus bewaard bij het herstarten van de applicatie. BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 17 van 22
4.6 INSTELLINGEN Door naar instellingen te gaan komt de gebruiker in een tweede menu. Zie de toelichting van de verschillende functies bij het betreffende scherm. ALGEMEEN Hier kunnen de algemene instellingen van de service worden toegepast. Daarbij gaat het om de communicatie om de instelling op welke poort de service draait en of deze op SSL moet werken. Let op! Voor het gebruik van SSL moeten alle BRIGHT-Net client applicaties van versie 3 of hoger zijn. Tevens kan hier het loggen aangezet worden waardoor alle request en response bestanden van de webservice bewaard worden. Dit kan wel zorgen voor een grote hoeveelheid aan bestanden, zorg er daarom voor dat deze functie op tijd wordt uitgeschakeld. BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 18 van 22
PRINTERS Met deze functie kun je printers definiëren die gebruikt kunnen worden vanaf de BRIGHT-Net clients. Vanaf o.a. de versnijderij applicatie kan deze lijst van printers worden geraadpleegd en tevens print opdrachten worden verzonden naar deze printers. Met de test functie kun je een test sjabloon naar één van de ingestelde printers sturen. BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 19 van 22
SJABLONEN Hier kunnen de verschillende print sjablonen worden gedefinieerd waarbij de opgegeven argumenten vanaf de client binnen de service worden vervangen in het sjabloon en vervolgens naar de opgegeven printer verzonden. WEEGSCHAAL Met deze functie kunnen de weegschalen worden beheerd. Zoals voor de printers geld ook voor de weegschalen dat deze beschikbaar zijn vanaf o.a. de versnijderij applicatie. Daarbij kan de client het gewicht opvragen van de betreffende weegschaal. BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 20 van 22
ODBC Afhankelijk van 64 of 32 bit versie van BRIGHT-Net moet hiervoor de overeenkomstige odbc worden geconfigureerd. Standaard wordt BRIGHT-Net op 64bit uitgevoerd indien de machine ook 64bit is. Start ODBC gegevensbronbeheer en ga naar tabblad system-dsn. Voeg de betreffende koppeling toe. BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 21 van 22
4.7 ABOUT Met deze functie kan bekeken worden welke versie van de BRIGHT-Net server (Service) en BRIGHT-Net agent geïnstalleerd zijn. BRIGHT-Net Versie 0.13-3 jan 2017 Pagina 22 van 22