BRIGHT-NET INSTALLATIE HANDLEIDING JOS VAN DER SANDEN VERSIE 0.10 29 DEC 2015
INHOUDSOPGAVE 1. Inleiding... 4 2. Server... 5 2.1 Installatie... 5 2.2 Configuratie... 9 2.3 Waarschuwingen... 9 2.4 Beschikbaarheid controleren... 10 3. Cliënt... 12 3.1 Uitvoeren op de PC... 12 3.2 Uitvoeren op de PDA... 12 3.3 Configuratie... 13 4. ODBC database... Fout! Bladwijzer niet gedefinieerd. 4.1 Instellen ODBC... Fout! Bladwijzer niet gedefinieerd. 4.2 BRIGHT-Net Agent... Fout! Bladwijzer niet gedefinieerd. BRIGHT-Net Versie 0.10-29 dec 2015 Pagina 2 van 21
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 BRIGHT-Net Versie 0.10-29 dec 2015 Pagina 3 van 21
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.10-29 dec 2015 Pagina 4 van 21
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 Voor de installatie van de server moeten de volgende stappen worden uitgevoerd. 1) Download de laatste BRIGHT-Net Server van http://download.bright-software.nl/bright-net/ 2) Pak het ZIP-Bestand uit 3) Voer BRIGHT-Net-Server-Setup.msi uit 4) Klik op Next > 5) Geef de locatie op voor BRIGHT-Net indien de BRIGHT folder niet op C:\ staat. 6) Klik op Next > 7) Klik op Next > 8) Vervolgens kan er tijdens de installatie, indien user-account-control aanstaat, de controlevraag komen. Klik op Ja. 9) Klik op Close Indien er gedurende de installatie foutmeldingen optreden zie dan de uitzonderingen die benoemd zijn verder in deze paragraaf. BRIGHT-Net Versie 0.10-29 dec 2015 Pagina 5 van 21
UITZONDERING:.NET FRAMEWORK INSTALLEREN MET SETUP.EXE Als bij het starten van de MSI-applicatie de onderstaande melding wordt getoond, kan het.net Framework worden geïnstalleerd met het bijgevoegde setup.exe bestand. Stappen: Doorloop de volgende stappen om de installatie uit te voeren d.m.v. het mee geleverde setup.exe bestand. Stap Omschrijving Schermafdruk 1 Klik op No 2 Start setup.exe 3 Klik op Accept 4 Vervolgens kan er, indien user-account-control aanstaat, de controlevraag komen. Klik op Ja BRIGHT-Net Versie 0.10-29 dec 2015 Pagina 6 van 21
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 6 Vink het veld voor dit onderdeel aan 7 Klik op Ok BRIGHT-Net Versie 0.10-29 dec 2015 Pagina 7 van 21
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.10-29 dec 2015 Pagina 8 van 21
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 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. BRIGHT-Net Versie 0.10-29 dec 2015 Pagina 9 van 21
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 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.10-29 dec 2015 Pagina 10 van 21
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. BRIGHT-Net Versie 0.10-29 dec 2015 Pagina 11 van 21
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.10-29 dec 2015 Pagina 12 van 21
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. BRIGHT-Net Versie 0.10-29 dec 2015 Pagina 13 van 21
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.10-29 dec 2015 Pagina 14 van 21
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.10-29 dec 2015 Pagina 15 van 21
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.10-29 dec 2015 Pagina 16 van 21
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.10-29 dec 2015 Pagina 17 van 21
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.10-29 dec 2015 Pagina 18 van 21
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.10-29 dec 2015 Pagina 19 van 21
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.10-29 dec 2015 Pagina 20 van 21
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.10-29 dec 2015 Pagina 21 van 21