Technische Opzet TimeTell versie 8
TIMETELL BV www.timetell.nl Balen van Andelplein 2 2273 KH , Voorburg 070-3114811
[email protected] Helpdesk 070-3114810
[email protected]
Inhoud 1. 2.
Inleiding ......................................................................................................................... 4 Technische opzet............................................................................................................. 5 2.1. Login verificatie ........................................................................................................ 6 2.2. Systeemeisen ........................................................................................................... 7 3. Installatie ....................................................................................................................... 9 3.1. Inventarisatie ........................................................................................................... 9 3.1.1. 3.1.2. 3.1.3. 3.1.4. 3.1.5.
3.2.
Applicatieserver .............................................................................................................. 9 Client ............................................................................................................................. 9 Web client ...................................................................................................................... 9 App .............................................................................................................................. 10 Database ...................................................................................................................... 10
Setup database ...................................................................................................... 11
3.2.1. FireBird ........................................................................................................................ 11 3.2.2. FireBird naast InterBase installeren ................................................................................ 16 3.2.3. Oracle .......................................................................................................................... 17 3.2.3.1. Aanmaken Oracle tablespace ................................................................................. 17 3.2.3.2. Configuratie Oracle op TimeTell aplicatieserver ....................................................... 19 3.2.4. SQL Server ................................................................................................................... 24 3.2.4.1. Installatie en configuratie MS SQL Server ............................................................... 24
3.3.
3.3.1. 3.3.2. 3.3.3. 3.3.4. 3.3.5.
Installatie ..................................................................................................................... 31 Configuratie database verbinding ................................................................................... 37 Initialiseer database ...................................................................................................... 40 Configuratie applicatieserver .......................................................................................... 41 Configuratie services ..................................................................................................... 42
3.5.1. 3.5.2. 3.5.3. 3.5.4. 3.5.5. 3.5.6.
Installatie ..................................................................................................................... 47 .NET Framework ........................................................................................................... 53 Oracle Data Access Components (ODAC) ........................................................................ 54 Configuratie webservice achteraf aanpassen ................................................................... 55 Configuratie Windows Authentication ............................................................................. 56 Known Issues ............................................................................................................... 57
3.6.1. 3.6.2. 3.6.3. 3.6.4.
Configuratie webservice ................................................................................................. 58 Webservice via HTTPS ................................................................................................... 60 Installatie webservice op andere server .......................................................................... 61 Instellingen in de App .................................................................................................... 65
3.4. 3.5.
3.6.
4.
Setup TimeTell applicatieserver ............................................................................... 31
Setup TimeTell windows client ................................................................................. 43 Setup TimeTell web client ....................................................................................... 47
Setup TimeTell webservices .................................................................................... 58
3.7. Installatie Open SSL ............................................................................................... 66 Extra configuratie opties ................................................................................................ 67 4.1. Configuratie authenticatie gebruikers ....................................................................... 67 4.2. Configuratie E-Mail notificatie op server (SMTP) ........................................................ 69 4.3. Configuratie Exchange synchronisatie op server ........................................................ 70 4.3.1. Delen van de agenda’s - machtigingen ........................................................................... 71 4.3.1.1. Privé-afspraken synchroniseren .............................................................................. 74 4.3.2. Office 365 ..................................................................................................................... 76
4.4. 4.5. 4.6. 4.7. 4.8.
Configuratie taalbestanden ...................................................................................... 77 Configuratie Google API key .................................................................................... 78 Configuratie van TimeTell windows client over internet .............................................. 79 Opzetten test database ........................................................................................... 80 Opzetten archief database ...................................................................................... 81
TimeTell Technische Opzet
2/84
Versie 9 juli 2015
4.9.
Configuratie parameters.......................................................................................... 84
4.9.1. 4.9.2. 4.9.3.
TimeTell client parameters ............................................................................................. 84 TimeTell Task Manager parameters ................................................................................ 84 TimeTell Administrator parameters ................................................................................. 84
TimeTell Technische Opzet
3/84
Versie 9 juli 2015
1. Inleiding Deze handleiding is bedoeld voor de systeembeheerders die de TimeTell applicatie installeren en het technisch beheer gaan uitvoeren.
TimeTell Technische Opzet
4/84
Versie 9 juli 2015
2. Technische opzet Onderstaand model geeft de algemene technische opzet weer van TimeTell. Hieruit blijkt dat werken door medewerkers op verschillende locaties en thuiswerkers wordt ondersteund.
TimeTell functionaliteiten zijn op de volgende manieren beschikbaar voor de eindgebruiker:
Snelkoppeling naar de TimeTell client op een centrale netwerkshare Lokale TimeTell client op een laptop of thuis-PC o Communicatie via HTTP of HTTPS o Client wordt automatisch geüpdatet na een server update Via de TimeTell webclient in de browser Via de TimeTell App
Verder is via TimeTell Online ook nog een gehoste versie van TimeTell beschikbaar.
TimeTell Technische Opzet
5/84
Versie 9 juli 2015
2.1. Login verificatie Er zijn 2 manieren van login verificatie in TimeTell: Single sign-on De eerste is dat TimeTell geen login dialoog toont maar aan Windows vraagt als welke gebruiker je bent aangemeld op het netwerk. Deze loginnaam wordt dan opgezocht in de TimeTell database en op basis daarvan krijg je autorisatie in TimeTell zelf. Deze methode maakt dus gebruik van het feit dat je al bent ingelogd en geverifieerd door Windows. N.B. Het is mogelijk om naast de loginnaam ook nog te controleren of je bent ingelogd op een geldig domein. Zie paragraaf 4.1 Configuratie authenticatie gebruikers voor meer informatie. Login dialoog De tweede methode maakt gebruik van een TimeTell logindialoog met username en password. Deze kan eventueel worden geverifieerd met een username/wachtwoord combinatie die in de TimeTell database is vastgelegd. Het is echter ook mogelijk dat deze login gegevens worden geverifieerd bij een LDAP server. Je vult dan je eigen netwerk loginnaam en wachtwoord in en deze worden door de applicatieserver secure naar de LDAP server gestuurd. Je krijgt dan alleen toegang tot TimeTell als de LDAP server dit heeft geverifieerd als een geldige login. Verder moet je loginnaam (geen wachtwoord) voorkomen in de TimeTell database. Zie paragraaf 4.1 Configuratie authenticatie gebruikers voor meer informatie. In alle gevallen worden de login gegevens versleuteld verzonden van de TimeTell client naar de applicatieserver. Hiervoor wordt gebruik gemaakt van AES encryptie.
TimeTell Technische Opzet
6/84
Versie 9 juli 2015
2.2. Systeemeisen De volgende systeemeisen zijn van toepassing voor een TimeTell installatie:
TimeTell applicatieserver
Besturingssysteem
Windows 2003, Windows 2008, Windows 2012 (incl R2 versies) Windows Vista, Windows 7, Windows 81
Processor en geheugen
4Gb of hoger 32-bits of 64-bits
Database client (32-bits)
TimeTell webserver (alleen van toepassing bij gebruik webmodule)
SQL-Server (vanaf v2005 t/m v2014, geen Express uitvoering) Oracle (vanaf v10 t/m v12, geen Express uitvoering) FireBird server (vanaf v2.5.3, client aanwezig bij standaard database installatie)
De
volgende webservers worden ondersteund: IIS 7.5 (Windows 2008 R2) IIS 8 (Windows 2012) IIS 8.5 (Windows 2012 R2)
Microsoft .NET Framework 4.5.1
Application development, ASP.net
Processor en geheugen
4Gb 32-bits of 64-bits
Database client (32-bits)
TimeTell client
SQL-Server (vanaf v2005 t/m v2014, geen Express uitvoering) Oracle (vanaf v10 t/m v12, geen Express uitvoering) + Oracle Data Access Components FireBird server (vanaf v2.5.3, client aanwezig bij standaard database installatie)
Besturingssysteem
Windows 2003, Windows Vista, Windows 2008, Windows 7, Windows 8, Windows 2012
Processor en geheugen
1
2Gb 32-bits of 64-bits
Dit zijn geen server versies van Windows waardoor slechts een beperkt aantal PC’s toegang kan hebben tot shares op deze machines. De TimeTell client moet in dat geval niet op een share op deze machine geplaatst worden.
TimeTell Technische Opzet
7/84
Versie 9 juli 2015
Web client
Browser
Internet Explorer: 9 of hoger (10 of hoger geadviseerd) FireFox: 29 of hoger Chrome: 34 of hoger Safari : 7 of hoger
Ondersteuning voor Java script moet aan staan in de browser instellingen. Deze applicatie maakt gebruik van cookies om instellingen op te slaan.
App
De minimale resolutie om de webclient te kunnen gebruiken is 1024 x 768 pixels. Een hogere resolutie wordt aanbevolen.
IOS 7.0 en hoger Android 4.0 en hoger
Server geheugen De benodigde hoeveelheid geheugen op de server hangt af van diverse factoren. Voor iedere gebruiker die op dat moment verbinding heeft met de applicatie server is ongeveer 2Mb geheugen op de applicatieserver benodigd. TimeTell heeft echter zelf een mechanisme dat de verbinding met de applicatieserver automatisch verbreekt en herstelt zodat het aantal gelijktijdig actieve connecties naar de applicatiesserver beperkt blijft.
Database omvang De omvang van de database hangt af van diverse factoren. Als stelregel houden wij maximaal 1Mb per medewerker per jaar aan. In de meeste gevallen is de omvang van de groei van de database echter minder.
Netwerk verkeer Voor de TimeTell client wordt een 1Mb verbinding geadviseerd. Een hogere bandbreedte is natuurlijk beter voor performance.
Dedicated server Een dedicated server voor TimeTell is wenselijk maar niet noodzakelijk mits er voldoende (processor)capaciteit beschikbaar is op de server. N.B. Het is mogelijk om de database server, de applicatieserver en de webserver op aparte servers of op dezelfde server te installeren. Dit mogen ook virtuele servers zijn. Default werkt TimeTell met FireBird als database server. Als wordt gewerkt met Oracle of SQLServer dan moet de klant zelf de database (server), de database licenties en het beheer regelen.
TimeTell Technische Opzet
8/84
Versie 9 juli 2015
3. Installatie 3.1. Inventarisatie Onderstaande gegevens zijn nodig tijdens de installatie en kunnen vooraf geïnventariseerd worden. TimeTell is een multi-tier applicatie die bestaat uit de volgende lagen: Database Applicatie server Windows client Web client App Afhankelijk van de behoefte kunnen deze lagen over verschillende (virtuele) servers worden verdeeld. De systeemeisen voor iedere laag staan beschreven in paragraaf 2.2 Systeemeisen.
3.1.1. Applicatieserver De TimeTell applicatieserver bestaat uit een set Windows services die geïnstalleerd worden. Hostname server waarop TimeTell gaat draaien: Installatie pad voor TimeTell server programmatuur:
Default c:\program files\timetell
3.1.2. Client De TimeTell client bestaat uit een Windows executable die centraal op een fileserver geplaatst kan worden. Er is dan geen lokale installatie nodig en er hoeven alleen maar snelkoppelingen naar deze centrale executable gedistribueerd worden. Alternatief is dat de client op de afzonderlijke PC’s en laptops wordt geplaatst. N.B. Het is mogelijk om deze lokale clients dan automatisch te updaten als er een nieuwe versie wordt geïnstalleerd op de server. Centrale client op fileserver Hostname fileserver waarop TimeTell client: Installatie pad voor client op fileserver: Share naam voor client directory op fileserver: Lokale clients op PC’s Lokaal installatie pad voor client:
Default c:\program files\timetell\client
3.1.3. Web client De TimeTell web client kan als een .NET web application geïnstalleerd worden onder IIS. Hostname webserver: Installatiepad voor web client:
Default c:\inetpub\wwwroot\timetell
N.B. Op deze server moeten ook de TimeTell webservices geïnstalleerd worden.
TimeTell Technische Opzet
9/84
Versie 9 juli 2015
3.1.4. App Voor de app moet de applicatieserver vanaf buiten benaderbaar zijn via een flexibele in te stellen poort. Alle communicatie tussen app en de server gebeurt encrypted. Eventueel kan de TimeTell Webservice op een andere server worden geïnstalleerd die vanaf buiten benaderbaar is.
3.1.5. Database TimeTell ondersteunt Oracle en SQL-Server databases2. FireBird is de default database voor TimeTell als niet is gekozen voor Oracle of SQL-Server. FireBird De installatie programmatuur voor FireBird wordt meegeleverd. Hostname database server:
Default is dit dezelfde server als de TimeTell applicatie server. Installatie pad voor FireBird programmatuur:
Default in c:\program files\firebird
Installatie pad voor TimeTell database:
Default in data subdirectory onder TimeTell directory (c:\program files\timetell\data)
Oracle Uitgangspunt is dat er een werkende Oracle database server is. Hierop moet een Oracle database beschikbaar zijn waarin een tablespace kan worden aangemaakt. De 32-bits versie Oracle client moet ook op de TimeTell applicatie server zijn geïnstalleerd. Hostname database server: Oracle service naam: Oracle poort (default 1521): Oracle login gegevens om tablespace en user aan te maken: SQL server Uitgangspunt is dat er een werkende SQL database server is. De SQL server client moet ook op de TimeTell applicatie server zijn geïnstalleerd. Hostname database server: SQL server login gegevens om database en user aan te maken:
2
Installatie, beheer en licenties voor Oracle en SQL-server dient de klant zelf te regelen.
TimeTell Technische Opzet
10/84
Versie 9 juli 2015
3.2. Setup database 3.2.1. FireBird N.B. Controleer vooraf of op de server ook InterBase versie 7 of hoger is geïnstalleerd. In dat geval moet FireBird namelijk naast InterBase worden geïnstalleerd. Zie paragraaf “3.2.2 FireBird naast InterBase installeren” voor meer informatie hierover. Installeer de Firebird database server door Firebird-2.5.3.26778_0_Win32.exe uit te voeren.
Klik op de knop ‘Next’. Het volgende scherm is de License Agreement. Selecteer “I accept the agreement’ en klik op de knop ‘Next’. Het volgende scherm is het Informatiescherm. Klik op de knop ‘Next’. In onderstaand scherm staan de componenten vermeld. Kies voor de Server components (default)
TimeTell Technische Opzet
11/84
Versie 9 juli 2015
Dit is de standaard directory waar de database server wordt geïnstalleerd dit kan eventueel aan gepast worden. Dit is niet de plek waar de TimeTell database wordt geplaatst, deze instelling wordt pas later gevraagd. Pas deze aan wanneer gewenst en klik op de knop ‘Next’.
In bovenstaand scherm staan de componenten vermeld. Zorg dat alles aangevinkt is (default)
TimeTell Technische Opzet
12/84
Versie 9 juli 2015
N.B. Als de database server een andere is dan de TimeTell applicatieserver dan moet de client ook nog apart worden geïnstalleerd op de applicatieserver! Kies dan alleen voor Client components. Klik op de knop ‘Next’.
Klik op de knop ‘Next’.
TimeTell Technische Opzet
13/84
Versie 9 juli 2015
N.B. Als FireBird naast InterBase wordt geïnstalleerd moet de onderste optie uit staan. Klik op de knop ‘Next’.
Klik op de knop ‘Install’. De FireBird database server wordt nu geïnstalleerd. Het volgende scherm is een Informatiescherm. Klik op de knop ‘Next’. Het onderstaande scherm verschijnt, door nu op de knop ‘Finish’ te klikken zal FireBird starten.
TimeTell Technische Opzet
14/84
Versie 9 juli 2015
Op de server zijn nu de volgende services actief: Firebird Guardian – Default Instance Firebird Server – Default Instance In het configuratiescherm is een FireBird Server Manager geïnstalleerd. Deze beheertool maakt het mogelijk om de database server te stoppen en te starten:
TimeTell Technische Opzet
15/84
Versie 9 juli 2015
3.2.2. FireBird naast InterBase installeren Als op de server InterBase versie 7 of hoger draait dan kun je FireBird als volgt naast InterBase installeren: INSTALLATIE FIREBIRD Bij de installatie van FireBird moet je de volgende opties opgeven:
“Generate GDS32.DLL” uitzetten
“Copy Firebird client to system directory” aanzetten
Als dit niet is gebeurd dan moet je de DLL’s goed zetten (zie volgende paragraaf). DLL
Zorg dat de InterBase versie van GDS32.DLL in system32 staat (dus niet de firebird versie van GDS32.DLL!). Kopieer eventueel uit de Program files\InterBase directory.
Zorg dat de Firebird client (FBCLIENT.DLL) in system32 staat . Kopieer eventueel uit de Program files\Firebird\bin directory.
FIREBIRD.CONF Open Firebird.conf in de Program Files\FireBird directory (niet in de TimeTell directory). Zorg dat de regel met RemoteServicePort niet begint met hekje en stel de poort in op 3051: RemoteServicePort = 3051 Herstart FireBird via de Firebird Manager in het Windows Configuratiescherm. TTDATA.INI Na de installatie van TimeTell moet TTData.ini nog worden aangepast. Open TTData.ini in de TimeTell directory en geef na de host de poort op: SERVER NAME=localhost/3051:d:\Timetell\data\TIMETELL.GDB Voeg daarnaast de volgende regel toe: FIREBIRD=TRUE Als je nu de FireBird en de TimeTell services herstart moet TimeTell werken via FireBird terwijl de InterBase database de andere applicaties afhandelt.
TimeTell Technische Opzet
16/84
Versie 9 juli 2015
3.2.3. Oracle Geadviseerd wordt om dit onderdeel uit te voeren in samenspraak met de Oracle DBA van uw organisatie. Oracle versie 10,11 en 12 worden ondersteund (m.u.v. de Express varianten). Voor de webclient zijn ook de Oracle Data Access Components nodig (zie paragraaf 3.5.3). N.B. TimeTell werkt alleen met de 32-bits versie van de Oracle client. 3.2.3.1. Aanmaken Oracle tablespace Uitgangspunt is dat er een werkende Oracle database server is. Hierop moet een Oracle database beschikbaar zijn waarin een tablespace kan worden aangemaakt. Deze database kan het beste met de characterset WE8MSWIN1252 worden aangemaakt, in ieder geval geen unicode set. Om te bepalen welke character set gebruikt wordt kan je de volgende query gebruiken:
select * from nls_database_parameters where (parameter = 'NLS_CHARACTERSET'); Mocht dit niet de aanbevolen characterset als antwoord geven (Oracle 11 zal standaard AL32UTF8 gebruiken) dan is het nodig om een nieuwe database aan te maken om daarin de TimeTell tablespace te plaatsen. Dit kan onder andere met de Database Configuration Assistant.
TimeTell Technische Opzet
17/84
Versie 9 juli 2015
Er moet in de database een tablespace worden aangemaakt waarin de TimeTell tabellen kunnen worden geplaatst. Vervolgens moet er een user worden aangemaakt die deze tablespace als default tablespace heeft en create en drop rechten heeft voor tables en views. Hieronder staat een voorbeeldscript voor het aanmaken van een tablespace voor TimeTell. connect system/manager set echo on /* aanmaak tablespaces */ create tablespace TIMETELL datafile 'c:\ORADATA\TIMETELL.ORA' size 100M autoextend ON next 50M / create user TIMETELL identified by TIMETELL default tablespace TIMETELL / grant connect, resource to TIMETELL / grant create any view, drop any view to TIMETELL / grant unlimited tablespace to TIMETELL / connect TIMETELL/TIMETELL
TimeTell Technische Opzet
18/84
Versie 9 juli 2015
3.2.3.2. Configuratie Oracle op TimeTell aplicatieserver Installeer eerst de Oracle client op de server waarop de TimeTell server geïnstalleerd zal worden (hierna moet de server opnieuw gestart worden). Vervolgens kan een Oracle netservice naam worden aangemaakt die toegang geeft tot de Oracle database. Hieronder staat beschreven hoe je dit kan instellen met de Oracle Net configuration assistant. Het kan natuurlijk ook door TNSNAMES.ORA aan te passen in de Oracle\Admin directory. N.B. Als je geen netservicenaam aanmaakt dan moet je bij de configuratie van de database verbinding de volledige connection string opgeven (zie paragraaf 3.3.2). Start Net configuration Assistant en kies Local Net service name configuration. Maak de Net service naam aan volgens onderstaande stappen:
TimeTell Technische Opzet
19/84
Versie 9 juli 2015
Geef hier de Oracle service naam op van de database server.
TimeTell Technische Opzet
20/84
Versie 9 juli 2015
Geef hier de naam van de server op waarop Oracle draait.
TimeTell Technische Opzet
21/84
Versie 9 juli 2015
Kies om de connectie te testen en geef in dat scherm de login gegevens op. Klik op Change Login en geef de login gegevens op van de zojuist aangemaakte TimeTell user.
Als de test gelukt is kies je Next.
TimeTell Technische Opzet
22/84
Versie 9 juli 2015
Geef de net service een naam. Hier is gekozen voor TimeTell maar dat mag natuurlijk ook een andere naam zijn. Je hebt deze naam nodig bij het configureren van de database verbinding in TimeTell (zie paragraaf 3.3.2 Configuratie database verbinding). N.B. Als men een ORA-12640 melding krijgt bij het draaien van TimeTell als service dan kan dat opgelost worden door in SQL.ORA file de volgende regel in te stellen: SQLNET.AUTHENTICATION_SERVICES = (NONE)
TimeTell Technische Opzet
23/84
Versie 9 juli 2015
3.2.4. SQL Server 3.2.4.1. Installatie en configuratie MS SQL Server 1. Zorg dat MS SQL Server is geïnstalleerd (versie 2005 of hoger, geen Express/MSDE variant). 2. Start de SQL Server Management Studio 3. Vraag de server properties op en ga naar security. Verifieer dat “Server authentication” is ingesteld op “SQL Server Authentication en Windows Authentication” :
4. Maak een nieuwe login aan voor TimeTell.
TimeTell Technische Opzet
24/84
Versie 9 juli 2015
Let op dat je bij login opgeeft dat het wachtwoord niet hoeft te worden aangepast. N.B. De default database wordt later ingesteld.
5. Maak een lege database aan met de naam “Timetell”
TimeTell Technische Opzet
25/84
Versie 9 juli 2015
6. Maak de in de vorige stap aangemaakte timetell_user login de Owner van de database.
7. Ga naar de eerder aangemaakte login en kies Properties.
TimeTell Technische Opzet
26/84
Versie 9 juli 2015
8. Stel de default database in op de zojuist aangemaakte TimeTell database.
TimeTell Technische Opzet
27/84
Versie 9 juli 2015
9. Ga naar de User mapping en noteer aan welke user deze login is gekoppeld. Verifieer tevens dat de database role db_owner is aangevinkt onderin.
10. Ga voor de aangemaakte TimeTell database naar Security en kies de user waaraan de timetell_user login was gekoppeld (dbo) en kies Properties.
TimeTell Technische Opzet
28/84
Versie 9 juli 2015
11. Zorg dat bij schemas en database role db_owner is aangevinkt voor deze user.
12. Sluit de SQL Server Management Studio af. N.B. Als de database server een andere is dan de TimeTell applicatieserver dan moet tevens de SQL server client worden geïnstalleerd op de TimeTell applicatieserver. Zorg dat op deze applicatieserver ook tenminste MDAC 2.8 SP1 is geïnstalleerd.
TimeTell Technische Opzet
29/84
Versie 9 juli 2015
SQL Server memory configuratie SQL Server heeft de gewoonte om gedurende de tijd steeds meer geheugen in gebruik te nemen. Dit kan verholpen worden door de SQL server te stoppen en vervolgens te herstarten. Men kan ook kiezen voor een preventieve aanpak door het geheugen dat de SQL server mag gebruiken te beperken. Het instellen van het geheugen gebruik doet men door op de rechter muisknop te klikken als men op het niveau boven databases staat. Kies nu voor de properties/eigenschappen. Een window verschijnt met verschillende tabbladen en één daarvan is voor het memory/geheugen bestemd. Vul hier de gewenste waarden in.
TimeTell Technische Opzet
30/84
Versie 9 juli 2015
3.3. Setup TimeTell applicatieserver 3.3.1. Installatie De installatie van de applicatieserver bestaat uit de volgende stappen: 1. Ga naar de Windows server die gaat fungeren als applicatie server. 2. Installeer de TimeTell server m.b.v. TTINSTALL_SERVER_8.x.x.x.exe en doorloop onderstaande schermen:
Klik op ‘Volgende’
TimeTell Technische Opzet
31/84
Versie 9 juli 2015
Kies de locatie waar u Timetell wilt installeren en klik op ‘Volgende’. N.B. Zorg dat de SYSTEM account alle rechten heeft op de TimeTell directory
Vink de optie taalbestanden aan als er sprake is van een meertalige installatie.
TimeTell Technische Opzet
32/84
Versie 9 juli 2015
Klik op ‘Volgende’
Selecteer welk databasetype u gaat gebruiken. Afhankelijk daarvan zal één van onderstaande meldingen getoond worden. Hoe de database geïnstalleerd moet worden staat beschreven in hoofdstuk 3.2.
TimeTell Technische Opzet
33/84
Versie 9 juli 2015
FireBird
Oracle
SQL Server
TimeTell Technische Opzet
34/84
Versie 9 juli 2015
Klik op ‘Installeren’
TimeTell wordt geïnstalleerd…
TimeTell Technische Opzet
35/84
Versie 9 juli 2015
In de volgende paragraaf staat beschreven hoe de verbinding naar de database moet worden geconfigureerd.
TimeTell Technische Opzet
36/84
Versie 9 juli 2015
3.3.2. Configuratie database verbinding Na de installatie moet de verbinding naar de database geconfigureerd worden: 1. Start de Timetell Administrator via het Windows opstart menu. 2. Ga naar menu Configuratie, Database en open TTData.ini in de TimeTell directory. 3. Vul vervolgens de database instellingen (zie beschrijvingen hieronder) U kunt de database verbinding testen door in de TimeTell Administrator te kiezen voor menu Bestand, Open database. Selecteer vervolgens TTData.ini. Als onderin de statusbalk TTData.ini verschijnt dan was de database verbinding succesvol.
Configuratie FireBird
Vul hier de installatie instellingen in (zie paragraaf 3.2.1 FireBird): Server name: User name: Password:
:<pad naar de database> Loginnaam voor de database Wachtwoord voor de database
N.B. Met de optie Vertalen kan worden opgegeven of de systeemtabellen in deze database moeten worden vertaald. Dit kan gebruikt worden als u meerdere databases heeft (bijvoorbeeld meerdere landen) en per database wil opgeven of de systeemtabellen (autorisaties, keuzelijsten e.d.) vertaald moeten worden. N.B. Middels de optie ‘Encrypted’ wordt het wachtwoord versleuteld opgeslagen in TTData.ini. Let op: Zorg dat TIMETELL.GDB wordt opgenomen in de dagelijkse backup procedure!
TimeTell Technische Opzet
37/84
Versie 9 juli 2015
Configuratie Oracle
Vul hier de installatie instellingen in (zie paragraaf 3.2.3 Oracle): Server name: User name: Password:
Naam van de Oracle netservice die toegang geeft tot de database Loginnaam voor de database Wachtwoord voor de database
De tabellen en de indexen worden aangemaakt in de default tablespace van de gebruiker. Als de indexen in een aparte tablespace moeten worden aangemaakt dan kan die hier worden opgegeven. Als je geen netservicename had geconfigureerd dan kun je bij server name ook een connection string opgeven: (description=(address=(protocol=TCP)(host=databaseservername) (port=1521))(connect_data=(service_name=oracleservicename))) N.B. Met de optie Vertalen kan worden opgegeven of de systeemtabellen in deze database moeten worden vertaald. Dit kan gebruikt worden als u meerdere databases heeft (bijvoorbeeld meerdere landen) en per database wil opgeven of de systeemtabellen (autorisaties, keuzelijsten e.d.) vertaald moeten worden. N.B. Middels de optie ‘Encrypted’ wordt het wachtwoord versleuteld opgeslagen in TTData.ini. Let op: Zorg dat de TimeTell tablespace wordt opgenomen in de dagelijkse backup procedure!
TimeTell Technische Opzet
38/84
Versie 9 juli 2015
Configuratie MS-SQL server
Vul hier de installatie instellingen in (zie paragraaf 3.2.4 SQL Server): Server name: Database name: User name: Password:
Naam van de server waarop SQL-server draait Naam van de TimeTell database Loginnaam voor de database Wachtwoord voor de database
Voor SQL-server wordt geadviseerd om gebruik te maken van de optie OLEDB. Hiervoor is het noodzakelijk dat de SQL-server client is geïnstalleerd op de server waarop TimeTell is geïnstalleerd (in veel Windows server versie is dat standaard al het geval). Er wordt dan contact gemaakt met de database server middels OLEDB in plaats van DBLIB. Sinds SQL-server 2005 moet OLE DB worden gebruikt omdat DBLIB niet meer wordt ondersteund door Microsoft. Als een specifieke instance gekozen moet worden, vul dan bij server name de volgende instellingen in: <SERVER>\, Als je gebruik wilt maken van SQL server Windows Authentication laat dan de naam/wachtwoord leeg en zorg dat de TimeTell Application Server service draait onder de juiste windows account. N.B. Met de optie Vertalen kan worden opgegeven of de systeemtabellen in deze database moeten worden vertaald. Dit kan gebruikt worden als u meerdere databases heeft (bijvoorbeeld meerdere landen) en per database wil opgeven of de systeemtabellen (autorisaties, keuzelijsten e.d.) vertaald moeten worden. N.B. Middels de optie ‘Encrypted’ wordt het wachtwoord versleuteld opgeslagen in TTData.ini. Let op: Zorg dat de TimeTell database wordt opgenomen in de dagelijkse backup procedure!
TimeTell Technische Opzet
39/84
Versie 9 juli 2015
3.3.3. Initialiseer database Na de installatie en de configuratie van de database verbinding, kan de database geinitialiseerd worden. Dat staat beschreven in deze paragraaf. N.B. Deze stap is niet nodig voor gebruikers van FireBird. Die database is al geinitialiseerd. 1. Start de Timetell Administrator via het Windows opstart menu. 2. Ga naar menu Configuratie, Database en open TTData.ini in de TimeTell directory.
3. Kies Importeer Database in het menu Bestand .
4. Kies TimeTell.gdb in de data directory op de server. 5. Zorg dat alle tabellen in de keuzelijst zijn geselecteerd (default)
6. Klik op OK om de lege TimeTell database te vullen met initiële tabellen.
TimeTell Technische Opzet
40/84
Versie 9 juli 2015
3.3.4. Configuratie applicatieserver Verder kan men nog de applicatieserver instellen. 1. 2.
Start de Timetell Administrator via het Windows opstart menu. Ga naar menu Configuratie, Server:
Default communiceren de TimeTell clients met de applicatieserver via TCP/IP poort 211. Als op de server een andere poort wordt gekozen dan moet dit ook aangepast worden in TTClient.ini bij de client installaties (Port=). In plaats van een TCP/IP verbinding kan de TimeTell client ook een HTTP verbinding maken. Dit is een iets minder snelle verbinding maar komt wel makkelijker door firewalls heen. Dit kan bijvoorbeeld worden gebruikt voor medewerkers met een lokale client installatie voor gebruik thuis of onderweg. Stel hiervoor de gewenste HTTP poort in (bv. poort 80). Dit moet dan ook worden aangepast worden in TTClient.ini bij de client installaties: Host=http://<servernaam>:. Als met http ook geen verbinding gemaakt kan worden, dan is WINHTTP nog een optie. Verder is het mogelijk om poorten te configureren voor IPv6. Bij gebruik van HTTPS moet een certificaat worden ingelezen met de Maak certificaten knop. Hiervoor is het nodig om OpenSSL te installeren (zie paragraaf 3.7). De vertalen optie stelt de taal in voor meldingen van de server. Deze taal instelling wordt ook gebruikt door TTAdmin.exe. Als de clients lokaal zijn geïnstalleerd dan kan ingesteld worden dat als op de TimeTell server een update van TimeTell is geïnstalleerd de TimeTell clients automatisch een nieuwe client kunnen downloaden. Hiervoor moet de optie Downloads toestaan worden aangevinkt in dit scherm. N.B. In Windows Vista en hoger moet Windows Gebruiker Beheer (UAC) zijn uitgeschakeld om de lokale client te kunnen updaten. De gekozen instellingen worden opgeslagen in TTServer.ini.
TimeTell Technische Opzet
41/84
Versie 9 juli 2015
3.3.5. Configuratie services TimeTell heeft een aantal services die kunnen worden geconfigureerd. 1. Start de Timetell Administrator via het Windows opstart menu. 2. Ga naar menu Configuratie, Services:
In dit scherm kunnen de volgende services worden geïnstalleerd en gestart: Service Info Applicatie server Dit is de basis service die ondermeer de communicatie met de TimeTell clients verzorgt Scheduler Deze service voert diverse taken uit zoals koppelingen en verwerking ziekte Sync Outlook Deze service synchroniseert met Outlook (zie paragraaf 4.3) Sync Clock Deze service synchroniseert met de Kaba en DataFox klokken DataFox HTTP Deze service synchroniseert met de mobiele DataFox terminals via HTTP Webservices Deze service zorgt voor de communicatie met de TimeTell App De eerste twee services staan default aan na installatie. De Sync Outlook service moet eerst verder geconfigureerd worden (zie paragraaf 4.3). De Sync Clock service is alleen nodig als u werkt met Kaba of DataFox klokken. De DataFox HTTP service is alleen nodig als u mobiele DataFox terminals gebruikt. De Webservices service is alleen nodig als u de App module heeft. N.B. Het is mogelijk om de laatste 4 services op een andere server te installeren. De installatie en configuratie moet dan echter handmatig gebeuren. In paragraaf 4.3 over Outlook synchronisatie staat beschreven hoe dit moet gebeuren voor de Sync Outlook service. TimeTell Technische Opzet
42/84
Versie 9 juli 2015
3.4. Setup TimeTell windows client U kunt bij de installatie ervoor kiezen om TimeTell op een centrale plek op de fileserver te installeren. Dit hoeft dan slechts één keer te gebeuren, waarna een snelkoppeling gedistribueerd kan worden naar de gebruikers. Een andere optie is om TimeTell te installeren op de lokale PC’s/Laptops. In dat geval moet de installatie op ieder werkstation worden uitgevoerd. 1. Installeer de TimeTell Client m.b.v. TTINSTALL_CLIENT_8.x.x.x.exe naar een gedeelde directory op de Fileserver vanaf waar de client gestart kan worden. Zorg dat de gebruikers alleen Read/Execute rechten hebben op deze directory.
TimeTell Technische Opzet
43/84
Versie 9 juli 2015
2.
Geef de locatie (lokaal of op fileserver) waar de TimeTell Client geïnstalleerd dient te worden.
3. Als u ook rapporten wil ontwerpen vinkt u de optie Report Designer aan. Voor een meertalige installatie vinkt u de optie Taalbestanden aan. Als u een lokale installatie doet vink dan de optie Snelkoppelingen aan.
TimeTell Technische Opzet
44/84
Versie 9 juli 2015
4. Geef de naam van de map in het startmenu voor de snelkoppelingen.
5. Vul tijdens de installatie bij Verbinding instellingen het IP adres of de hostname van de TimeTell server in (deze gegevens kunnen opgevraagd worden m.b.v. het commando ipconfig /all op de server). N.B. Als in paragraaf 3.3.4 Configuratie applicatieserver de HTTP poort is ingesteld dan kan dit hier bij server worden opgegeven: http://<servernaam>:.
TimeTell Technische Opzet
45/84
Versie 9 juli 2015
6. Controleer of de instellingen juist zijn en installeer de client
7. Bij een lokale installatie kunt u de client starten middels de aangemaakte snelkoppeling. Bij een fileserver installatie maakt u een snelkoppeling aan naar TTClient.exe en eventueel TTReport.exe op de share en verstuurt deze naar de gebruikers.
Tip: U kunt de contactgegevens die zichtbaar zijn in menu Help Info vervangen door uw eigen contactgegevens door een tekstbestand TTContactInfo.txt met deze gegevens te plaatsen in dezelfde directory als TTClient.exe.
TimeTell Technische Opzet
46/84
Versie 9 juli 2015
3.5. Setup TimeTell web client De web client wordt normaliter geïnstalleerd door onze consultants in samenwerking met de systeembeheerder. Deze paragraaf beschrijft de installatieprocedure stap voor stap. Als u zelf de installatie uitvoert adviseren wij om goed te controleren of iedere stap is gevolgd. Het is uiteraard altijd mogelijk om nog een consultant in te zetten mocht hier behoefte aan zijn.
3.5.1. Installatie U kunt de webclient op dezelfde server installeren als de TimeTell server, maar het is ook mogelijk om dit op een andere server te doen (bijvoorbeeld een server in de DMZ). Op de server waar de webclient wordt geïnstalleerd moeten de TimeTell webservices zijn geïnstalleerd en geconfigureerd (zie hoofdstuk 3.6). Voor de installatie heeft u vooraf de volgende gegevens nodig: TimeTell database: servernaam, databasenaam, login TimeTell webservice: servernaam, poort Gebruik vervolgens de TTINSTALL_WEB_8.x.x.x.exe tool om de web installatie uit te voeren. Installeer de TimeTell Web Client m.b.v. TTINSTALL_WEB_8.x.x.x.exe. De installatie bestaat uit de volgende stappen:
TimeTell Technische Opzet
47/84
Versie 9 juli 2015
Geef aan in waar de webclient geïnstalleerd moet worden.
Vink “Configureer IIS” aan om de applicationpool en web application aan te maken in IIS. Vink “Configuratie bestanden aanmaken” aan om de database en webservice in te stellen.
TimeTell Technische Opzet
48/84
Versie 9 juli 2015
Geef aan in welke taal de webclient getoond moet worden.
Geef aan onder welke website de webclient geïnstalleerd moet worden en wat de naam is.
TimeTell Technische Opzet
49/84
Versie 9 juli 2015
Geef de TimeTell database instellingen op. Deze kunnen met de knop “Lees inifile” worden gelezen uit de TTData.ini in de TimeTell server directory. N.B. Voor Oracle moet bij database server de volledige connection string worden opgegeven: (description=(address=(protocol=TCP)(host=databaseservername) (port=1521))(connect_data=(service_name=oracleservicename)))
Geef de TimeTell webservice instellingen op. Deze kunnen met de knop “Lees inifile” worden gelezen uit de TTWebservices.ini in de TimeTell webservice directory. TimeTell Technische Opzet
50/84
Versie 9 juli 2015
Controleer de gekozen instellingen voordat de installatie wordt uitgevoerd.
TimeTell Technische Opzet
51/84
Versie 9 juli 2015
Na installatie kan de webclient getest worden (http://localhost/TimeTell). De eerste keer zal het openen wat langer duren.
TimeTell Technische Opzet
52/84
Versie 9 juli 2015
3.5.2. .NET Framework Als u een HTTP-error 500.21 krijgt moet is er een probleem met het .NET 4.5.1 Framework en moet u deze (opnieuw) installeren.
Deze kunt u downloaden van http://www.microsoft.com/nl-NL/download/details.aspx?id=40779 of van onze downloadsectie. Verifieer ook bij de Windows configuratie of de optie ASP.NET 4.5 is aangevinkt:
TimeTell Technische Opzet
53/84
Versie 9 juli 2015
3.5.3. Oracle Data Access Components (ODAC) Als u gebruik maakt van Oracle dan moeten ook Oracle .NET en ASP.NET Data Access providers geïnstalleerd worden (32 bits). Als die niet geïnstalleerd zijn verschijnt de volgende foutmelding:
De Oracle Data Access Components kunnen gedownload worden van onze downloadsectie of van de Oracle website: http://www.oracle.com/partners/campaign/utilsoft-086879.html Daar staat de installatie voor de Oracle 12 data providers, maar die werken in combinatie met Oracle 10, 11 en 12 databases. Bij de installatie moeten deze opties worden aangevinkt:
TimeTell Technische Opzet
54/84
Versie 9 juli 2015
3.5.4. Configuratie webservice achteraf aanpassen Tijdens de installatie wordt gevraagd om verbindingsgegevens met de webservice. Als die niet goed waren ingevuld kunnen die eventueel worden aangepast in het appSettings.config bestand:
Geef hier de server en de poort op en vergeet de forward slash aan het einde niet! De webservice verbinding wordt alleen in de backend gebruikt dus localhost als servernaam is voldoende als de webservice op dezelfde server staat.
TimeTell Technische Opzet
55/84
Versie 9 juli 2015
3.5.5. Configuratie Windows Authentication Default werkt de TimeTell webclient met een login dialoog. Als de webclient gebruikt wordt binnen het eigen domein, dan is het ook mogelijk om Windows authenticatie aan te zetten. U wordt dan automatisch aangemeld met uw netwerk login. Om dit aan te zetten moet u de optie “Authentication” openen bij de website:
In dat scherm moet de optie “Forms authentication” worden uitgezet en “Windows authentication” moet aangezet worden:
Als deze opties niet voorkomen in uw lijst dan moeten bij de IIS installatie (Windows onderdelen) ook de opties Security\Windows authentication en Developer options\ASP.NET worden aangevinkt. Het is wel belangrijk dat de gebruiker met dezelfde loginnaam voorkomt in de TimeTell database. Als u gebruik maakt van Windows Authenticatie, dan is de optie “Login als vervanger” niet beschikbaar in de webclient. N.B. Op dit moment is Windows Authenticatie alleen beschikbaar bij gebruik van Internet Explorer.
TimeTell Technische Opzet
56/84
Versie 9 juli 2015
3.5.6. Known Issues FireFox In Firefox krijgt u bij een waarschuwing een checkbox ‘Voorkomen dat deze pagina extra dialoogvensters maakt’. Als een gebruiker dit aanklikt krijgt hij geen meldingen meer. U kunt dit gedrag als volgt uitzetten: • • • • • •
Kopieer de volgende tekst: dom.successive_dialog_time_limit Tik in FireFox in: about:config Klik met de rechter muisknop in het scherm en kies Nieuw -> Integer Plak de geselecteerde tekst en druk ok. Vul de waarde 0 in en druk weer ok. Sluit Firefox af om de wijzigingen door te voeren.
Internet Explorer
Compatibiliteitsmodus Als de zogenaamde compatibiliteitsmodus aan staat dan wordt de Timetell web applicatie niet goed weergegeven. In de login pagina wordt er een melding gegeven als deze aan staat, maar mensen kunnen nog wel inloggen. De compatibiliteitsmodus staat standaard aan voor interne websites. U zet dit als volgt weer uit: Methode 1 : • Ga in het menu van Internet Explorer naar Extra -> Instellingen voor de compatibiliteitsweergave -> Intranetsites met compatibiliteitsweergave weergeven. • Zet deze vink uit. Methode 2: • Druk op F12, u komt nu in het developer scherm. • Kies voor een versie die geen compatibiliteitsmodus is (en hoger dan versie 8)
TimeTell Technische Opzet
57/84
Versie 9 juli 2015
3.6. Setup TimeTell webservices De TimeTell app heeft via internet verbinding met uw eigen TimeTell omgeving. Voor deze communicatie moeten de TimeTell webservices worden geïnstalleerd. N.B. De TimeTell Webservice is een op zichzelf staand programma dat op de server kan worden geïnstalleerd. Hiervoor is verder geen IIS of andere webserver programmatuur nodig. De webservices worden ook gebruikt door de TimeTell webclient. Die maakt echter alleen vanaf de webserver zelf contact met deze webservices, dus niet vanaf buiten. De TimeTell webservice wordt standaard mee geïnstalleerd bij een TimeTell server installatie. Na installatie moet de webservice volgens onderstaande stappen geconfigureerd worden. Volg de stappen in paragraaf 3.6.3 om de webservice op een andere server te installeren. Let op: Als de webservice verbinding moet maken via HTTPS , voer dan ook de stappen in paragraaf 3.6.2 uit.
3.6.1. Configuratie webservice Ga naar de TimeTell directory op de server. Open het bestand 'TTWebServices.ini' met een teksteditor (bijvoorbeeld het Windows Kladblok), zoek de sectie [WebServices] op en stel 'Port' in op het gewenste poortnummer. De default poort is 8081. Zorg ervoor dat bij aanpassingen geen ';' meer voor de regel staat (anders is de regel uitgecommentarieerd).
Start de TimeTell Administrator en ga naar het menu 'Services', 'System Tray Processen' en start 'TimeTell Webservice' om te kunnen controleren of deze service correct functioneert.
Het kan zijn dat je een foutmelding krijgt omdat de poort bezet is door een ander programma op deze server. Kies in dat geval een andere poort in het eerder genoemde .ini bestand.
TimeTell Technische Opzet
58/84
Versie 9 juli 2015
Soms krijg je de eerste keer ook een vraag van Windows waarbij u kunt aangeven dat het voor deze executable is toegestaan een poort te gebruiken.
Kies hierbii voor Toegang toestaan. Als alles goed gaat verschijnt een venster van de webservice:
Je dient dit venster weer te sluiten (het system tray proces wordt gestopt). De test is dan geslaagd. Ga vervolgens naar het menu 'Configuratie', 'Services'. Als 'Webservices' niet is geïnstalleerd, installeer deze dan. Stel de webservices in op automatisch starten alvorens deze te starten.
N.B. Als de webservices ook gebruikt gaan worden voor de TimeTell app, dan dient de poort benaderbaar te zijn vanaf buiten het interne netwerk. Als je deze benaderbaarheid wilt testen, dan kan dat door op een PC de hostnaam + poortnummer op te geven in een webbrowser (bijvoorbeeld http://servicenaam.domeinnaam.nl:8081/). Je komt dan op een pagina terecht met het versienummer van de TimeTell Webservices. Als dit niet lukt, dan is de webservice niet benaderbaar. Test in dat geval nog even of dit vanaf de server zelf wel goed werkt, om te bepalen of er een router/firewall probleem is.
TimeTell Technische Opzet
59/84
Versie 9 juli 2015
3.6.2. Webservice via HTTPS Het is ook mogelijk om de TimeTell App via HTTPS te laten communiceren met de webservice. Hiervoor is het nodig om eerst OpenSSL te installeren (zie paragraaf 3.7). In TTAdmin is hiervoor de configuratie optie HTTPS certificaten toegevoegd:
Bii Basis export certificaat kan men de locatie van het certificaatbestand opgeven (.pfx). Bii Root certificaat kan men optioneel de locatie van het root certificaatbestand opgeven (.cer). Geef vervolgens het wachtwoord op dat bij het certificaat hoort. Voor het verwerken van het certificaat is Open SSL nodig (zie paragraaf 3.7). De certificaat gegevens worden opgeslagen in een aparte Certificates map. Default wordt die map aangemaakt in de TimeTell directory. Met de knop Bestanden aanmaken worden de TimeTell certificaat bestand aangemaakt. Vervolgens kan met de knop Test HTTPS worden getest of dit goed functioneert. Hiervoor wordt default poort 8443 gebruikt om te testen. Die testpoort kan hier worden aangepast. Als de test goed is verlopen kan de HTTPS instelling worden doorgevoerd in de webservices.ini. Hierna moet de webservice nog wel herstart worden om de instellingen door te voeren. N.B. De gebruikers moeten in de TimeTell App bij instellingen de optie SSL aanzetten om via HTTPS te communiceren. Voor de webclient moet in de appsettings.config worden aangegeven dat er een HTTPS verbinding wordt gemaakt naar de webservice.
TimeTell Technische Opzet
60/84
Versie 9 juli 2015
3.6.3. Installatie webservice op andere server Als u de TimeTell webservice op een andere server dan de TimeTell server wilt installeren dan volgt u onderstaande stappen (lees eerst de voorgaande paragrafen). Let op: Als de webservice verbinding moet maken via HTTPS , voer dan ook de stappen in paragraaf 3.6.2 uit. Installeer de TimeTell Webservice m.b.v. TTINSTALL_WEBSERVICE_8.x.x.x.exe.
TimeTell Technische Opzet
61/84
Versie 9 juli 2015
Geef de map aan waar de webservice geïnstalleerd moet worden.
Vink taalbestanden aan als de webservice niet in het nederlands moet draaien.
TimeTell Technische Opzet
62/84
Versie 9 juli 2015
Geef aan op welke server TimeTell draait, via welke poort er verbinding gemaakt kan worden. Geef ook de poort op waarop de webservice moet gaan draaien (die moet niet in gebruik zijn).
Bevestig de opgegeven instellingen.
TimeTell Technische Opzet
63/84
Versie 9 juli 2015
Nadat de installatie is uitgevoerd moet eventueel nog een poort in de externe firewall opengezet worden om de webservice vanaf buiten benaderbaar te maken. Dat is alleen nodig als u gebruik maakt van de TimeTell app.
Test of de webservice reageert (zie paragraaf 3.6.1).
TimeTell Technische Opzet
64/84
Versie 9 juli 2015
3.6.4. Instellingen in de App Ga naar Instellingen:
-
Vul de TimeTell gebruikersnaam in. Vul het wachtwoord in dat je voor TimeTell gebruikt (bijvoorbeeld het netwerk wachtwoord). Vul bij server de hostnaam in, gevolgd door een dubbele punt en het poortnummer (bijvoorbeeld servicenaam.domeinnaam.nl:8081).
N.B. Als er gebruik wordt gemaakt van HTTPS verkeer, dan moet bij Modus de optie SSL aangezet worden. Als je via een intern wifi netwerk test, kan dat de naam van de server zijn of het interne IP adres. Als je van buiten (via GPRS/3G) test, dan moet het de naam zijn waarop de server te benaderen is vanaf buiten het interne netwerk. N.B. De poort dient eveneens benaderbaar te zijn vanaf buiten het interne netwerk. Als je deze benaderbaarheid wilt testen, dan kan dat door op een PC de hostnaam + poortnummer op te geven in een webbrowser (bijvoorbeeld http://servicenaam.domeinnaam.nl:8081/). Je komt dan op een pagina terecht met het versienummer van de TimeTell Webservices. Als dit niet lukt, dan is de webservice niet benaderbaar. Test in dat geval nog even of dit vanaf de server zelf wel goed werkt, om te bepalen of er een router/firewall probleem is.
TimeTell Technische Opzet
65/84
Versie 9 juli 2015
3.7. Installatie Open SSL In TimeTell kunnen op verschillende plekken beveiligde verbindingen worden gebruikt. Bijvoorbeeld als de applicatieserver of de webservice over HTTPS moeten communiceren. Dit is ook van toepassing bij koppelingen die via een beveiligde SOAP verbinding gegevens ophalen. Ook als de applicatieserver is ingesteld voor secure LDAP authenticatie wordt SSL gebruikt. Om dit mogelijk te maken moet OpenSSL zijn geïnstalleerd op de server. Dat is een veel toegepaste tool om SSL verbindingen mogelijk te maken. Meer informatie hierover is te vinden op hun website: https://www.openssl.org/ . Hier is ook de meest recente versie te vinden: http://www.openssl.org/related/binaries.html. N.B. Voor TimeTell is de 32 bits versie van OpenSSL benodigd. De setup kan ook gedownload worden van onze website. De installatie van OpenSSL bestaat uit twee onderdelen. Eerst dient vcredist_x86.exe te worden geïnstalleerd (Visual C++ Redistributables). Vervolgens moet de OpenSSL setup worden uitgevoerd: Win32OpenSSL_1_0_2.exe. Volg de standaard opties bij de twee installaties.
TimeTell Technische Opzet
66/84
Versie 9 juli 2015
4. Extra configuratie opties 4.1. Configuratie authenticatie gebruikers Als men in TimeTell gaat werken met een login dialoog dan kan men de login gegevens verifiëren bij een authenticatieserver zodat de gebruiker de netwerk login gegevens kan gebruiken. 1. 2. 3. 4.
Ga naar de server die fungeert als applicatieserver. Start de TimeTell Administrator via het Windows opstart menu. Ga naar menu Configuratie, Authenticatie en open TTData.ini in de TimeTell directory Kies daar voor SSPI of LDAP en test de verbinding met de Test knop. SSPI SSPI kan het beste worden gebruikt in een omgeving met windows authenticatie servers. SSPI is altijd secure. Geef bij deze optie het Domain op waar de authenticatie moet plaatsvinden. LDAP LDAP (standaard port 389) kan onder meer worden gebruikt in een omgeving met Novell authenticatie servers. Bij LDAP server wordt de server opgegeven die de authenticatie zal uitvoeren. Domain prefix is de prefix voor usernaam, meestal domeinnaam\. Voor Novell is het hier ook mogelijk om gebruik te maken van een uitgebreide aanmeldstring. De loginnaam wordt dan ingevuld op de plek waar “%s” staat: Domain prefix= cn=%s,ou=ict,o=bedrijf Om gebruik te kunnen maken van Secure LDAP (standaard port 636) is het nodig om OpenSSL te installeren (zie paragraaf 3.7). Wanneer dit is gebeurd zal de optie Secure LDAP ook selecteerbaar zijn. Om te testen of een verbinding met de LDAP server mogelijk is kan naast TTAdmin ook gebruik worden gemaakt van LDP. Dit is een onderdeel van Support Tools Utility voor Windows van Microsoft. N.B. na installatie dienen TTAdmin en de TimeTell Applicatie Server opnieuw gestart te worden. Mocht de optie secure SSL zijn aangezet door een aanpassing in TTData.ini ipv van de interface van TTAdmin en de OpenSSL is niet geinstalleerd dan zal TimeTell in de eventlog hier een foutmelding van geven.
TimeTell Technische Opzet
67/84
Versie 9 juli 2015
Single sign-on verficatie Als men TimeTell start zonder logindialoog (single sign-on) dan wordt gebruik gemaakt van de Windows loginnaam voor authenticatie. Als extra beveiliging kan hier ook nog een lijst met domeinnamen (komma gescheiden) worden opgegeven voor controle op username + domein.
TimeTell Technische Opzet
68/84
Versie 9 juli 2015
4.2. Configuratie E-Mail notificatie op server (SMTP) Als TimeTell automatisch mail moet versturen vanuit de scheduler (bijvoorbeeld voor E-Mail notificatie of voor ingeplande rapporten) dan moeten de E-mail instellingen worden opgegeven. 1. Ga naar de server die fungeert als applicatieserver. 2. Start de TimeTell Administrator via het Windows opstart menu. 3. Ga naar menu Configuratie, E-mail en open TTData.ini in de TimeTell directory Vul de instellingen in:
Mail server : Naam of IP adres van de SMTP server Mail server gebruiker: Gebruikers naam om in te loggen op de SMTP server (optioneel) Mail server wachtwoord: Wachtwoord om in te loggen op de SMTP server (optioneel) Mail afzender: E-mail adres namens wie de SMTP notificatie wordt verstuurd Gebruik TLS: Als deze waarde aan staat wordt er gebruik gemaakt van TLS authenticatie voor versturen van mail via SMTP (bv. voor GMAIL). Test de instellingen met de Test knop. N.B. Om in TimeTell E-mail berichten te kunnen versturen via SMTP moeten de virusscanner en andere beveiligingssoftware dit toestaan. Verkeer over poort 25 moet zijn toegestaan voor TTAdmin.exe, TTTasks.exe, TTClient.exe and TTServer.exe. Verder moet de TimeTell server relay mogelijkheden hebben op de hier vermelde SMTP server (Mail server).
TimeTell Technische Opzet
69/84
Versie 9 juli 2015
4.3. Configuratie Exchange synchronisatie op server Het is mogelijk om de TimeTell agenda’s automatisch te laten synchroniseren met Exchange op de server via Exchange Web services. Deze paragraaf beschrijft de benodigde stappen. Na onderstaande configuratie moet in TimeTell per gebruiker het synchronisatieprofiel en het mailbox adres ingevuld worden. Dit staat beschreven in de handleiding Agenda. Allereerst maakt u uw domein een gebruiker aan met een (mailbox en) agenda op Exchange Server. Dit is de ‘gebruiker’ die de synchronisatie uitvoert. Deze gebruiker moet rechten hebben om de agenda’s van alle medewerkers te wijzigen (zie volgende sectie). Voor het gemak noemen we die gebruiker verder timetell . Kies menu configuratie Exchange (Agenda) en open de data inifile.
Vul in op welke URL de Exchange webservices benaderd kunnen worden. Geef ook de login-gegevens van de timetell gebruiker. Let op dat u hierbij het primaire SMTP email adres van het account gebruikt. Binnen een organisatie kan iemand meerdere E-mail adressen hebben. In Outlook kun je dat zien door de eigenschappen van een contactpersoon op te vragen en naar tabblad E-mail adressen te gaan. Daar staat vóór het primaire adres SMTP in hoofdletters. Met de Test knop kan de verbinding getest worden. Als u hier geen verbinding krijgt kijk dan naar de informatie in de volgende paragraaf.
Problemen met inloggen op Exchange Webservice Als u bij de Test knop onderstaande melding krijgt, dan zijn de logingegevens niet correct:
Probeer dan om in de browser de EWS URL te openen. U krijgt dan een loginscherm te zien voor de Exchange Web Services. Als u logingegevens heeft waarmee u op deze pagina kunt inloggen, dan kunt u diezelfde logingegevens gebruiken in TimeTell.
TimeTell Technische Opzet
70/84
Versie 9 juli 2015
Als u bij de Test knop onderstaande melding krijgt, dan verschilt het primaire SMTP adres van de User Principal Name (UPN):
Wij gebruiken het email adres van de gebruiker als de login voor Exchange server. Zo’n inlog via het email adres in plaats van de domein/username combinatie heet de User Principal Name (UPN, zie http://searchexchange.techtarget.com/definition/User-Principal-Name). Deze kan anders zijn dan het primaire SMTP adres (zelfs de domeinnaam in de email kan verschillen) en dat gaat niet altijd goed. Als je in zo’n situatie (UPN email is ongelijk aan primary SMTP) inlogt met je UPN kun je fouten krijgen. De kunst is dus om een email adres te gebruiken dat voor beide doelen bruikbaar is. Een oplossing wordt gegeven in http://www.concurrency.com/infrastructure/change-userprincipal-names-to-match-email-addresses-for-office-365-migration/ . Hierin staat beschreven hoe je alternatieve UPN suffixes kan toevoegen in Active Directory.
4.3.1. Delen van de agenda’s - machtigingen De timetell ‘gebruiker’ moet minimaal Redacteur (Editor) rechten hebben op alle medewerkeragenda’s3,4. Uw medewerkers moeten daarvoor machtigingen voor hun agenda verstrekken aan dat account (of de beheerder stelt dat in). Er zijn verschillende manieren waarop agenda’s gedeeld kunnen worden: 1. Folder sharing - Het delen van de agenda(-folder) met een ander door het versturen van een mail 2. Het publiceren van een agenda - de agenda wordt publiek op het Internet. 3. Het mailen van een agenda als .iCal bestandsbijlage 4. Het machtigen van een ander om de agenda te gebruiken 5. Het instellen van ‘delegate access’ De meest gedocumenteerde methodes 1,2,35 kunnen wij niet gebruiken. De timetell gebruiker heeft dan onvoldoende rechten of de agenda’s zijn te publiek. Wij moeten methode 4 gebruiken, en als ook privé-afspraken gesynchroniseerd moeten worden, methode 5. Dit hoofdstuk geeft voorbeelden van manieren waarop de machtigingen van agenda ingesteld kunnen worden. In Outlook Office programma (door gebruiker): Klik in de Outlook mappenlijst met de rechter muisknop op de Agenda en kies voor Eigenschappen (Properties) en vervolgens Machtigingen (Permissions): 3 4
5
Doe je dat niet, dan krijg je foutmeldingen als: Access is denied. Check credentials and try again Door deze opzet met een aparte timetell gebruiker hebben uw medewerkers nog steeds geen inzicht in elkaars agenda, anders dan wat u daar apart al voor opgezet heeft. Bijvoorbeeld in deze YouTube clip van Microsoft https://www.youtube.com/watch?v=-pJBtg6-0zg
TimeTell Technische Opzet
71/84
Versie 9 juli 2015
Voeg een machtiging toe voor gebruiker TimeTell waarbij je die machtigingsniveau (permission level) Redacteur (Editor) geeft In Exchange Admin Center (door beheerder) De beheerder kan ook in een keer de gedeelde toegang regelen zodat de gebruikers dat niet allemaal op bovenstaande manier hoeven te doen. Ga daarvoor naar het Admin Exchange Center (via IE te benaderen op https://mailservernaam/ecp) , dan naar Ontvangers, Postvakken:
TimeTell Technische Opzet
72/84
Versie 9 juli 2015
Dubbelklik op het postvak van een medewerker, kies Postvakoverdracht, en voeg in de lijst Volledige toegang gebruiker timetell toe:
TimeTell Technische Opzet
73/84
Versie 9 juli 2015
4.3.1.1. Privé-afspraken synchroniseren Als u gebruikt wilt maken van de mogelijkheid om ook privé-afspraken te synchroniseren is het verstrekken van machtigingen op bovenstaande manier niet genoeg. De medewerkers moeten dan ‘delegate access’ voor hun agenda inschakelen6: Outlook 2010 of later (door gebruiker) Ga naar menu Bestand – Info – Accountinstellingen - Gemachtigden Kies Toevoegen en voeg de gebruiker TimeTell toe: 6
Als u delegate access niet inschakelt en toch wijzigingen in privéafspraken aanzet in het synchronisatieprofiel krijgt u foutmeldingen dat de afspraak in Exchange niet gevonden kan worden.
TimeTell Technische Opzet
74/84
Versie 9 juli 2015
Geef hem de instellingen van het ‘Machtigingen’ scherm:
Outlook 2007 (door gebruiker; Engels voorbeeld) Ga naar menu Tools – Options – Delegates Kies Add en voeg de gebruiker TimeTell toe:
TimeTell Technische Opzet
75/84
Versie 9 juli 2015
Geef deze de volgende instellingen:
4.3.2. Office 365 U kunt ook agenda’s synchroniseren met die van Office 365. De Exchange Web Services URL is dan https://outlook.office365.com/ews/exchange.asmx Voor de Exchange Server gebruiker neemt u het volledige login emailadres dat u voor Office365 gebruikt. Dit is meestal van de vorm naam@domeinnaam .onmicrosoft.com. Ook hier gelden de voorwaarden van de vorige paragrafen voor het delen van de agenda’s, maar in Office365 heeft Microsoft het afgeven van machtigingen (methode 4), delegate access (methode 5) en het delen van een agendafolder (methode 1) gecombineerd door twee niveaus van delen toe te voegen (zie het screenshot hieronder). TimeTell Technische Opzet
76/84
Versie 9 juli 2015
Ga naar de agenda. Klik rechtsboven in de agenda op Delen, tik een deel van de naam timetell en laat het programma de juiste gebruiker selecteren:
U kiest nu voor Editor óf Gemachtigde als u privé-afspraken niet resp. wel wilt synchroniseren. Vervolgens klikt u op Verzenden. De timetell gebruiker ontvangt een mail waar hij verder niets mee hoeft te doen. Video: https://www.youtube.com/watch?v=-pJBtg6-0zg
4.4. Configuratie taalbestanden Met deze optie kan de server vertaling in TimeTell geconfigureerd worden.
Hiermee kun je in 1 keer de taal in te stellen van de server, de databases en de webservices. In het configuratieprofiel kun je de gewenste taal instellen per gebruiker.
TimeTell Technische Opzet
77/84
Versie 9 juli 2015
4.5. Configuratie Google API key De TimeTell app gebruikt Google Location Services voor het bepalen van locaties, routes en afstanden. Om deze functionaliteit beschikbaar te maken kan in TTAdmin bin menu Configuratie een klantspecifieke Google API key worden opgegeven:
Je kan gratis een API key aanvragen bij Google via deze URL: https://developers.google.com/maps/signup Zodra deze is ingesteld komen extra functies in de app beschikbaar (zoals de rittenregistratie).
TimeTell Technische Opzet
78/84
Versie 9 juli 2015
4.6. Configuratie van TimeTell windows client over internet TimeTell heeft diverse mogelijkheden voor locatie onafhankelijke registratie (zie hoofdstuk 2). Naast de webclient en de app is het ook mogelijk om de TimeTell windows client via internet te gebruiken. Deze paragraaf beschrijft hoe dit geconfigureerd kan worden. De thuiswerker hoeft alleen de TimeTell client beschikbaar te hebben op de pc thuis. Deze bestaat uit de volgende bestanden: Bestand TTClient.exe TTClient.ini
Info Timetell client applicatie Configuratie bestand
Deze bestanden kunnen bijvoorbeeld gekopieerd worden vanuit de TimeTell client directory naar een willekeurige directory op de PC thuis. De gebruikers kunnen dan TimeTell starten door op TTClient.exe te dubbelklikken. Het is ook mogelijk om de TimeTell client setup te draaien. Deze zal na de installatie vragen om de naam of het IP adres van de server waarop TimeTell benaderbaar is. Voor thuiswerkers moet de Timetell applicatieserver bereikbaar zijn via een inbelverbinding of via internet. Meestal is een ander IP adres nodig om deze vanaf buiten te benaderen. Vul dit IP adres in bij de laatste stap van de client installatie. Het is ook mogelijk om de server via http te bereiken als dit is ingesteld (zie paragraaf 3.3.4). Vul dan http://<servernaam>:<poort> in als adres. Standaard controleert TimeTell de identiteit van de medewerker door de Windows loginnaam te hanteren. De Windows loginnaam op een pc thuis kan echter anders zijn. Het is mogelijk om een login dialoog aan te zetten in TTClient.ini door de optie Login=Y in te stellen. Deze optie vraagt vervolgens om een loginnaam en een wachtwoord. Dit wachtwoord kan worden ingesteld binnen TimeTell bij menu ‘Medewerker autorisatie’. Naast een TimeTell wachtwoord is ook een login verificatie via Active Directory mogelijk (zie paragraaf 4.1 Configuratie authenticatie gebruikers). Tip 1: Voor medewerkers die de TimeTell lokaal op de laptop hebben staan is het mogelijk om 2 client INI files aan te maken (bv. TTClient_Kantoor.ini en TTClient_Thuis.ini). Bij het starten van TimeTell wordt dan gevraagd met welke INI file je wil starten. Tip 2: Het is mogelijk om de lokale client automatisch te updaten als de optie Downloads toestaan is aangezet in de TimeTell server configuratie. Na een server update worden de lokale clients dan automatisch geupdate. N.B. In Vista en Windows 7 moet Windows Gebruiker Beheer zijn uitgeschakeld om de lokale client te kunnen updaten. Als de download optie aan staat kan een nieuwe gebruiker ook een client setup downloaden via de volgende URL: http://<servernaam>:<poort>/DownloadClient. Via de browser kan men dan de client setup downloaden. N.B. Eventuele andere bestanden die in de <serverdirectory>\ClientDownload map staan worden ook aangeboden.
TimeTell Technische Opzet
79/84
Versie 9 juli 2015
4.7. Opzetten test database In bepaalde situaties is er behoefte aan een extra database waar een en ander uitgeprobeerd kan worden voordat dit in de productiedatabase wordt doorgevoerd. Dit hoofdstuk beschrijft in het kort de stappen die gevolgd moeten worden om dit te realiseren. 1. Maak een extra (lege) database aan. Dit verschilt per database type: a. FireBird: Maak een kopie van het database bestand. Je kan dan timetell.gdb bijvoorbeeld kopiëren naar timetell_test.gdb. b. Oracle: Maak een nieuwe tablespace aan en een aparte login die dit als default database heeft (zie paragraaf 3.2.3 Oracle). c. SQL-server: Maak een lege database aan en een aparte login met sql-server authenticatie die db_owner is van deze database (zie paragraaf 3.2.4 SQL Server). 2. Kopieer ttdata.ini naar ttdata_test.ini 3. Pas ttdata_test.ini aan middels menu Configuratie, Database in TTAdmin: a. FireBird: zorg dat de juiste databasenaam staat vermeld bij SERVER NAME= b. Oracle: zorg dat de username/password wordt gebruikt die was gekoppeld aan de nieuwe tablespace (de Oracle server blijft in principe gelijk). c. SQL-Server: zorg dat de nieuw aangemaakte databasename, username en password wordt ingevuld. 4. Kopieer de database (Bij FireBird is dit al gedaan in stap 1a): a. Start de TimeTell Administrator (ttadmin.exe) b. Kies menu Bestand, Open database en open de productie database (ttdata.ini) c. Kies menu Bestand, Exporteer database en exporteer naar EXPORT.GDB d. Kies menu Bestand, Open database en open de test database (ttdata_test.ini) e. Kies menu Bestand, Importeer database en importeer EXPORT.GDB 5. Maak extra client configuraties aan: a. Ga naar de directory van waaruit de gebruikers de TimeTell client opstarten. b. Kopieer ttclient.ini naar ttclient_test.ini c. Open ttclient_test.ini en stel de volgende regels in: i. Description=TimeTell Test ii. DataSettings=ttdata_test.ini iii. RegistryOffset=test d. Sla de gewijzigde INI file op 6. Als TimeTell nu gestart wordt dan wordt er gevraagd met welke INI file men wil starten (productie of test). Om deze vraag te voorkomen voor de gewone gebruikers moeten de standaard TimeTell snelkoppelingen die gedistribueerd zijn worden uitgebreid met een extra parameter: -ittclient.ini. Dit zorgt er voor dat TimeTell start met ttclient.ini en niet meer vraagt welke INI er gebruikt moet worden. De gebruikers/beheerders die ook de testomgeving moeten benaderen kunnen een snelkoppeling zonder parameter gebruiken. N.B. Het is ook mogelijk om de bestaande client directory te kopiëren naar een andere directory en daar de INI file te plaatsen die naar de testomgeving wijst. Dat voorkomt dat de gebruikers de vraag krijgen welke INI flile gestart moet worden. Het is ook mogelijk dat een TimeTell consultant u helpt om een test database op te zetten.
TimeTell Technische Opzet
80/84
Versie 9 juli 2015
4.8. Opzetten archief database Het is mogelijk om gegevens van oudere jaren over te zetten naar een archief database. Dit kan de performance op de productiedatabase verbeteren als er al enige jaren is gewerkt met TimeTell. De 1. 2. 3.
procedure voor het archiveren staat grofweg uit de volgende stappen: Maak een archief database aan Zet oude data over naar de archief database en verwijder deze uit de productie database Open de archief database vanuit de client om de oude data te benaderen
Hieronder staat een beschrijving van deze stappen (deze moeten vanaf de server worden uitgevoerd). Indien gewenst kan een TimeTell consultant hiermee helpen. 1. Aanmaken archief database Voor het archiveren moet een lege database of tablespace worden aangemaakt met een eigen login en wachtwoord. Dit gebeurt op dezelfde manier als het aanmaken van een productie database. Meer informatie hierover vind je in hoofdstuk 3.2 Setup database. Kopieer vervolgens ttdata.ini naar ttdata_archive.ini en pas hierin de naam van de database en de login aan zodat deze wijst naar de archief database. Test tenslotte of de archief database benaderbaar is: Start TTAdmin.exe en kies menu Bestand, Open database en open ttdata_archive.ini. Als de archief database goed kan worden geopend dan verschijnt ttdata_archive.ini in de statusbalk. N.B. Als er nog niet eerder data is gearchiveerd dan zou er in de statusbalk naast de naam van de data inifile geen datastructuur versienummer getoond moeten worden. 2. Data overzetten naar archief database en verwijderen uit productie database Start TTAdmin.exe op en kies menu Bestand, Open database en open TTData.ini. Als er een ttdata_archive.ini aanwezig is (en de TimeTell services zijn actief) dan zijn onder menu Gegevens de opties Gegevens archiveren en Gegevens opschonen zichtbaar:
De eerste optie zet de data voor een bepaalde datum over naar de productie database. De tweede optie verwijdert de data voor een bepaalde datum uit de productie database. N.B. Bij de optie archiveren kan eventueel worden opgegeven om de data automatisch op te schonen na het archiveren. De optie archiveren kan jaarlijks worden herhaald. De nieuwe data wordt dan toegevoegd aan de archief database. We adviseren om tenminste het huidige en het voorgaande jaar in de productie database te laten staan. N.B. Zorg dat er een backup van de database is gemaakt voordat je gaat archiveren/opschonen.
TimeTell Technische Opzet
81/84
Versie 9 juli 2015
Als je de optie Gegevens archiveren kies krijg je het volgende scherm te zien:
De eerste datum geeft aan t/m welke datum gegevens gearchiveerd moeten worden. De tweede datum geeft aan t/m welke datum gegevens verwijderd mogen worden uit de productiedatabase na archivering. De laatste optie (Geen uren boeken voor) betekent dat men geen weekstaten meer mag aanmaken of wijzigen voor die datum (ook geen correctieweken). Deze wordt automatisch aangezet als je gegevens hebt opgeschoond voor die periode omdat dan al deze data al in de archiefdatabase staat. N.B. Bij het opschonen worden alleen gegevens verwijderd waarvan de einddatum voor de opschoondatum ligt. Projecten met een einddatum die daarna ligt blijven bijvoorbeeld bewaard. Nadat op OK is gedrukt zal het archiveringsproces starten. Tijdens dit proces zal ook een paar keer de TimeTell client worden gestart om een aantal procedures uit te voeren. De uitgevoerde stappen tijdens het archiveren worden bijgehouden in het bestand TTAdmin.log. Let op: Het archiveren kan de nodige tijd in beslag nemen. Dit hangt mede af van de omvang van de productiedatabase en de hoeveelheid te archiveren data. Het is ook mogelijk om eerst de gegevens te archiveren en te controleren of alles naar wens is gearchiveerd en daarna pas de productiedatabase op te schonen. Kies dan voor de menuoptie Gegevens opschonen.
Let op: Als er een archief database is aangemaakt zal TimeTell als u gaat updaten vragen of u ook de archief database wil updaten. Het is verstandig om dit te laten doen omdat de archief database dan ook vanuit de TimeTell client kan worden geraadpleegd.
TimeTell Technische Opzet
82/84
Versie 9 juli 2015
3. Archief database openen vanuit TimeTell client Als er een archief database is en in het autorisatieprofiel is de optie “Open archief” aangezet dan verschijnt er in menu Systeem de optie “Open archief” als men de TimeTell client heeft gestart. Met deze optie kan een gearchiveerde database worden bekeken. In de statusbalk verschijnt een archieflade om aan te tonen dat het archief is geopend. In de titelbalk staat t/m welke datum de gegevens zijn gearchiveerd.
De gegevens in de archiefdatabase zijn read-only en kunnen dus niet worden bewerkt. Voor de rest wordt het autorisatieprofiel toegepast zoals dat in de archief database staat zodat niet meer gegevens zichtbaar worden dan gewenst. De autorisatieprofielen worden bij iedere archivering over gezet naar de archief database. N.B. Als je nog iets zou willen aanpassen in in het archief (bv. het autorisatieprofiel) dan zou je een aparte client INI kunnen aanmaken die direct verwijst naar ttdata_archive.ini i.p.v. ttdata.ini. Let dan wel op dat je geen gegevens verwijdert of toevoegt, want dat kan problemen veroorzaken bij een toekomstige archivering. Via de optie ‘Sluit archief’ kan men weer terugkeren in de productieomgeving.
TimeTell Technische Opzet
83/84
Versie 9 juli 2015
4.9. Configuratie parameters 4.9.1. TimeTell client parameters De TimeTell client kan optioneel worden opgestart met de volgende parameters: -i -login -nologin -verversen -debug -w -oshowweek -wskip -softclock -logonoff -hide -oshowcalendar -oskipcalendar -notranslate -notranslateterms
Path en naam naar het ini-bestand (default wordt gezocht naar TTClient.ini in de directory waar TTClient.exe staat). Toon altijd de login dialoog dus geen authenticatie via de Windows username (ook instelbaar in TTClient.ini). Onderdruk de login dialoog optie dus authenticatie via de Windows username . Forceer het verversen van de lokale tabellen bij het openen van TimeTell. Foutmeldingen niet alleen loggen maar ook direct weergeven Open automatisch de huidige weekstaat (ook instelbaar in het configuratieprofiel) Onderdruk het automatisch openen van de huidige weekstaat (indien aangezet in configuratieprofiel) Automatisch inklokken bij het starten en uitklokken bij het sluiten van TimeTell. TimeTell wordt in de systemtray geplaatst (naast de klok). Dit wordt meestal gebruikt als parameter bij een snelkoppeling naar TimeTell in het Windows opstartmenu of in het loginscript. Mits gebruikt in combinatie met de –logonoff parameter dan wordt alle output onderdrukt en wordt TimeTell ook niet in de systemtray getoond. Toon persoonlijke agenda na opstarten Onderdruk toon agenda (indien aangezet in configuratieprofiel) Engelse vertaling uitzetten Terminologie vertalen uitzetten
Beheerder parameters -superuser -g<username>
Systeembeheer optie (vraagt om het systeem wachtwoord). Log in als gebruiker met <username> (vraagt om systeem wachtwoord).
4.9.2. TimeTell Task Manager parameters De taskmanager (TTTasks.exe) kan ook als een losstaand programma gedraaid worden i.p.v. als een service. Deze kan dan bijvoorbeeld door de Windows scheduler gestart worden om de taken uit te voeren en vervolgens weer worden afgesloten na het uitvoeren van deze taken. Hierbij kunnen de volgende parameters worden gebruikt: -startprc Draai als proces i.p.v. als service -t Draai alle achterstallige taken en sluit af. -t Draai alleen de taak met het opgegeven ID (tabel tt_sys_tasks.tt_task_id).
4.9.3. TimeTell Administrator parameters De TimeTell administrator kent een aantal parameters. Onderstaand voorbeeld toont hoe je een export van de database kan maken m.b.v. parameters:
ttadmin.exe -rexportdatabase -ittdata.ini -d"C:\TimeTell.GDB"
TimeTell Technische Opzet
84/84
Versie 9 juli 2015