HANDLEIDING TIMENTERPRISE INSTALLATIE BASIS

HANDLEIDING TIMENTERPRISE INSTALLATIE BASIS

INHOUDSOPGAVE 1

SYSTEEM VEREISTEN .......................................................................................................... 1 1.1 Minimale vereisten...........................................................................................................1 1.2 TimEnterprise architectuur..............................................................................................1

2

SERVER INSTALLATIE.............................................................................................................3 2.1 Installatie van de software...............................................................................................3 2.2 TimEnterprise Server koppeling met de database...........................................................6

3

CLIENT INSTALLATIE............................................................................................................13

4

TIMENTERPRISE UPDATE.....................................................................................................17 4.1 Materiaal en gegevens....................................................................................................17 4.2 TimEnterprise Server update.........................................................................................17 4.2.1 Conversiebestand maken............................................................................................17 4.2.2 Bestanden vervangen..................................................................................................18 4.2.3 Database aanpassen....................................................................................................18 4.3 TimEnterprise client update...........................................................................................20 4.4 Bestanden opruimen......................................................................................................21

5

DEÏNSTALLATIE TIMENTERPRISE........................................................................................23 5.1 Deïnstallatie van de database.........................................................................................23 5.2 Deïnstallatie TimEnterprise server ...............................................................................24 5.3 Deïnstallatie TimEnterprise client..................................................................................25

6

TESTEN VAN DE SERVER EN DE DATABASE ........................................................................27

7

ADDENDUM.......................................................................................................................... 31 7.1 TimEnterprise Server start niet op.................................................................................31

TimEnterprise installatie Basis

3

7.2 De webbrowser opent geen TimEnterprise serverconsole .............................................31 7.3 Er kan geen connectie met de database gemaakt worden...............................................32 8

INDEX..................................................................................................................................... 35


4

1

SYSTEEM VEREISTEN Voor een optimale performance stelt TimEnterprise eisen aan de configuratie van de systemen waarop de software geïnstalleerd wordt. Deze eisen zijn onder te verdelen in eisen met betrekking tot de TimEnterprise server en eisen voor de werkstations. Daarnaast is ook de beschikbare bandbreedte op het netwerk van belang. In dit hoofdstuk wordt u uitgelegd welke platformen compatibel zijn met TimEnterprise en welke randvoorwaarden u in acht moet nemen voor vereiste software en hardware. Deze verkorte installatie handleiding gaat uit van van de meest generieke installatie van TimEnterprise, namelijk op een MS Windows Server met een MSSQL Database. Voor installatie van TimEnterprise op een Linux Server of de installatie van een webclient zijn aparte handleidingen geschreven.

1.1 Minimale vereisten  Microsoft Windows Server 2003 of Server 2008  Microsoft SQL server 2005 of SQL Server 2008  SQL server 2005/2008 services: SQL Server (MSSQLSERVER) SQL Server Browser actief 

SQL Server Log-on methode: “Mixed Mode Authenticatie” (Windows- and SQL Server Authenticatie)

 Systemadministrator 'SA' actief en wachtwoord voor de desbetreffende Instance bekend  Default SQL Server Instance name: 'MSSQLSERVER', maar mag een andere naam hebben  Default TCP/IP MSSQL Server port: 1433  Firewall : TCP/IP port 1433, 6380 and 10990 open 

,,

: UDP port 1434 open

1.2 TimEnterprise architectuur TimEnterprise is modulair opgebouwd. Men kan een onderscheid maken tussen de volgende componenten: database, server en client.

Illustratie 1.1 op pagina 2 toont de algemene opbouw. In dit 3- en 4-Tier model kan TimEnterprise ook onderscheiden worden in functionele componenten. Met deze verdeling kan de systeembeheerder bepalen welke elementen voor de eindgebruiker nodig of toegankelijk mogen zijn.


1

Illustratie 1.1: TimEnterprise netwerkschema


2

2

SERVER INSTALLATIE

2.1 Installatie van de software 1.

Start de TimEnterprise installatie van de CD_ROM of van een tijdelijke kopie op de server. Controleer of u ingelogd bent met Administrator rechten. Blader vervolgens naar de installatie folder en start TimEnterpriseServerSetup.exe'. Dit programma voert het server installatie proces uit.

Illustratie 2.1: kopie van de installatie CD in een tijdelijke folder: tmp/install

Illustratie 2.2: de installer 'Install4J' 2.

Vervolgens ziet u het welkomst scherm; Klik op 'Next' om door te gaan naar de volgende stap. Kies hier voor de optie “Update/Install TimEnterprise Full Version”.

Illustratie 2.3: Start van de installatie


Illustratie 2.4: Installatie nieuwe versie

3

3.

Selecteer of wijzig de folder voor het programma: Het standaard pad is “C:\Program Files\Aenova Software\TimEnterprise\server”.

4.

Importeer nu een licentie bestand voor TimEnterprise Server. De TimEnterprise licentie, timn.lic, wordt als een los bestand meegeleverd. Klik op browse in de Installer en blader naar de folder met de licentie.

Illustratie 2.5: tree

5.

Illustratie 2.6: selectie van de folder met het licentiebestand

