Installatie AdSystems Web Urentool Inleiding Met de AdSystems Web Urentool kan iedereen via een webbrowser (bijv. Safari, Internet Explorer, Firefox, enz.) de uren boeken, ook vanaf een ipad. Dat kan binnen het eigen netwerk (intranet), maar ook vanaf elke willekeurige locatie via het internet. De AdSystems Web Urentool maakt gebruik van een eigen webserver, dus een webserver zoals bijv. Apache, IIS (Internet Information Services), enz. is niet nodig. Dit vereenvoudigt de installatie aanzienlijk en de kans op aanvallen van buitenaf is nihil! De AdSystems Uren Webserver moet worden geïnstalleerd op 1 machine met Windows, die in de lucht blijft. Logisch, want anders kunnen de mensen hun uren via hun webbrowser niet boeken. De webserver draait prima onder Windows XP / Vista / 7 / 2003 / 2008 en verbruikt weinig geheugen. De webserver moet in het netwerk toegang hebben tot de PROGRAMMA en DATA map van het AdSystems Reclame! pakket, want er is een "live" verbinding met de database van de orders, werksoorten, personen, enz. Hieronder een aantal voorbeelden van een aantal mogelijke configuraties: Windows Server: Heb je een server met bijv. Windows 2003 / 2008, installeer dan de urentool rechtstreeks op deze server. In deze installatiehandleiding wordt als voorbeeld Windows Server 2008 R2 behandeld. Wil je dat niet, gebruik dan 1 werkstation met Windows dat als webserver voor de urentool gaat dienen. Apple Server: Heb je een Apple Server, dan kun je overwegen om op deze server een virtuele machine (bijv. VMware Fusion) te installeren met bijv. Windows 7, waaronder de webserver voor de urentool gaat draaien. Wil je dat niet, gebruik dan 1 werkstation met Windows dat als webserver voor de urentool gaat dienen. (Dat kan ook een Intel Mac met een virtuele machine (bijv. VMware Fusion) zijn.) NAS Server: Heb je een NAS Server (waarop vaak Linux draait), gebruik dan 1 werkstation met Windows dat als webserver voor de urentool gaat dienen. Het volgende is dus belangrijk: De AdSystems Uren Webserver moet op 1 machine met Windows draaien, die in de lucht blijft wanneer de mensen hun uren boeken via hun webbrowser. De AdSystems Uren Webserver moet in het netwerk toegang hebben tot de PROGRAMMA en DATA map van het AdSystems Reclame! pakket. Het installatieprogramma vereist "Administrator" rechten. Echter, het draaien van de AdSystems Uren Webserver kan met een "Standard user" account, die ingelogd moet zijn. (Het is niet mogelijk om de AdSystems Uren Webserver als een "service" te draaien.) Bepaal eerst welke machine als webserver voor de urentool gaat dienen en ga dan pas verder met de installatie. Installatie AdSystems Web Urentool Pagina 1 van 15
Installatie Voer de installatie uit op de machine die als webserver voor de urentool gaat dienen. (Het installatieprogramma vereist "Administrator" rechten.) Controleer vanaf deze machine waar de PROGRAMMA en DATA map van het AdSystems Reclame! pakket staan. Dit is vaak...\adsyswin\prog en...\adsyswin\data01. Indien je vanaf deze machine het AdSystems Reclame! pakket kan opstarten, dan kun je de locatie van deze mappen terugvinden onder "? - Locatie van het programma". Installatie AdSystems Web Urentool Pagina 2 van 15
Als de locatie van de PROGRAMMA en DATA mappen bekend zijn, start dan het installatieprogramma op: SetupAdSystemsWebUrentool.exe Klik op Volgende. Geef hier de locatie van de PROGRAMMA map op. Via Bladeren... kun je eventueel bladeren naar de juiste locatie. Klik daarna op Volgende. Installatie AdSystems Web Urentool Pagina 3 van 15
Geef hier de locatie van de DATA map op. Via Bladeren... kun je eventueel bladeren naar de juiste locatie. Klik daarna op Volgende. LET OP! Het is belangrijk dat de AdSystems Uren Webserver altijd in de lucht is, want alleen dan is het mogelijk om uren via het web te boeken! Laat de webserver dus automatisch opstarten. Dit gebeurt alleen als via de desbetreffende gebruiker wordt ingelogd. Het draaien van de AdSystems Uren Webserver kan met een "Standard user" account, die ingelogd moet zijn. (Dit wordt verderop uitgelegd.) Ons advies is om het vinkje aan te zetten. Klik op Volgende. Installatie AdSystems Web Urentool Pagina 4 van 15
Controleer de instellingen goed. Als alles goed is, klik op Volgende, waarna de installatie begint. Klik op Klaar. Het logbestand van de installatie kan eventueel bekeken worden en staat in:...\adsyswin\prog\aduren\aduren_install_log.txt Installatie AdSystems Web Urentool Pagina 5 van 15
Op het bureaublad van de machine die als webserver dient staat een mapje "AdSystems Uren". Met de snelkoppeling "AdSystems Uren Webserver" kan de webserver handmatig worden opgestart. De webserver wordt normaal automatisch opgestart wanneer de gebruiker (van de installatie!) onder Windows inlogt op voorwaarde dat tijdens de installatie voor deze optie is gekozen. Echter, het draaien van de webserver kan ook met een "Standard user" (i.p.v. "Administrator") account, die ingelogd moet zijn (zie volgende pagina). Installatie AdSystems Web Urentool Pagina 6 van 15
De webserver wordt normaal automatisch opgestart wanneer de gebruiker (van de installatie!) onder Windows inlogt op voorwaarde dat tijdens de installatie voor deze optie is gekozen. Het installatieprogramma heeft dan in het Startup (Opstarten) menu een snelkoppeling toegevoegd om de webserver automatisch op te starten. Het draaien van de webserver kan ook met een "Standard user" (i.p.v. "Administrator") account, die ingelogd moet zijn. Verplaats hiervoor de snelkoppeling in het Startup (Opstarten) menu van het "Administrator" account naar het "Standard user" account. Wanneer de AdSystems Uren Webserver wordt opgestart, verschijnt hier heel even een melding van. Tevens nestelt zich rechts onderin het AdSystems icoontje van de webserver. (Bij meerdere administraties heb je voor elke administratie een eigen AdSystems icoontje met een uniek poortnummer.) Installatie AdSystems Web Urentool Pagina 7 van 15
Met de snelkoppeling "AdSystems Urentool (lokaal)" kun je op de machine die als webserver dient, lokaal testen of de urentool via de webbrowser werkt. Hierbij wordt het adreshttp://127.0.0.1:8080 gebruikt. ":8080" Staat voor het poortnummer waarnaar de webserver standaard "luistert". Dit kan verderop eventueel worden aangepast. Installatie AdSystems Web Urentool Pagina 8 van 15
Instellingen AdSystems Uren Webserver Om de instellingen van de webserver te bekijken, klik op het AdSystems icoontje rechts onderin. In de titelbalk staat "AdSystems Urenverantwoording" met daarnaast een versiedatum en tussen haakjes de naam van de administratie van het AdSystems Reclame! pakket. Bij de eigenschappen van de snelkoppeling van de webserver staat in dit geval bij "Beginnen in:" de verwijzing naar de map C:\ADSYSWIN\DATA01. De DATA01 map bevat in dit geval de administratie van "AdSystems BV". Het is eventueel mogelijk om meerdere snelkoppelingen naar meerdere administraties te hebben. Bij de eigenschappen van elke snelkoppeling moet bij "Beginnen in:" worden verwezen naar de desbetreffende DATAxx map. Hierbij is het zeer belangrijk dat de webserver van elke administratie naar een uniek poortnummer "luistert", bijv.: Administratie X staat in de DATA01 map en luistert naar poortnummer 8080 Via de webbrowser:http://ip_nummer_webserver:8080 Administratie Y staat in de DATA02 map en luistert naar poortnummer 8081 Via de webbrowser:http://ip_nummer_webserver:8081 (De instellingen van de webserver worden per administratie (per DATAxx map) weggeschreven in ADUREN.INI.) Het tabblad Log toont informatie over de "requests" (verzoeken) die door de urenboekers worden gedaan. Via de webbrowser van de urenboekers wordt een verzoek afgevuurd op de webserver. De webserver verwerkt dit verzoek en stuurt de verzochte informatie terug in de vorm van een "response" (reactie). Om de webserver weer rechts onderin te krijgen, gebruik niet de knop Close (want daarmee wordt de webserver volledig afgesloten!), maar gebruik het minimaliseerknopje: Installatie AdSystems Web Urentool Pagina 9 van 15
Het tabblad Settings toont een aantal instellingen: Port: Dit is het poortnummer waarnaar de webserver "luistert". Om via een webbrowser verbinding te kunnen maken met de urentool, gebruik als adres: http://ip_nummer_webserver:poortnummer bijv. http://192.168.0.185:8080 Let op dat als je poortnummer 80 (of 443 = SSL) wilt gebruiken, dat er dan geen andere webserver actief is op deze poortnummers. Let op dat er bij meerdere administraties een uniek poortnummer per administratie (DATAxx map) wordt gebruikt! Use SSL: Indien aangevinkt wordt er een versleutelde verbinding gebruikt (https). Om via een webbrowser een versleutelde verbinding te kunnen maken met de urentool, gebruik als adres: https://ip_nummer_webserver:poortnummer bijv. https://192.168.0.185:8080 Ons advies is om in de opstartfase nog geen gebruik te maken van SSL, omdat hiervoor certificaten nodig zijn die aangeschaft moeten worden bij een zgn. "Certificate Authority", bijv.: https://www.globessl.com/ssl-certificates,globe-standard-ssl.htm Standaard (puur om te testen) leveren wij een door onszelf gesigneerd certificaat mee (settings.crt en settings.key). Dit resulteert uiteraard in een certificaatfout in de webbrowser, maar wanneer je klikt om door te gaan, kun je toch verder via een versleutelde verbinding. De overige SSL instellingen zijn standaard niet aanpasbaar. Neem hiervoor eventueel contact op met AdSystems. Session Expiry (1-999 minutes): Hiermee kun je instellen na hoeveel minuten van inactiviteit (door de urenboekers) de webserver de verbinding moet beëindigen met de webbrowser van de urenboekers. Standaard is dit ingesteld op 12 uur (720 minuten). Stel dit niet te laag in, want het is heel irritant als je iedere keer opnieuw moet inloggen in de urentool. Vervolgens wordt er in het kader "Webserver" nog enige informatie over de machine van de webserver getoond. Installatie AdSystems Web Urentool Pagina 10 van 15
Het tabblad IP Info toont het IP adres van de machine waarop de webserver draait. In een intranet kunnen de mensen via hun webbrowser de urentool opstarten via het adres: http(s)://ip_nummer_webserver:poortnummer bijv. http(s)://192.168.0.185:8080 Het is handig om hiervoor een snelkoppeling aan te maken. Verderop wordt besproken hoe je vanaf elke willekeurige locatie via het internet de urentool kan benaderen. Soms lukt het niet om via een webbrowser verbinding te krijgen met de webserver van de urentool. In dit geval moet op de machine waarop de webserver draait de firewall worden ingesteld dat de webserver (ADUREN.exe) wordt toegestaan. Het is belangrijk dat er in ieder geval een vinkje aanstaat bij "Home/Work (Private)". Het installatieprogramma probeert dit in te stellen, maar dat lukt soms niet vanwege beveiligingsinstellingen. Installatie AdSystems Web Urentool Pagina 11 van 15
Voorbeeld In een intranet, verbinding gemaakt met de urentool vanaf een pc met als webbrowser Firefox. Installatie AdSystems Web Urentool Pagina 12 van 15
Voorbeeld In een intranet, verbinding gemaakt met de urentool vanaf een ipad2 met als webbrowser Safari. Installatie AdSystems Web Urentool Pagina 13 van 15
Routerinstellingen Om vanaf elke willekeurige locatie via het internet de uren te kunnen boeken is het belangrijk dat bij de instellingen van de router het poortnummer wordt opengezet (Public) en wordt omgeleid naar het IP adres + poortnummer (Private) van de machine waarop de AdSystems Uren Webserver draait. Zie bovenstaand voorbeeld. Installatie AdSystems Web Urentool Pagina 14 van 15
Voorbeeld Vanaf elke willekeurige locatie via het internet verbinding gemaakt met de urentool vanaf een pc met als webbrowser Firefox. Zie de vorige pagina voor belangrijke routerinstellingen. Gebruik het opstartdocument voor de verdere inrichting van de urentool! Installatie AdSystems Web Urentool Pagina 15 van 15