ShowPath?

Installatiehandleiding

Samenvatting

Dit is de installatiehandleiding voor de reken-release (t/m versie 0.59) van OpenAC Desktop, het gemeenschappelijke open source administratie- en regi-stratiesysteem dat wordt ontwikkeld binnen de FENAC.

De nadruk ligt in deze handleiding op de installatie op Microsoft Windows.

1. Opzet van de software

In tegenstelling tot vorige versies van OpenAC, is het pakket dat er nu ligt niet meer een web-applicatie, maar een zelfstandig draaiend Windows-programma. De installatie is dan ook aanzienlijk eenvoudiger. Niettemin is een database ver-eist, waardoor het installeren toch wat tijd in beslag kan nemen.

OpenAC heeft de volgende ondersteunende software nodig:

• De scriptingtaal Python, waarin ook de lokale uitbreidingen op OpenAC wor-den gebouwd. Dit systeem wordt in zijn geheel meegeleverd.
• Een database; op dit moment worden MySQL en Microsoft SQL server onder-steund.
• ODBC-drivers. Deze zijn nodig om koppelingen te maken met bestaande programmatuur zoals ACACIA, MediWorld? en ADMINAC.

Deze versie van OpenAC is bedoeld om data uit de bestaande registratiepakket-ten automatisch binnen te halen, en op basis van de binnengehaalde data een aantal verplichte registraties uit te kunnen voeren, namelijk:

• Overzichten die nodig zijn voor begroting op basis van Audiologische Producten;
• De branche-kentallen van de FENAC.

We concentreren ons in deze installatiehandleiding daarom op de installatie van OpenAC op één werkstation. De database, Python en het programma OpenAC worden in dat geval allemaal op hetzelfde systeem geïnstalleerd. Het kan bo-vendien voor de efficiëntie van de data-conversie worden aangeraden om OpenAC dan zo dicht mogelijk bij het bestaande registratiesysteem (ACACIA, MediWorld?, ADMINAC etc.) te installeren. Hiervoor is een Pentium IV-systeem met minimaal 256MB geheugen en Windows 2000 of Windows XP vereist.

Wanneer men het wenselijk vindt het OpenAC-systeem als client-serverpakket te testen, kan de installatie ook worden gescheiden:

• Men installeert dan de database-software op een server;
• Installeert Python en OpenAC op een netwerk share;
• Vervolgens kan men vanaf elk werkstation dat toegang heeft tot de netwerk-drive, OpenAC starten.

2. Om te beginnen

Log in op de informatiesite ​http://www.openac.fenac.nl/ en ga naar de afdeling downloads. Hier zijn alle pakketten te vinden die nodig zijn om OpenAC te in-stalleren. Download de volgende bestanden en sla deze tijdelijk bij elkaar in de buurt op, bijvoorbeeld in een map op het bureaublad.

Voor de werkstations, wanneer Microsoft SQL server wordt gebruikt, of al een MySQL-database elders is geïnstalleerd:

OpenAC-v0.40-YYYY-MM-DD.zip - de OpenAC software zelf OpenAC-PythonFiles?-YYYY-MM-DD.zip - de Python libraries

Voor het opzetten van een database:

mysql-4.0.23-win.zip - de MySQL server my.ini - MySQL-configuratiefile

Voor het gemakkelijk upgraden naar nieuwe versies:

TortoiseCVS-1.8.11.exe - CVS-versiebeheer

3. Aanmaken van een SQL-database “OpenAC”

Hier kan worden gekozen voor een open-source pakket (MySQL) of de microsoft-variant (SQL server). De Microsoft-variant moet, in tegenstelling tot de webser-ver IIS, apart worden aangeschaft.

De onderstaande instructies zijn identiek aan die voor de vorige versie van OpenAC (web-versie). Er hoeft dus niet opnieuw te worden geïnstalleerd, mocht men nog over een vorige installatie beschikken.

3.1 MySQL