TimEnterprise Server Socket. In de twee volgende stappen geeft u de server-naam of IP-adres op van de machine on waarop de TimEnterprise server geïnstalleerd wordt. 5.1 Server Host name: De naam van de machine waarop TimEnterprise server komt te staan Server port: 10990. Dit is de standaard poort voor de communicatie tussen de TimEnterprise Server en de TimEnterprise clients van de eindgebruiker. Omdat het nummer in een hoge poort range zit conflicteert de poort normaal gesproken niet met een ander programma. Hier kan een ander poortnummer opgegeven worden. Het poort nummer kan ook na de installatie nog gewijzigd worden. 5.2 Server console Host name: Wederom de naam van de machine waarop TimEnterprise server komt te staan. serverconsole port: 6380: Dit is de standaard poort voor de communicatie tussen de TimEnterprise Server en het server-console voor het beheer van de server. Omdat het nummer in een hoge poort range zit conflicteert de poort normaal gesproken niet met een ander programma. Hier kan een ander poortnummer opgegeven worden. Het poort nummer kan ook na de installatie nog gewijzigd worden. Onthoud het poortnummer. Hiermee wordt in een volgende stap contact gelegd met de TimEnterprise Server via een webbrowser. In dit voorbeeld is de URL voor het serverconsole http://assap:6380.


4

Illustratie 2.7: Server socket selectie 6.

Illustratie 2.8: console socket selectie

JDBC Driver version. Kies “other” voor de installatie van de MSSQLSERVER 2005 / 2008 JDBC driver

Illustratie 2.9: JDBC driver selectie 7.

Server geheugen toewijzing. In dit menu wordt opgegeven hoeveel geheugen het TimEnterprise Server proces maximaal mag benutten. - Server Max. Users: 100 Standaard waarde, bepaald het aantal connecties wat het serverprocess kan openen. Is niet gekoppeld aan het aantal gelijktijdige gebruikers. - Server Max. geheugen gebruik: 512 MB is voldoende voor een standaard installatie mode en voorkomt dat het proces in eerste instantie teveel geheugen van de server vraagt.

8.

Microsoft Windows Service Settings. Gebruik de standaard naamgeving voor de Service naam en Display naam. Controleer de checkbox “Starts automatically”. Met deze instellingen zal het Server proces automatisch starten onder de naam/rechten van de Local System user.


5

Illustratie 2.10: Service naam 9.

In het volgende scherm kan de snelkoppeling voor het Start menu opgegeven en aangepast worden. Het standaard menu is Start > Programs > Aenova Software > TimEnterprise.

10. Na deze optie volgt een samenvatting van de installatie parameters. Controleer de paden , namen en poortnummers. Install4J zal de installatie nu uitvoeren. De Service starts automatisch op na afronding van de installatie . Klok op 'finish' en er wordt een welkomst scherm gestart in een nieuwe browser window . 11. Controleer in de services lijst of de TimEnterprise Server gestart is:

Illustratie 2.11: TimEnterprise Service is gestart

2.2 TimEnterprise Server koppeling met de database Voordat TimEnterprise operationeel actief is moeten een aantal elementen in het serve gedeelte ingevuld en gestart worden. Hiervoor moeten we toegang verkrijgen tot het TimEnterprise serverconsole. 1.

Na de afronding van de installatie in paragraaf 2.1, wordt een browser gestart. Klik op hier in het welkomst scherm om de basispagina van het serverconsole te openen.


6

Illustratie 2.12: TimEnterprise welkomst scherm

2.

Een tweede manier om toegang tot het serverconsole te verkrijgen is het starten van een browser en zelf de URL in de adresbalk op te geven: http://[hostname]:6380.

Illustratie 2.13: Instelling van de TLS encryptie 3.

Maak een selfsigned SSL Certificate aan voor het serverconsole van TimEnterprise. In bovenstaand voorbeeld wordt de standaard encryptie methode TLS gebruikt. Deze encryptie is sterker dan SSL en verdient de voorkeur boven het alternatief. TimEnterprise komt met een voorstel voor de console host naam. Int voorbeeld is dat asspare.aenova.local. klik op perform. De browser schakel over op SSL. Pas de URL daarom als volgt aan: https://[hostname]:6380. Accepteer het certificaat en vervolg de installatie.


7

Illustratie 2.14: instellen van de toegangscontrole 4.

In het daaropvolgende scherm van TimEnterprise wordt een menu getoond om een gebruiker voor het console te definiëren. De standaard inlognaam is beginner. Wijzig de de naam in timadmin en het wachtwoord in @enov@ , klik op k op ' perform' and vernieuw de browser. De browser toont nu een inlogscherm. Vul de zojuist aangemaakte credentials in.

Illustratie 2.16: Inlogscherm 5.

Illustratie 2.15: bevestiging SSL

Selecteer in het serverconsole het Tabblad 'Database'. Let op dat de optie 'database settings' is geselecteerd in het linker menu. De optie wordt in rode kleur weergegeven. De volgende waarschuwingen worden u getoond: 1. er is geen database geselecteerd en 2. de database gebruiker heeft nog geen wachtwoord. Zie illustratie 2.17.


8

Illustratie 2.17: selecteren van de database, deel 1 6.

Voer de volgende actie uit: - Vul een database gebruiker en wachtwoord in en klik op “Apply”. Standaard naam is 'timndb' voor zowel de database als de database gebruiker. Er kan een andere naam gebruikt worden maar probeer de namen voor de database en de gebruiker gelijk te houden. - Ga terug naar het tabblad Database, selecteer de database type MSSQL and klik op Perform.

