ShowPath? TOC(heading=Inhoudsopgave)?

Installatiehandleiding

Deze handleiding beschrijft de installatie van OpenAC versie 0.9 en later op Microsoft Windows.

1. Opzet van de software

Om OpenAC te draaien, dienen lokaal twee dingen te worden geinstalleerd:

• Een database (MySQL of Microsoft SQL server)
• De OpenAC starter kit (de programmeertaal Python en de OpenAC broncode)

Voor de uiteindelijke implementatie van OpenAC is het aan te raden de database te installeren op een server, en OpenAC op alle werkstations. Als richtlijn voor zowel de server als de werkstations geldt een Pentium IV-systeem met minimaal 256MB geheugen en Windows 2000 of Windows XP.

Het wordt afgeraden om OpenAC te installeren op een netwerkschijf. In plaats daarvan raden we aan de starter kit op een netwerkschijf te zetten, zodat nieuwe gebruikers snel met OpenAC aan de slag kunnen op een werkstation, wanneer het daar nog niet is geinstalleerd. OpenAC beschikt over een ingebouwd versiebeheerssysteem, dat ervoor zorgt dat alle gebruikers automatisch beschikken over de gewenste versie van de software.

2. Aanmaken van een SQL-database OpenAC

De meesten hebben al een database voor OpenAC. We raden aan in dat geval die database te behouden, en dit hoofdstuk over te slaan.

Moet nog een database worden aangelegd, dan kan worden gekozen voor een open-source pakket (MySQL) of de microsoft-variant (SQL server). De Microsoft-variant moet, in tegenstelling tot de webserver IIS, apart worden aangeschaft.

2.1 MySQL

Download MySQL, tenminste versie 4.1, van www.mysql.org, en kies de installatieoptie waarbij je kunt aangeven hoeveel gelijktijdige gebruikers je verwacht. Kies waar gevraagd voor "transactioneel", omdat dit beter aansluit bij de eisen van OpenAC.

Ga nu via het Startmenu naar MySQL en kies de MySQL client. Voer het root-wachtwoord in dat je bij de instalatie hebt opgegeven, of druk ENTER wanneer je geen wachtwoord hebt ingevoerd. Voer dan de volgende commando's uit:

create database openac;
grant all on openac.* to 'fenac'@'%' identified by 'dbc';
grant all on openac.* to 'fenac'@'localhost' identified by 'dbc';
exit

De OpenAC-database is nu aangemaakt. Let op: het woord identified bevat maar één N.

TIP: Voor prettig gebruik met OpenAC moeten er instellingen worden gewijzigd in MySQL. Zoek hiertoe in Program Files naar MySQL en localiseer het bestand my.ini. Zoek de variabele innodb_buffer_pool_size en zet deze variabele op een flinke waarde zoals 256MB. Dit geheugen ben je overigens ook echt permanent kwijt.

2.2 Microsoft SQL server

Installeer de “development server” vanaf de Microsoft SQL server CD.

Open na succesvolle installatie Microsoft SQL Server -> Enterprise manager vanuit het startmenu, zoek de server (Local) (Windows NT). Druk, zodra rechts een verzameling databases verschijnt waaronder de beroemde voorbeeld-database “NorthWind?”, de rechtermuisknop in en selecteer nieuwe database. Maak een (lege) database aan met de naam “OpenAC”.

We gaan nu naar het ODBC-koppelingsbeheer, meestal te vinden in het configuratiescherm; zo niet, start het dan direct op als

C:\WINDOWS\system32\odbcad32.exe

In het ODBC-beheerstool maken we een nieuwe DSN (gegevensbron) aan: selec-teer de tab Systeem-DSN en klik Toevoegen. Selecteer uit de lijst drivers SQL server en klik op Voltooien. Vul als naam voor de gegevensbron in “OpenAC”, en selecteer als server “(local)”. Kies in het volgende scherm voor Windows-NT-verificatie. Vink verbinden met SQL server aan en klik volgende. Als “andere standaarddatabase” vullen we in: “OpenAC”. Alle overige instellingen hoeven niet te worden gewijzigd.

3. OpenAC zelf installeren

Wanneer eerder een versie van OpenAC is geinstalleerd, is het verstandig om eerst de oude versie van OpenAC een laatste keer op te starten, in het loginscherm te klikken op Details en de daar ingevulde waarden op te schrijven. Deze waarden zijn straks nodig voor elke lokale installatie van OpenAC.

3.1 De starter kit uitpakken

Het installeren van OpenAC vanaf versie 0.9 is eenvoudig. Download de ​starter kit en voor hem uit. Er wordt nu een map OpenAC aangemaakt en een icoon op het bureaublad gezet waarmee OpenAC kan worden gestart.