Maak op het bureaublad een map mysql aan. Pak in deze map het ZIP-bestand mysql-4.0.20d-win.zip uit. (laatste versie beschikbaar via ​http://dev.mysql.com/downloads/mysql/4.0.html). Klik op SETUP.exe en volg al-le standaardsuggesties.

Kopieer nu bij een server-installatie eerst het bestand my.ini naar C:\WINDOWS\. Hierin staan instellingen die nodig zijn om de snelheid van de database aangenaam te maken voor het importeren van data in OpenAC. Laat deze stap achterwege bij installatie op een werkstation!

Start het programma C:\mysql\bin\winmysqladmin.exe (let op: niet “mysqlad-min.exe” zonder “win”). Wanneer het programma vraagt om een username en password, voer je in:

Username: fenac Password: dbc

Start nu een opdrachtprompt (Windows menu -> Programma’s -> Accessoires -> Opdrachtprompt) en typ:

C:\mysql\bin\mysql –u root –p <ENTER> (leeg wachtwoord) 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.

TIP 1: Wanneer MySQL al eerder is geinstalleerd, bijvoorbeeld als onderdeel van OpenAC web, dan is het aan te raden gebruik te maken van deze bestaande in-stallatie. Typ in dat geval voor de regel “create database…” de volgende regel:

drop database openac;

TIP 2: het is aan te raden vervolgens een root-wachtwoord in te stellen voor MySQL. Zie hiervoor de MySQL-documentatie.

3.2 Microsoft SQL server

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

Open na succesvolle installatie Microsoft SQL Server -> Enterprise manager van-uit het start-menu, 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 configu-ratiescherm; 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.

4. De OpenAC-software zelf

5. Eerste gebruik van OpenAC

Als alle installaties goed zijn verlopen, kan OpenAC nu worden gestart (klik op openac.bat of de gemaakte snelkoppeling).

Er verschijnt dan een loginscherm. Klik hierin op Details om de connectie met de database in te stellen. Wanneer MySQL wordt gebruikt, 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 altijd in als “admin” met een leeg wachtwoord. Hierna komt men in OpenAC.

6. Import van data uit een bestaande registratiepakketten

OpenAC v0.40 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.

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 6.1 en 6.2.

6.1 ACACIA

Start het ODBC-gegevensbronbeheer vanuit het configuratiescherm, of door di-rect 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: eige-naar/eigenaar. Druk twee keer OK, en de verbinding met ACACIA/Access is gelegd.

6.2 MediWorld

Haal het installatiebestand NexusDB1 ODBC Driver.exe op van de download area op ​http://www.openac.fenac.nl/.

Dubbelklik op het installatiebestand NexusDB1 ODBC Driver.exe. Dit installeert de ODBC-driver voor de MediWorld? database.

Start het ODBC-gegevensbronbeheer vanuit het configuratiescherm, of door di-rect C:\WINDOWS\system32\odbcad32.exe te starten. Klik op de tab systeem-DSN, en kies toevoegen. Selecteer de driver voor Nexus DB. Geef de connec-tie 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.

7. Meer begrijpen over OpenAC

In de loop van Februari 2005 komt er, net als voor de eerdere webversie, weer een technische beschrijving van OpenAC. Voor nu even de volgende uitleg: OpenAC bestaat uit een aantal applicatielagen, die elk overeenkomen ment een map in de directory openac-desktop:

desktop/ De windows/macintosh interface. logica/ Toegang tot de database en rekenfuncties. include/ Ondersteunende functionaliteit kern/ FENAC-brede data-definities en berekeningen adaptaties/ Voor elk AC een eigen map met codelijsten en berekeningen; Zie in die map het bestand init.py voor toelichting over de lokale aanpassingen die de FENAC al heeft voorbereid.

Voor de informatici onder ons: de applicatielagen zijn strikt van elkaar gescheiden:

• De module desktop maakt gebruik van een zeer beperkt aantal standaard-functies en datatypen uit de module logica.
• De module logica definieert het algemene gedrag van database, codelijsten en scripts.
• De modules desktop en logica, bevatten, op de naam OpenAC en het Open-AC-logo na, 0% code die specifiek is voor het toepassingsdomein Audiologie.

• De modules in kern definiëren de feitelijke applicatie. Net als desktop maken deze modules ook alleen gebruik van de standaardfunctionaliteit van logica.
• De modules in adaptaties zijn functioneel gelijk aan die in kern. Echter, wan-neer OpenAC draait, wordt altijd één adaptatie aangewezen als “topmodule”, die vervolgens de nodige modules uit kern importeert.

• Voor het maken van lokale aanpassingen aan de software anders dan het aanvullen van codelijsten, dient men voldoende vertrouwd te zijn met kern en adaptaties om wijzingen te maken in adaptaties. Wijzigingen in kern mogen onder geen beding worden gedaan zonder coördinatie met FENAC ICT; hier-mee gaat namelijk de mogelijkheid verloren om gebruik te maken van updates.

Alle gebruikersinstellingen worden bijgehouden in het bestand openac.ini, dat wordt aangemaakt wanneer OpenAC de eerste keer wordt opgestart.

8. Bekende beperkingen

De volgende beperkingen en bugs zijn bekend in versie 0.59 van OpenAC:

• Hoewel de software compatibel is met MacOS X, is de werking op dit platform zeer beperkt getest, en de performance van de software op de Macintosh is nog niet voldoende.