7.

Het Console toont nu de pagina met de database eigenschappen. Vul de database TCP/IP host naam en de MSSQL Server instance naam in. Zie Illustratie 2.18: selecteren van de database, deel 2. Controleer het database TCP/IP poort nummer en klik op Apply.

Illustratie 2.18: selecteren van de database, deel 2 8.

Ververs de browser pagina en selecteer het tabblad Database. Indien alle acties goed zijn uitgevoerd is de Database Status veranderd in: “Database user not found” en toont het serverconsole een extra optie in het linker menu: Database admin. Selecteer deze optie.


9

Illustration 2.19: Database user nog niet gevonden Indien het serverconsole geen Database admin optie toont in het linker menu en de melding the ”Database settings have to be entered/adjusted”, dan dient u de TimEnterprise Service te herstarten. TimEnterprise probeert dan opnieuw connectie te maken met de database aan de hand van de opgeslagen waarden in het server initialisatie bestand TimNServerConfig.xml.

Illustratie 2.20: 9.

De 'database status' indicator toont nu de melding 'Database user not found'. De standaard database gebruiker van TimEnterprise, timndb, kan worden aangemaakt met behulp van het Database 'sa' account van de MSSQL Server instance. TimEnterprise gaat vervolgens het Database Schema en de bijbehorende gebruiker 'timndb' aanmaken.

Illustratie 2.21: Database en schema moeten nog worden aangemaakt


10

10. Selecteer wederom 'Database admin' in het linker menu. Database admin toont het volgende scherm:

Illustratie 2.22: Het database admin menu 11. Typ 'sa' in the 'Database manager user name' , en het 'sa' wachtwoord in het volgende veld. De standaard database naam and database gebruikersnaam 'timndb' wordt in het menu getoond. is deze niet juist, dan kan naam aangepast worden in het “Database Settings” menu. Klik op 'perform' met de optie 'create empty database'. 12. Na enige seconden zal het TimEnterprise console de start van het aanmaken van de nieuwe database tonen. Ververs de browser regelmatig door op de functie-toets [F5] te drukken of klik in het linker menu op 'Database Status'. Na verloop van tijd zal het onderstaande scherm getoond worden.

Illustratie 2.23: De connectie tussen Tim en de database is gelukt


11

Het groene lampje geeft aan dat de connectie met de database is opgezet. In andere situaties is de indicator oranje of rood. Raadpleeg het logbestand voor details over de mislukte connectie. 13. De TimEnterprise server installatie is afgerond. Klik op het tabblad Server en raadpleeg het indicator scherm om de overige TimEnterprise services in te stellen. Deze services, zoals automatische client download en update service zijn optioneel.

N.b.: De 'SQL Server Browser' service op de MSSQL server moet actief draaien wanneer TimEnterprise en de MSSQL database op twee verschillende servers staan. Zonder deze service kan TimEnterprise de MSSQL Instance op de andere server niet vinden.


12

3

CLIENT INSTALLATIE De client installer van TimEnterprise, Install4Java, levert via een webbrowser een voorgedefinieerd installatiepakket aan. Deze installer kan in IE rechtstreeks gestart worden. Maar het is ook mogelijk om de installer vanuit de browser te op te slaan en de installatie vervolgens op een ander moment of een andere PC uit te voeren. De installer vraagt gedurende het proces naar de locatie waar de client geplaatst moet worden. Voor een update van de client hoeft de installer gedownload te worden. De client kan, optioneel, van de vernieuwde TimEnterprise server een update pakket krijgen, welke automatisch uitgevoerd wordt. De installer download en auto-update functies zijn instelbaar in het serverconsole van TimEnterprise.

1.

Controleer in het serverconsole of de configuratie voor de client download site en client autoupdate juist is: Open een Internet Explorer en ga naar naar de serverpagina van het serverconsole. Wanneer de server inclusief client install software ingericht is lichten de client indicator lampjes op het panel groen op. In het hoofdstuk TimEnterprise Server inrichten wordt uitgelegd hoe de client download site en client auto-update opties ingericht moeten worden.

2.

Click op de client download site en lees welke URL gebruikt moet worden om de client download pagina te openen. Dit is normaal gesproken de volgende URL: HTTP://servernaam:8090. De volgende pagina wordt geladen in de browser:

Indien de pagina niet geopend kan worden, controleer dan of een proxyserver ingesteld is en pas deze zo nodig aan. Rechts bovenin de pagina wordt de TimEnterprise versie genoemd. Bij installatie van meerdere TimEnterprise omgevingen op dezelfde server kan hier gecontroleerd worden of de juiste TimEnterprise client opgehaald wordt. 3.

De client download site leest via de browser uit met welke van de drie Operating Systemen de installer te maken heeft: Windows, Mac OSX of Linux en selecteert op voorhand de juiste versie.

4.

Klik op Start. De installer download nu een executable. IE mag deze executable, de Install4j installer, direct uitvoeren door op RUN/uitvoeren te klikken. Mozilla Firefox verwacht dat u de installer opslaat en start vanuit de verkenner.


13

5.