3.2 OpenAC opstarten

Wanneer op het OpenAC-pictogram wordt geklikt, verschijnt een loginscherm (zie eventueel VraagEnAntwoord? wanneer dit niet lukt).

Klik hierin op Details om de connectie met de database in te stellen. Wanneer u heeft gekozen voor een MySQL-database op uw eigen werkstation, kunnen alle waarden blijven staan, behalve het veld “adaptatie”. Hier selecteert u de naam van het eigen AC.

Gebruikers van SQL server moeten eenmalig de velden “Gegevensbron” (naam van een ODBC-bron die wijst naar SQL server) en “SQL-dialect” (transact-SQL) invullen alvorens op Login te klikken.

Men logt op OpenAC de eerste keer in als admin met als wachtwoord finux.

Het inloggen kan de eerste keer even duren, met name omdat de database moet worden gevuld met tabellen. Wanneer eerder is gedraaid met OpenAC rekenversie (versies voor 0.80), dan kan het zijn dat een aanzienlijk aantal rode meldingen onderin het scherm verschijnt. Wanneer OpenAC klaar is met het printen van meldingen, selecteer dan Database wissen... in het menu Beheer en log opnieuw in.

Hierna ziet men het OpenAC startscherm.

3.3 OpenAC bijwerken naar de nieuwste versie

Het startscherm bestaat uit 3 vakken: hoofdschermen, rapportages en beheer.

In het boxje "beheer" staat een knop versiebeheer. Klik op deze knop. Na even wachten verschijnt nu een scherm met links een lijst met OpenAC-versies. Klik op de nieuwste versie in dit overzicht om OpenAC bij te werken.

Het versiebeheerscherm krijgt u alleen wanneer u inlogt als admin. Voor gewone gebruikers wordt de software bij het opstarten automatisch in overeenstemming gebracht met het versienummer en revisienummer dat in het versiebeheer-scherm door admin wordt aangegeven ("schakel gebruikers naar versie...").

Wanneer u, bijvoorbeeld in een periode waarin OpenAC alleen wordt gebruikt voor het doorrekenen van de productie met oog op DIS, DBC onderhoud en begroting, alleen werkt als admin, dient u op elk werkstation waar u OpenAC gebruikt, over te schakelen op de juiste versie.

4. Import van data uit een bestaande registratiepakketten

OpenAC biedt ondersteuning voor de registratiepakketten van 20 Nederlandse AC’s. Wanneer men bij het inloggen de eigen “adaptatie” van de software heeft aangewezen, komt in het menu “Beheer” vanzelf de juiste importfunctie beschikbaar. Let op: laad voor het importeren altijd eerst de normtijden in via het beheer-menu of via het beheerscherm normtijden/prijzen.

De meeste importfuncties kunnen zonder verdere voorbereiding worden gestart; het enige dat vereist is, is dat OpenAC bij de bestanden kan die moeten worden geïmporteerd.

Voor ACACIA en MediWorld dient een ODBC-koppeling te worden aangelegd, al-vorens begonnen wordt met het naar binnen halen van de data vanuit OpenAC. Zier hiervoor de instructies in 4.1 en 4.2.

4.1 ACACIA

Start het ODBC-gegevensbronbeheer vanuit het configuratiescherm, of door direct C:\WINDOWS\system32\odbcad32.exe te starten. Klik op de tab systeem-DSN, en kies toevoegen. Selecteer de driver voor Microsoft Access. Vul als naam voor de bron in: ACACIA en selecteer het ACACIA-bestand acacian.mdb. Klik nu op “systeemdatabase” en selecteer het ACACIA-bestand WERKGROEP.MDW. Ga tenslotte naar “geavanceerd” en voeg als username/password in: eigenaar/eigenaar. Druk twee keer OK, en de verbinding met ACACIA/Access is gelegd.

4.2 MediWorld

Pak het installatiebestand ​Driver pack 1051 en installeer het. Dit installeert de ODBC-driver voor de MediWorld database.

Start het ODBC-gegevensbronbeheer vanuit het configuratiescherm, of door direct C:\WINDOWS\system32\odbcad32.exe te starten. Klik op de tab systeem-DSN, en kies toevoegen. Selecteer de driver voor Nexus DB. Geef de connectie de naam “MediWorld?”. Verder kunnen de standaardwaarden blijven staan. Kies de juiste MediWorld?-database (bijv. MediworldACA, niet de versie met de letters YW erin) en voltooi de toevoeging. De koppeling met MediWorld is dan gelegd.