Installationsanvisning och teknisk manual Agda Tidterminal version 2017.1
Innehållsförteckning 1. Agda Tidterminal... 3 1.1 Inledning... 3 1.2 Terminalserverlösningar... 3 1.3 Säkerhet... 3 2. Installation av Agda Tidterminal Webbservice... 4 2.1 Förberedelser... 4 2.2 Installation... 4 3. Aktivering av Agda Tidterminalserver... 10 3.1 Skapa ett databasalias i Agda PS Systemhantering... 10 3.2 Aktivering... 10 4. Installation av tidterminalklient... 11 4.1 Installation... 11 5. Godkänna tidterminal... 14 5.1 Godkänna tidterminal... 14 6. Felsökning... 16 6.1 Inledning... 16 6.2 Installation av Tidterminalklienter misslyckas... 16 6.3 Tidterminalklient kan inte ansluta till servern... 16 6.4 Tidterminalklient kan inte ansluta till Agda PS databas (1)... 17 6.5 Tidterminalklient kan inte ansluta till Agda PS databas (2)... 17 6.6 Tidterminalklient kan inte ansluta till Agda PS databas (3)... 18 6.7 Tidterminalklient kan inte ansluta till Agda PS databas (4)... 18 6.8 Tidterminalen får ohanterat fel vid uppstart... 18 6.9 Får ett felmeddelande när du startar Agda PS Systemhanteraren... 19 7. Avancerade inställningar... 20 7.1 Inledning... 20 7.2 WINDOW... 20 7.3 URL... 20 7.4 UPDATEURL... 20 7.5 REGKEYURL... 20 7.6 AUTOSTART... 21 7.7 MSI Specialare... 21
1. Agda Tidterminal 1.1 Inledning Agda Tidterminal används för tidstämpling. Lösningen består dels av en webbservice som installeras på en IIS server och dels av en klientmjukvara som installeras antingen på en tidterminalhårdvara eller en vanlig dator. 1.2 Terminalserverlösningar Det är endast supporterat att köra tidterminaler via terminalserverlösningar som inte är klustrade/lastbalanserade. Terminalservern får inte heller använda sig av roaming profiles. Tunna klienter som inte kör operativsystem supporterat enligt dokumentet Teknisk specifikation kan endast köra tidterminaler via en terminalserver via RDP. Tidterminaler kan inte installeras direkt på dessa klienter. För att kunna köra mer än en tidterminal på tunna klienter måste dessa använda unika användare på varje klient och dessa får inte vara administratörer, annars kommer tidterminalprocesserna att krocka med varandra. Om du kör tidterminaler via en terminalserver förlorar du en del av offlinestödet. Tidterminalen hanterar fortfarande offlinestämplingar vid uppdateringar, skriptning av Agda PS databas och andra tillfällen där det är databasen som inte är tillgäng, men hanterar inte om kommunikationen mellan tidterminalklienten och terminalservern inte fungerar. 1.3 Säkerhet All data läses och skrivs normalt direkt i Agda PS databasen på SQL servern, men med hjälp av Agda PS Service kan du få en säkrare uppsättning utan direktkontakt mellan IIS servern och Agda PS databasen. Du kan läsa mer om detta i dokumentet Teknisk manual installation Agda PS Service. Kommunikationen sker via TCP/IP. Mellan tidterminalklient och IIS server på port 80 (eller 443 om https), mellan IIS och Agda PS Service på port 10101 (eller valfri), mellan Agda PS Service och Agda PS databas på port 1433. Visma Enterprise AB rekommenderar användning av https. Hur detta konfigureras beskrivs dock inte i detta dokument då det är något som görs i den underliggande tekniska miljön. Visma Enterprise AB ger inte heller support när det gäller konfigurering av den underliggande tekniska miljön. 3
2. Installation av Agda Tidterminal Webbservice 2.1 Förberedelser Innan installationen påbörjas bör dokumentet Teknisk specifikation läsas igenom för att säkerställa att den tekniska miljön uppfyller de krav som Agda PS ställer. Du bör även läsa genom dokumentet Teknisk manual installation Agda PS Service så att du kan ta ställning till olika sätt att installera Agda Tidterminal Webbservice. Detta dokument förutsätter att det redan finns en MS SQL Server installerad med en Agda PS databas på. Installationsanvisning för MS SQL Server och Agda PS databas finner du i separata dokument. Verifiera att Windowskomponenten ASP.NET 3.5, ASP.NET 4.6, IIS6-kompabilitetsläge samt Windows Communication Foundation (WCF) HTTP Activation är installerat och aktiverat. För att Agda Tidterminal ska fungera krävs att man lagt upp en användare (ofta kallad TidtermAdmin) i Agda PS som ges tilläggsfunktionen extern användare. Denna användare används av samtliga tidterminalklienter vid initial anslutning och användaren måste därför ha behörighet till alla företag som används av någon av tidterminalerklienterna. Utöver TidtermAdmin behövs ytterligare en användare (ofta kallad Tidterm01, Tidterm02 osv.) per tidterminalklient. Dessa används vid godkännande av tidterminalklienter och styr bl.a. vilka som får stämpla på respektive tidterminal. Alla dessa användare skapas normalt av administratören och beskrivs inte i denna manual. 2.2 Installation Installationsprogrammet startas genom att montera Agda PS ISO-filen. Om inte installationsguiden startar automatiskt så dubbelklickar du på filen AgdaSetup.exe. Klicka på Installera programvara. 4
Klicka på Agda Tidterminal Webbservice. Om.Net Framework 4.6 saknas kan du installera det genom installationsfilen som finns på Agda PS ISO-filen under \SetupFiles\Verktyg\NDP46-KB3045557-x86-x64-AllOS-ENU.exe (omstart bör göras efter installation). Klicka på Nästa. 5
Välj vilken webbplats och applikationspool du vill använda, klicka sedan på Nästa. Det går endast att välja mellan de som redan är skapade på IIS. Applikationspoolen ska köra.net 4 Integrated. Klicka på Installera. 6
När installationen är klar, klicka på Slutför. Efter Agda Tidterminal installationen är klar kommer installation av Agda Tidterminal Konfiguration påbörjas automatiskt. Detta är de moduler av Agda PS Systemhantering som berör Agda Tidterminal. Klicka på Nästa. 7
Klicka på Nästa. Klicka på Installera. 8
Klicka på Slutför. 9
3. Aktivering av Agda Tidterminalserver 3.1 Skapa ett databasalias i Agda PS Systemhantering För att Agda Tidterminal Webbservice ska hitta Agda PS databasen måste du skapa ett databasalias på IIS servern. Hur du skapar ett databasalias i Agda PS Systemhanteraring kan du läsa om i dokumentet Skapa ett databasalias i Agda PS Systemhantering. 3.2 Aktivering Starta Agda PS Systemhantering, gå sedan till fliken Anslutningshantering. Om du inte ser Navigationspanelen i vänsterkanten, klicka i menyn på Fönster > Navigationspanelen. Välj den databasanslutning du vill aktivera Agda Tidterminal för. Ange användarnamn och lösenord för den externa användare (ofta kallad Tidtermadmin) som du skapat i Agda PS. Sätt Använd som Tidterminal alias till True och Spara. Var noggrann med att skriva in rätt lösenord för att inte riskera att användaren blir spärrad i Agda PS p.g.a. felaktiga inloggningsförsök. Om du ska använda tidterminaler på flera databasanslutningar måste dessa separeras genom inställningen för DNS Namn (Host Header)-styrning. Använder du host header-styrning på en databasanslutning måste även de andra databasanslutningar ha (unika) host header-styrningar. Har du Agda PS webb eller Agda Rekrytering på samma server så påverkas även dessa av host header-styrningarna. 10
4. Installation av tidterminalklient 4.1 Installation Installation av tidterminalklienter görs genom att du på klienten surfar till den webbplats där du installerade Agda Tidterminal Webbservices, t.ex. http://<servernamn>/agdatidterminalserver/ eller om du använder host header-styrning så är det, det namnet du ska gå mot istället för <servernamn>. Notera eller klipp ut adressen i fältet Adress för uppdatering, denna ska du strax använda. Klicka på knappen Agda PS Tidterminalinstallation. Du bör då få en fråga om du vill köra eller spara filen Tidterminal.msi, välj i så fall att köra. Beroende på webbläsare och inställningar kan det vara annorlunda, t.ex. att du måste spara ner filen och sedan leta upp och köra den därifrån du sparade den. Applikationen är signerad med ett certifikat som garanterar att det kommer från Visma Agda AB. Installerar du detta certifikat på en dator i Trusted Publishers store kan du installera tidterminaler utan att få certifikat fråga. 11
När du kört filen och installationen är klar (du får ingen bekräftelse på att den är klar) så ska du ha fått en ikon på skrivbordet. Dubbelklicka på ikonen för att starta tidterminalen. Första gången tidterminalen startas får du en ruta där du ska ange adressen du noterade tidigare, t.ex. http://<servernamn>/agdatidterminalserver/. Om du angivit en felaktigt formaterad adress kommer tidterminalen att avslutas och du får manuellt starta det med ikonen för att försöka igen. Om adressen är fel men korrekt formaterad får du ingen notis utan det kommer bara att leda till att tidterminalen inte kommer att kunna få kontakt med servern. 12
Tidterminalen kommer nu att försöka få kontakt med Agda PS databasen, det brukar ta några sekunder. När tidterminalen fått kontakt går den över i ett läge där den väntar på att du ska godkänna den. 13
5. Godkänna tidterminal 5.1 Godkänna tidterminal Starta Agda PS Systemhantering på servern, gå sedan till fliken Tidterminaler. Om du inte ser Navigationspanelen i vänsterkanten, klicka i menyn på Fönster > Navigationspanelen. Välj den databasanslutning för vilken du vill administrera tidterminaler. Du ska då få upp en lista med status på de tidterminaler som finns registrerade i databasen. Markera den tidterminal med datornamn och datorkod som matchar den du installerat som väntar på godkännande. Bland inställningarna under tidterminallistan ändra du status från Väntar på godkännande till det du vill använda, vanligtvis Online, tillåt offlineregistreringar. Detta läge kräver att du har licens för Agda PS webb då det är därifrån administratören synkroniserar över eventuella offlinestämplingar efter att tidterminalen kommit online igen. I fältet Användare väljer du sedan den tidterminalanvändare terminalen ska kopplas mot, t.ex. Tidterm01. Genom denna användare kan du t.ex. styra vilka som får stämpla på tidterminalen och spåra från vilken tidterminal en stämpling är gjord. Därför är vår rekommendation att använda olika användare på alla tidterminaler. I fältet Cache Time-To-Live väljer du hur ofta tidterminalklienten hämtar information från Agda PS databasen som den behöver ha när den går över till Offlineläge vid händelse av att den tappat kontakten med Agda PS databasen. 6 timmar brukar vara ett lagom värde för att den ska ha aktuell information utan att generera onödigt mycket nätverkstrafik. Gör du ofta förändringar gällande personal, scheman och liknande kanske du vill sänka värdet, gör du det väldigt sällan kanske du vill öka det. Visa välkomstsida och Prestanda/grafikinställningar är inställningar som påverkar utseende och prestanda. Om du kör flera tidterminalklienter via en terminalserver kan du med dessa inställningar få tidterminalen att använda mindre resurser samt optimera grafiken för RDP-trafik. Det finns även möjlighet att ange två snabbval på registreringssidan, een ut- och/eller en in- orsakskod. När du gjort de inställningar du ska, klicka på Spara. 14
Klicka på uppdateringsknappen med två pilar på i nedre högre hörnet av listan då och då för att uppdatera listan, den uppdateras inte automatiskt. Efter en kort stund kommer tidterminalen att fylla på med information i listan och slutligen gå över till status Online. Kontrollera därefter även på tidterminalklienten att allt ser korrekt ut och gör gärna en provstämpling för att se att det fungerar som du tänkt. 15
6. Felsökning 6.1 Inledning Nedan följer några exempel där Agda Tidterminal inte lyckats installera eller få kontakt med Agda PS databas. Du behöver i vissa fall komma åt loggen för Agda Tidterminal. Beroende på vilka rättigheter användaren som kör tidterminalen har kan denna finnas antingen i Windows loggbok eller i filen %temp%\agda tidterminal12.log (där siffran är månadsnumret). Som standard är meddelande i loggen p.g.a. säkerhet inte så detaljerade. Vid behov kan mer detaljerad loggning aktiveras genom att modifiera filen web.config filen där Agda Tidterminal Webbservice är installerad, vanligtvis i C:\inetpub\wwwroot\AgdaTidterminalServer\web.config. Leta upp raden <servicedebug includeexceptiondetailinfaults="false"/> och ändra den från false till true. Spara filen och låt tidterminalen logga lite mer detaljerad information När problemet är åtgärdat bör du stänga av den detaljerade loggningen igen genom att ändra tillbaka värdet till false. 6.2 Installation av Tidterminalklienter misslyckas Symtom: Tidterminalklientern startar inte. Lösning: Avinstallera tidterminalen från kontrollpanelen, om den inte finns där använd då AvinstalleraTidterminal valet i startmenyn under Visma Agda AB Installera sedan om tidterminalen genom att köra msi filen. 6.3 Tidterminalklient kan inte ansluta till servern Symtom: Vid installation kommer tidterminalklienterna att hänga sig vid meddelandet Ansluter till Agda PS i mer än två minuter och tidigare aktiva tidterminaler blir offline. Felmeddelandet nedan tyder på att tidterminalen inte får kontakt med WCF-tjänsten (WebService) på servern. Felmeddelande: Windows user: <logged in user>det gick inte att ansluta till någon service endpoint. Endpoint: http:// <servernamn>/agdatidterminalserver/service.svc/secure Alternativt: Could not connect to http:// <servernamn>/agdatidterminalserver/service.svc/secure. TCP error code 10061: No connection could be made because the target machine actively refused it 127.0.0.1. No connection could be made because the target machine actively refused it 127.0.0.1. 16
Lösning: Gå till http:// <servernamn>/agdatidterminalserver/service.svc/ för att se om användaren kan komma åt tjänsten. Kontrollera att webbsiten som tjänsten ligger på är startad. Har du flyttat servern till en annan dator eller ändrat dns eller IP nummer till serverdatorn ska du installera om alla tidterminalklienter som var kopplade mot den gamla servern. 6.4 Tidterminalklient kan inte ansluta till Agda PS databas (1) Symtom: Vid installation kommer tidterminalklienterna att hänga sig vid meddelandet Ansluter till Agda PS i mer än två minuter och tidigare aktiva tidterminaler blir offline. Felmeddelandet nedan tyder på att inget alias är kopplat via Agda Tidterminal Konfiguration > Konfiguration Webbtjänst Tidterminal. Felmeddelande: Fel vid inloggning Inget alias hittades som matchar host header <server>.<domän>.se. Alternativt: Tidterminal misslyckades med att ansluta till Agda PS. Inget alias hittades som matchar host header <server>.<domän>.se. Lösning: Kontrollera att det är kopplat ett alias i Agda Tidterminal Konfiguration > Konfiguration Webbtjänst Tidterminal. 6.5 Tidterminalklient kan inte ansluta till Agda PS databas (2) Symtom: Vid installation kommer tidterminalklienterna att hänga sig vid meddelandet Ansluter till Agda PS i mer än två minuter och tidigare aktiva tidterminaler går offline. Felmeddelandet nedan tyder på att den externa användaren som är kopplad via Agda Tidterminal Konfiguration > Konfiguration Webbtjänst Tidterminal inte är korrekt konfigurerad. Felmeddelande: Windows user:dawah Fel vid inloggning Felaktig inloggning. Kontrollera med din systemadministratör att ditt konto fortfarande är giltigt och att du har rätt användarnamn och lösenord. Alternativt: Tidterminal misslyckades med att ansluta till Agda PS.Felaktig inloggning. Kontrollera med din systemadministratör att ditt konto fortfarande är giltigt och att du har rätt användarnamn och lösenord. Lösning: Kontrollera att den externa användaren som är kopplad via Agda Tidterminal Konfiguration > Anslutningshantering finns i Agda PS databas och inte är spärrad. Kontrollera att lösenordet är korrekt. 17
6.6 Tidterminalklient kan inte ansluta till Agda PS databas (3) Symtom: Vid installation kommer tidterminalklienterna att hänga sig vid meddelandet Ansluter till Agda PS i mer än två minuter och tidigare aktiva tidterminaler blir offline. Gå till loggboken eller %temp%\ Agda tidterminal.log beroende på om användaren har administratörsrättigheter på datorn eller ej. Felmeddelandet, eller del av felmeddelandet nedan, är ett generellt felmeddelande och kan betyda många olika problem. Ett vanligt fel är dock att den externa användaren som är kopplad via Agda Tidterminal Konfiguration > Anslutningshantering inte har korrekt behörighet i Agda PS. Felmeddelande: Object reference not set to an instance of an object. Lösning: Kontrollera att den externa användaren som är kopplad via Agda Tidterminal Konfiguration > Anslutningshantering har behörighet (användarprofil kopplad) till alla företag som använder tidterminaler. 6.7 Tidterminalklient kan inte ansluta till Agda PS databas (4) Symtom: Vid installation kommer tidterminalklienterna att hänga sig vid meddelandet Ansluter till Agda PS i mer än två minuter och tidigare aktiva tidterminaler blir offline. Felmeddelandet tyder på att versionerna på Agda PS databas och Agda Tidterminal Webbservices inte matchar. Felmeddelande: Tidterminal misslyckades med att ansluta till Agda PS. Programuppdatering har skett men är inte komplett. Kontakta systemadministratör! Databasversionen(xx) är mindre än programversionen(nn). Lösning: Kontrollera att Agda PS databas är skriptad till senaste version och att senaste version av Agda Tidterminal Webbservices är installerad. 6.8 Tidterminalen får ohanterat fel vid uppstart Symtom: Efter att tidterminalen startat kommer det ett rött kryss med felmeddelandet Ett ohanterat fel har inträffat i tidterminalen. Detta beror ofta på att offlinedatabasen inte kan öppnas eller har blivit korrupt. Anledningar till detta kan vara att du gjort en återläsning på Agda PS databas och att tidterminalen inte var konfigurerad i den versionen. En annan anledning kan vara att du tagit bort en tidterminalkonfiguration och sedan åter igen godkänt samma tidterminal från samma dator i Agda Tidterminal Konfiguration > Tidterminaler. Felmeddelande: The specified password does not match the database password. [ Data Source = C:\Documents and Settings\<user>\Local Settings\Application Data\Agda\AgdaPS\AgdaTidterminal\ AgdaTidterminal_<aliasguid>.sdf ] 18
Lösning: Radera offline-databasen. Notera att eventuella registreringar gjorda i offline-läge som inte automatiskt synkroniserats till Agda PS databas kommer att gå förlorade. Ta bort följande filer: %USERPROFILE%\Local Settings\Application Data \Agda\AgdaPS\AgdaTidterminal\ AgdaTidterminal_<aliasguid>.sdf %USERPROFILE%\Local Settings\Application Data \Agda\AgdaPS\AgdaTidterminal\ AgdaTidterminal_<aliasguid>.log 6.9 Får ett felmeddelande när du startar Agda PS Systemhanteraren Symtom: När du startar Agda PS Systemhanteraren får du ett felmeddelande Felmeddelande: Ett allvarligt fel har inträffat när konfigureringsdatabasen skulle öppnas. Kontrollera eventloggen för mer detaljer. Ett fel har inträffat i metoden ConfigurationDatabaseProvider.EvaluateData, Unable to load the native components of SQL Server Compact corresponding to the ADO.NET provider of version 8080. Install the correct version of SQL Server Compact. Refer to KB article 974247 for more details. Unable to load DLL sqlceme35.dll, this application has failed to start because the application configuration is incorrect. Reinstalling the application may fix this problem. Lösning: Installera Microsoft Visual C++ 2005 redistributable package. http://www.microsoft.com/en-us/download/details.aspx?id=3387. 19
7. Avancerade inställningar 7.1 Inledning Vi tillåter vissa att vissa typer av parametrar används tillsammans med Tidterminal.exe. Dessa definieras genom dubbla bindestreck och namnet på parametern, t.ex. --parameter: värde eller C:\Users\<användaren>\AppData\Local\Agda\AgdaPS\AgdaTidterminal\Klient\Tidterminal.exe window Giltiga parametrar med förklaring följer nedan. Dessa parametrar ska även gå att kombinera. 7.2 WINDOW Denna uppstartsparameter kommer att starta tidterminalen i ett fönster istället för som fullskärm. Värde kan vara 4 olika, Normal, Minimized, Maximized eller tomt. Om Window är satt men utan ett värde så kommer Normal att användas. Tidterminal.exe window Tidterminal.exe --window: Maximized WINDOW kan även användas direkt vid MSI installation med MST eller MSIEXEC. msiexec /i Tidterminal.msi WINDOW=TRUE 7.3 URL Denna uppstartsparameter används första gången tidterminalen startar för att sätta sökvägen till uppdateringsservern. Terminalen sparar sedan värdet i konfigurationen och ignorerar denna parameter. Adressen att ange med denna parameter visas på nerladdning sidan. Tidterminal.exe --url: http://<miniisserver>/agdatidterminalserver Denna parameter kan användas i samverkan med --updateurl för att påtvinga omskrivning av konfigurationen. URL kan även användas direkt vid MSI installation med MST eller MSIEXEC. msiexec /i Tidterminal.msi URL= http://<miniisserver>/agdatidterminalserver 7.4 UPDATEURL Denna uppstartsparameter används för att påtvinga en url uppdatering nästa uppstart. Kan användas i samverkan med URL parametern för att uppdatera. Om URL parametern inte är satt så kommer den att visa ett inmatningsfönster. Tidterminal.exe --updateurl 7.5 REGKEYURL Denna uppstartsparameter tvingar tidterminalen att läsa sin uppdaterings url från en registernyckel varje uppstart istället för den sparade i konfigurationen. Denna nyckel sparar även ner urlen från registernyckeln till konfigurationen om dessa inte är samma. Där är inga värden till denna parameter. Nyckeln ska vara belägen i HKCU\Software\AgdaTidterminal vara av typen REG_SZ och heta Url. Värdet ska vara urlen till uppdaterings servern. 20
Tidterminal.exe --regkeyurl REGKEYURL kan även användas direkt vid MSI installation med MST eller MSIEXEC. msiexec /i Tidterminal.msi REGKEYURL=TRUE 7.6 AUTOSTART Denna parameter är endast tillgänglig vid MSI installation, om denna är satt så kommer installationen även skapa en genväg i användarens autostart mapp och inte bara på skrivbordet. msiexec /i Tidterminal.msi AUTOSTART=TRUE 7.7 MSI Specialare Samtliga parametrar som är tillgängliga för MSI kan även specificeras som registernycklar innan installationen körs, så kommer installationen automatiskt läsa in och använda dessa. I HKCU\Software\AgdaTidterminal kan du skapa register värden som heter som parametern och som är av typen REG_SZ. 21