Druk op RUN/uitvoeren. Er wordt nu een veiligheidswaarschuwing geven. Indien de Uitgever van het certificaat. Aenova B.V. is en het pakket als TimEnterprise aangeduid wordt, dan kan de installer veilig gestart worden. In alle andere gevallen is het pakket niet van Aenova dan wel gewijzigd door een niet officiële distributeur en dient installatie niet door te gaan tot uitgezocht is waarom het certificaat onjuist is.

6.

Install4j pakt het bestand uit en vraagt waar de software geïnstalleerd moet worden. De standaardlocatie is “C:\Program Files\Aenova\TimEnterprise”. Bestaande installaties van TimEnterprise staan doorgaans in C:\Program Files\Aenova Software \TimN\client. Bij vervanging van de oude client voor een nieuwe client kan de oorspronkelijke locatie ingevuld worden. Blader met de knop “bladeren...” naar de juiste doelmap. De folder 'client' mag niet niet in het pad van de doelmap staan. Deze folder wordt door de installer al aangemaakt.


14

7.

Hierna kan bepaald worden wat de naam van de Startmenu map moet worden. Standaard heet deze Aenova Software\TimEnterprise. Tenzij in het serverconsole bij de client download site de pre/postfix naam optie gebruikt is.

8.

Als laatste optie kan bepaald worden of een Desktop koppeling aangemaakt moet worden.

9.

Na installatie kan de client direct gestart worden. Wanneer dit de eerste keer is dat Tim gestart wordt, zal automatisch een applicatiebeheerder aangemaakt worden in de database van Tim. Indien de database van Tim al gebruikers bevat moet bij opstarten de persoonsgebonden netwerknaam al bekend zijn in TimEnterprise.

10. Deïnstallatie van de client kan vanuit het startmenu en vanuit de installatiefolder van Tim uitgevoerd worden. In beide locaties staat een uninstall snelkoppeling om het pakket te verwijderen. 11. Bij een update van TimEnterprise zal de client constateren dat de software vernieuwd moet


15

worden. In het Serverconsole van TimEnterprise, in het tabblad client update-site is bepaald hoe dit zal verlopen: Volautomatisch of met toestemming van de gebruiker. Het is aan de systeembeheerder om te bepalen welke strategie gevolgd moet worden. Gedetailleerde uitleg over de client update kan gevonden worden in het hoofdstuk Update TimEnterprise client.


16

4

TIMENTERPRISE UPDATE Een update van TimEnterprise bestaat uit twee logisch gescheiden handelingen. Vernieuwen van de TimEnterprise server en het

vernieuwen van de TimEnterprise clients. Hierbij moet rekening

gehouden worden dat na een update van de Server de client software naar dezelfde release geupgrade moet worden. Een client zal niet volledig opstarten wanneer het versienummer niet overeenkomt met het versiennummer van de TimEnterprise server.

4.1 Materiaal en gegevens Controleer of de volgende zaken aanwezig zijn: Software:  TimEnterprise CD-ROM  Licentie bestand. Dit bestand is via e-mail of diskette aangeleverd Gegevens:  URL van het TimEnterprise serverconsole  Gebruikersnaam en wachtwoord van het TimEnterprise serverconsole Nota bene: Lees eerst hoofdstuk 2 'Server installatie' en hoofdstuk 3 'Client installatie' door, voordat de update wordt uitgevoerd. Onderstaande update beschrijving is gebaseerd op kennis welke in deze hoofdstukken zijn opgedaan.

4.2 TimEnterprise Server update De update bestaat uit drie stappen: Een Database backup maken en de Service stoppen, Bestanden vervangen en tot slot de Service starten en de Database aanpassen.

4.2.1 Conversiebestand maken 1.

Open het TimEnterprise serverconsole in een browser. De URL heeft het formaat https://servernaam:poort. Bij een standaard installatie staat het poortnummer ingesteld op 6380.

2.

Na het inloggen verschijnt het serverconsole menu. Ga naar het tabblad Database en kies Database onderhoud in het linkermenu.

3.

Kies voor Conversie-bestand maken van de inhoud van de database, vink Aansluitend server afsluiten aan, en klik op Uitvoeren. Volg de verdere instructies op.

4.

De database wordt nu weggeschreven. De voortgang is te zien onder het menu Database Status. Klik regelmatig op 'Database Status' voor updaten van de statusmeldingen. Na het


17

wegschrijven van de data zal de TimEnterprise service stoppen. Controleer of de TimEnterprise service gestopt is. Dit is te zien aan het serverconsole: de pagina is niet meer toegankelijk en het serverproces is niet meer actief. 5.

Het conversie-bestand wordt bewaard in de folder .\server\conversies. Dit bestand heeft altijd de naam van de database en wordt gecomprimeerd met zip.

6.

Maak een kopie van het conversiebestand en bewaar dit op een andere partitie of server. Dit conversiebestand kan ten alle tijde weer gebruikt worden om de database-inhoud te herstellen.

4.2.2 Bestanden vervangen 1.

Controleer of er geen bestanden gelockt worden agv openstaande verkenners, commandvensters of software. Met name de JRE wil nog al eens gebruikt worden door de overige applikaties en koppeling software. Stop de services van Tomcat en B-Comm java wanneer zij gebruik maken de JRE in de {TimN_Home}\server folder

2.

Start de installer van TimEnterprise, TimEnterpriseServerSetup.exe. De Installer gaat straks de jar bestanden, de JRE, de ODBC drivers in de folder JRE en de client installatie- en updatefolders vervangen.

3.

Het stroomschema van de Installer is grotendeels gelijk aan die van de primaire installatie. Na opstarten vraagt de Installer of de installatie een Demo of volledige versie betreft. Selecteer de “volledige versie”

4.

Vervolgens vraagt de installer om de locatie van de TimEnterprise server. Vul hier het volledige pad naar de {TimN_Home} in. Het pad mag niet eindigen op server. Dat vult de Installer zelf al in.

5.

Setup ziet dat de folder al een TimEnterprise installatie bevat en vraagt om goedkeuring om door te gaan.

6.

Wanneer het conversiebestand te oud is waarschuwt de installer hiervoor. Breekt de installatie af en maak het conversiebestand. Klik op next om toch door te gaan met de installatie

7.

Vervang de licentie van TimEnterprise indien de installatie geen Revisie-update is maar een nieuwe release.

8.

De installer vraagt nu naar de te gebruiken database Wijs de het juste database type aan voor de update van de bijbehorende JDBC driver.

9.

TimEnterprise is nu zover dat ze kan gaan installeren. Komen er toch nog vragen voorbij die betrekking hebben op de te gebruiken poortnummers, dan betreft de installatie geen update, aar een nieuwe installatie. Het pad naar de {Timn_Home} is dit geval niet goed gekozen. Ga terug in het installatie stroomschema en pas het pad aan.

10. Na installatie vraagt de Installer of de TimEnterprise server gestart moet worden. Vink de optie voor de welkomstpagina uit. Ga verder. De installatie van de bestanden is nu afgerond.

4.2.3 Database aanpassen 1.

Controleer of de service gestart is. Start de TimEnterprise service zo nodig vanuit de Windows Services.msc lijst.

2.

Open het serverconsole in de browser. Deze is nog niet onmiddellijk beschikbaar;

3.

De volgende melding wordt getoond:


18

LET OP! De server is nog in de opstartfase en daarom zijn nog niet alle pagina's beschikbaar! Vernieuw deze pagina als de server reeds eerder is geïnstalleerd. 4.

Ververs eventueel de browserpagina met de functietoets [F5]

tot alle tabbladen van het

serverconsole weer zichtbaar zijn. 5.

Ga in het serverconsole naar het tabblad Server. Klik in het menu op Server status. In het Overzicht kan nu staan: 'Server actief' en “verbonden met Database. De kans is echter groot dat de tabelstructuur gewijzigd moet worden t.o.v. de vorige versie. In het overzicht met de Server status meldingen staat nu de melding dat de TimEnterprise server in pauzestand staat en dat de server nog niet verbonden is met de database. Het starten van de server is onderbroken omdat er een database probleem is geconstateerd. Ga naar Database status voor meer informatie over dit probleem en om een oplossing te vinden.

6.

Ga naar het tabblad Database en open de Database-status pagina. Hier wordt boven in de pagina de volgende serverconsole melding getoond: Er is een database configuratie fout geconstateerd: zie de waarschuwing(en) in de Server log. De applicatie heeft geconstateerd dat de huidige database structuur aangepast moet worden om verder te kunnen. Kies voor Database onderhoud om dit uit te voeren.

7.

Als gevolg van de gewijzigde tabel tructuur van de TimEnterprise database moet de tabellen en de records aangepast worden. TimEnterprise kan dit zelf uitvoeren. Via het menu Database onderhoud > Database aanpassen aan de applicatie' kan TimEnterprise server een update van de database in gang zetten. Indien het verschil tussen de oude en nieuwe release te groot is, is de optie 'database aanpassen' niet toereikend. In dat geval moet alsnog het in Stap 1 aangemaakte conversiebestand inlezen worden. Dit wordt duidelijk gemeld in het TimEnterprise Server console. In plaats van de opmerking dat de database aangepast moet worden, staat er een melding als 'Database-inhoud is inconsistent met de applicatie'. De database moet opnieuw ingelezen worden. Ga naar Conversies om een het conversiebestand in te lezen. Ga verder met stap 9 om het conversiebestand in te lezen.

8.

Na aanpassen van de database moet bij database status de melding 'Verbonden met database' getoond worden. De TimEnterprise server is nu actief en bevat een 'gezonde' database. U kunt nu verder met het updaten van de client. Dit wordt beschreven op pagina 20, in Hoofdstuk 4.3.

9.

Conversiebestand lezen Mocht er onverhoopt geen conversiebestand gemaakt zijn, dan moet dat alsnog gebeuren met behulp van de oude TimEnterprise versie die in de backup folder is gezet. Er is geen andere methode om de database aan te passen wanneer het TimEnterprise Console zegt dat de database niet aangepast kan worden anders dan met het inlezen van het conversiebestand.

10. Ga in het serverconsole naar het menu Database onderhoud. Controleer dat de gele balk vermeldt:


19

'Database-inhoud is inconsistent met de applicatie' 11. Ga in het serverconsole naar Database > conversiebestand. 12. In het rechtermenu kan gekozen worden voor de optie Conversie-bestand inlezen. De overige opties zijn niet actief. In het veld wordt de naam van het conversie-bestand vermeld. Deze moet overeenkomen met de naam van het eerder gemaakte conversie-bestand. 13. Klik op de knop Uitvoeren. Volg de verdere instructies op. 14. De database wordt nu ingelezen. Afhankelijk van de hoeveelheid gegevens kan dit enige tijd in beslag nemen. De voortgang is te zien onder het menu Database status of Database onderhoud. Druk op de functietoets [F5] of dubbelklik op Database status om de pagina te verversen. Na het inlezen zal de server zijn gestopt. 15. Na het inlezen zat TimEnterprise een integriteitscontrole op de database uitvoeren. Dit kan enige tijd duren. 16. Ga terug naar het serverconsole. Klik in het menu op Server status. In de gele balk moet nu staan: 'Server actief'. Klik in het menu op Database status. In de gele balk moet nu staan: 'Verbonden met database'. 17. Verwijder na een succesvolle update de backup folder {TimN_home}\Server_releasenummer” N.B. Het logbestand timnsvc.log bevat informatie over de update en eventuele foutmeldingen over problemen die tijdens de update zijn opgetreden.

4.3 TimEnterprise client update Een client welke geïnstalleerd is via de Installer, kan zichzelf updaten zodra de client gestart wordt. De Timclient bemerkt dat de server een nieuwere release beschikbaar heeft en krijgt via de server de nieuwe software aangereikt. Voorwaarde is dat de gebruiker schijfrechten heeft op de folder waar TimEnterprise geïnstalleerd is. En, niet geheel onbelangrijk, de zip bestanden in de folders Clientinstaller en Clientupdate

van de {TimN_Home}moeten aanwezig zijn en de services voor

Installatie en update moeten actief zijn. 1.

Start de TimEnterprise client. Wanneer de voortgangsindicator op 44% geladen staat, verschijnt een melding: TimEnterprise client constateert dat de server een nieuwere versie beschikbaar heeft.

2.

Afhankelijk van de bandbreedte tussen de server en client computer kan het even duren voordat de software is opgehaald van de server.

3.

Vervolgens kan de gebruiker de update starten of afbreken.


20

4.

Beantwoord de vragen van de installer. Controleer of de checkboxes voor 'Desktop Icoon' en 'automatisch opstarten na installatie' aangevinkt zijn.

5.

Na de installatie-update start de client automatisch op. In het Splashscreen wordt het nieuwe versienummer getoond.

4.4 Bestanden opruimen Gedurende de installatie zijn meerdere bestanden gekopieerd naar de server. De meeste hiervan kunnen weer weg. Dit kan GB's schelen in de soms beperkte opslagruimte van het filesysteem. Maar verwijdering van de overbodige bestanden voorkomt ook vergissingen en verwarring bij onderhoud en support op het pakket. Indien de installatie en de update volgens de handleiding uitgevoerd zijn, dan kunnen de volgende bestanden verwijderd worden:  de backup folder {TimN_home}-releasenummer”,  de locale kopieen van de installatie CD-ROM,  de nieuwe downloads van Oracle JDK en de uitpakte bestanden. En soms ook:  locale kopieën van de licentie file timn.lic. Alleen licentiebestanden van dezelfde release versie zijn geldig. Oudere kopiëren moeten verwijderd worden om vergissingen bij terugzetten van een testlicentie te voorkomen. Met een onderhoudscontract kan bij Aenova Software opgevraagd altijd een kopie van de huidige licentie worden.


21

5

DEÏNSTALLATIE TIMENTERPRISE Volledige deïnstallatie van TimEnterprise moet op drie vlakken uitgevoerd worden: verwijdering van de database, deïnstallatie van de TimEnterprise Server en deïnstallatie van de TimEnterprise client.

5.1 Deïnstallatie van de database Het is verstandig om TimEnterprise serve pas te verwijderen nadat de de database verwijderd is. TimEnterprise Server kan namelijk zelf het database schema uit het DBMS systeem verwijderen. Vervolgens kan via de Oracle Enterprise Manager of MSSQL studio overgebleven tablespaces en zelfgemaakte views verwijderd worden. 1.

Log in op het TimEnterprise Server console. Gebruik de credentials zoals die in hoofdstuk 2.2, pagina 7. opgegeven zijn.

2.

Selecteer het tabblad Server en klik op het menu onderdeel “Server Onderhoud”.

3.

Plaats de server in pauze stand.

4.

Selecteer het tabblad Database. Klik in het menu in de linker kolom op “Database admin”.

5.

Scroll in de pagina naar het onderdeel “Delete database user environment”.

6.

Vul dezelfde gebruiker in als bij het aanmaken van de database. Voor MSSQLSERVER is dat de gebruiker SA , Voor Oracle is dat de gebruiker system. Klik op “perform”.

Illustratie 5.1: Verwijder de Database

Illustratie 5.2: voor


Illustratie5.3: na

23

7.

De database 'timndb' is nu permanent verwijderd uit het het DBMS. Alleen een backup of een TimEnterprise conversiebestand kan de database weer herstellen.

5.2 Deïnstallatie TimEnterprise server De volgende stap is de deïnstallatie van de TimEnterprise server via the Start menu of the local server. Go to the Start Menu > Programs > Aenova Software. Select 'TimEnterprise Server' and klik 'Change/Remove'.

Illustratie 5.4: TimEnterprise Server Start menu

Illustratie 5.5:

Illustratie 5.6: TimEnterprise is verwijderd

TimEnterprise is nu verwijderd van de Server. Achtergebleven data, zoals het timndb.zip bestand in de in de Aenova Software folder moeten handmatig verwijderd worden.


24

5.3 Deïnstallatie TimEnterprise client Deïnstallatie van de client kan net als bij het verwijderen van de server vanuit het startmenu en vanuit de installatiefolder van Tim uitgevoerd worden. In beide locaties staat een uninstall snelkoppeling om het pakket te verwijderen.


25

6

TESTEN VAN DE SERVER EN DE DATABASE In dit hoofdstuk wordt de connectie tussen de TimEnterprise server en de database getest door middel van het importeren van een zogenaamd conversiebestand. Alle verzoeken van de TimEnterprise client waarbij data uit de database moet worden opgehaald en weggeschreven in de database wordt door de Middel Tier, De TimEnterprise server afgehandeld. Inlezen van een bestand met TimEnterprise gegevens, een zgn. conversiebestand wordt ook door het serverproces uitgevoerd: De interne database user dropt het bestaande schema, maakt een nieuw schema aan, creëert alle tabellen zoals die volgens het database schema aanwezig moeten zijn en leest vervolgens de records uit het conversiebestand in. Om de verbinding tussen TimEnterprise en de database te testen is het dus niet nodig om een client te installeren. We kunnen volstaan met het inlezen van een conversiebestand. door de embedded TimEnterprise server user 'timndb'. Op de CD van TimEnterprise is al een heel klein conversiebestand aanwezig: timnleeg.zip Dit bestand kan gebruikt worden voor het inlezen, maar bevat, zoals de naam al zegt, geen records voor het vullen van de diverse TimEnterprise tabellen. Voor een meer representatieve inleesactie kunt u een conversiebestand van een andere TimEnterprise omgeving gebruiken. Of, indien die niet aanwezig is kan deze bij Aenova Software aangevraagd worden. Importeren van een database: 1.

Kopieer van de installatie CD-ROM het bestand ..\conversions\timnleeg.zip of het eigen bestand timndb.ziup naar de folder 'conversions' van de desbetreffende TimEnterprise server. Bijvoorbeeld. 'c:\Program files\Aenova software\TimEnterprise\ server\conversions\timndb.zip'.

Illustratie 6.1: 2.

Illustratie 6.2:

Start een Internet Explorer en open het TimEnterprise Server Console. Gebruik de volgende URL: https://servernaam:6380 and log in met de inlognaam/wachtwoord combinatie zoals deze bij de installatie is ingevoerd. Zie hoofdstuk 2.2, pagina 6.

3.

Ga naar het tabblad 'Database' . In het menu aan de linker zijde staat de optie 'conversie bestand'. Klik op de optie en het volgende scherm verschijnt:


27

Illustratie 6.3: Tablbad Database, optie Conversiebestand 4.

Ga naar de optie 'Read Conversion file', vul de naam van het conversiebestand, de extentie '.zip' kan achterwege gelaten worden, en klik op de button 'Perform'.TimEnterprise vraagt voor een bevestiging van de voorgestelde actie. Dit is een belangrijk moment, want alle huidige data in de database zal worden overschreven. Is dit niet het juiste server-console, dan is dit het laatste moment om actie af te breken.

5.

Bevestig de actie door op 'Yes' te klikken en ga door.

Illustratie 6.4: ja, ga door.

6.

Illustratie 6.5: de database wordt overschreven.

TimEnterprise server 'dropt' de oude data, maakt met behulp van haar interne databaseschema de tabellen opnieuw aan en begint het lezen van de data uit het timndb.zip bestand.file. Na een korte tijd wordt de browser pagina ververst en komt de bevestiging van de actie.


28

Illustratie 6.7: ververs het scherm

Illustratie 6.6: Bevestiging actie 7.

Click op 'back' of in het menu aan de linkerzijde op 'Database status' om het proces te volgen.

Illustratie 6.9: Data import op 3 procent 8.

Illustratie 6.8: data import klaar

Het Tabblad serveconsole geeft ander informatie: TimEnterprise Server is in 'maintenance mode', (read conversion file) 'timndb.zip':

Illustration 6.10: Data import: Server is in maintenance mode 9.

In een volgende fase controleert TimEnterprise server de ingelezen data. Ververs het console in de browser regelmatig door te klikken op de optie 'Database | database status' of door de pagina te verversen met F5 van het toetsenbord. Na enige tijd, afhankelijk van de grootte van het in te lezen bestand toont het status rapport in het tabblad 'Server' letterlijk 'groen licht' voor de verbinding met de melding “Server actief' server en de database connectie geeft als melding 'Verbonden met database'.

10. TimEnterprise is nu gereed voor gebruik. Zie Illustratiie 6.11: TimEnterprise server is gereed voor gebruik.


29

Illustratiie 6.11: TimEnterprise server is gereed voor gebruik 11. Optioneel: Ga naar het tabblad 'Users' en klik op de optie 'User Access'. Op deze pagina kan met behulp van de user selection menu een lijst van gebruikers opgehaald worden uit de database.

Illustration 6.12: TimEnterprise User access 12. TimEnterprise is geïnstalleerd, de verbinding met de database is werkende. Er hoeft nu alleen nog maar een client geïnstalleerd te worden.


30

7

ADDENDUM

7.1 TimEnterprise Server start niet op. 1.

Wanneer de TimEnterprise Serverconsole niet opgestart wordt na de primaire installatie kan het zijn dat de TimEnterprise Service niet gestart is. Open de serviceslijst van de server en zoek de service “TimEnterprise Server” op in de lijst. Controleer of de startmethode op 'automatisch' staat en niet op 'handmatig'.

2.

Start de TimEnterprise service vanuit het servicesscherm. Het systeem komt met de volgende melding: 'local-system' doesn't have appropriate permissions to start timnsvc.exe as a service.” Roep de eigenschappen van de folder 'Server' in de TimEnterprise_Home directory op. Open de veiligeheidstab tab of the folder “server” in C:\Program files\Aenova Software\TimN. En zet de rechten voor System op “Full Control”.

Illustratie 7.1: het Services scherm met TimEnterprise

7.2 De webbrowser opent geen TimEnterprise serverconsole Wanneer de browser geen Serversonsole van TimEnterprise toont kan dit aan verschillende, vaak voorkomende fouten liggen: 1.

Controleer of de TimEnterprise Server wel gestart is.

2.

De URL is verkeerd: Na de primaire installatie is er nog geen SSL certificaat geïnstalleerd. Het Serverconsole kan alleen in onveilge modus (http) geopend worden. Na installatie van het certificaat is het serverconsole alleen via de link https:// servernaam:poortnummer op te roepen.

3.

De URL is juist, maar de PC kan de server niet vinden op servernaam, Probeer IP adres in plaats van servernaam. Ping vanuit een CMD venster naar de server op basis van servernaam en ipadres. IP-adres. Indien een URL op Ipadres wel werkt, pas dan het host bestand op de pc aan


31

dan wel de DNS server.

Illustratie 7.2: IE 7 and IE 8 SSL waarschuwing 4.

De URL is juist, maar de PC kan de server niet vinden op servernaam, Probeer IP adres in plaats van servernaam. Ping vanuit een CMD venster naar de server op basis van servernaam en IP adres. IPadres. Indien een URL op IP adres wel werkt, pas dan het host bestand op de pc aan dan wel de DNS server.

5.

De URL is juist, en de server is op naam en IP adres te vinden. Wellicht is een Proxyserver in het netwerk opgenomen Voeg de TimEnterprise server server toe aan de uitzonderingenlijst.

6.

Op de server kan het serverconsole geopend worden, maar niet vanaf een client PC. Er kan geen connectie op de betreffende poort gemaakt worden: Controleer of een Firewall aan staat. Voeg poort 6380 als uitzondering toe.

7.

Er is geen firewall geïnstalleerd , poort 6380 is benaderbaar en op de server kan wel een serverconole geopend worden. Bezit de TimEnterprise server meerdere netwerk interfaces? Kies het IP-adres waarop client werkstations met de server mag communiceren en vul deze in in het serverconsole op tabblad Server, Console instellingen. Herstart de TimEnterprise Service.

7.3 Er kan geen connectie met de database gemaakt worden Wanneer TimEnterprise Server niet in staat is om een connectie met de database op te zetten, dan wel niet in staat is om de database vanuit het serverconsole aan te maken, ligt de oorzaak mogelijk aan een van de volgende punten. 1.

TimEnterprise heeft geen geldige licentie. Open het logbestand. En controleer dit.

2.

De server kan geen connectie opzetten naar de externe server waar de database op staat. Oorzaak is waarschijnlijk de SQL Server Browser. Controleer de services-lijst op de database server. De SQL browser service moet gestart zijn.

3.

De SQL server authenticatie staat op Windows Authenticatie in plaats van SQL Server authenticatie. Controleer via SQL management Studio de authenticatie methode. Vink de radiobutton 'SQL server authenticatie en Windows authenticatie' aan.

4.

De SQL browser is gestart, SQL server authentication is aangevinkt, maar volgens het


32

TimEnterprise logbestand is lukt het TimEnterprise server niet om met de 'sa' gebruiker van MSSQL connectie te maken met de database. Controleer via de Management Studio Console van MSSQL de login status van 'sa'. Stel de status in op 'Enabled'. Na aanmaken van de database kan de logstatus weer van 'Enabled' naar 'Disabled' gezet worden.


33

8

INDEX B

Mozilla....................................................................13

Browsers....................................................................

S Firefox...............................................................13 Server console Host name........................................4 Internet Explorer...............................................13 Server geheugen toewijzing.....................................5 Mozilla...............................................................13 Server Host name.....................................................4

C

SSL Certificate..........................................................7

Conversiebestand...................................................17 Start menu................................................................6 D

T Deïnstallatie...........................................................24 TimEnterprise installatie..........................................3 F Firefox.....................................................................13 I

Timndb.zip..............................................................25 U Update........................................................................

Internet Explorer....................................................13

Client update.....................................................20

J

Server update....................................................17

JDBC Driver version.................................................5 M

.................................................................................5

Maintenance mode.................................................27


35

HANDLEIDING TIMENTERPRISE INSTALLATIE BASIS

Recommend Documents