Changes between Version 3 and Version 4 of Documentatie/Beheerder/Installeren/Installatiehandleiding


Ignore:
Timestamp:
Apr 21, 2006 10:55:12 AM (20 years ago)
Author:
henk
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • Documentatie/Beheerder/Installeren/Installatiehandleiding

    v3 v4  
    11[[ShowPath]] 
     2[[TOC(heading=Inhoudsopgave)]] 
     3  
    24= Installatiehandleiding = 
    35 
    4 == Voor het eerst opstarten == 
     6== Samenvatting == 
    57 
    6 Om OpenAC in gebruik te nemen, zoek je de centrale installatie van OpenAC op.  Meestal staat deze op een netwerkschijf.  Op die centrale locatie staat een bestand '''setup.bat'''.  Dubbelklik hierop, en wacht tot een schermpje verschijnt met drie pastelkleurige boxjes.  Klik onderin dit scherm op '''snelkoppeling'''. 
     8Dit 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. 
     9 
     10De nadruk ligt in deze handleiding op de installatie op Microsoft Windows. 
     11 
     12== 1. Opzet van de software == 
     13 
     14In 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. 
     15 
     16OpenAC heeft de volgende ondersteunende software nodig: 
     17 
     18 * De scriptingtaal Python, waarin ook de lokale uitbreidingen op OpenAC wor-den gebouwd.  Dit systeem wordt in zijn geheel meegeleverd. 
     19 * Een database; op dit moment worden MySQL en Microsoft SQL server onder-steund. 
     20 * ODBC-drivers.  Deze zijn nodig om koppelingen te maken met bestaande programmatuur zoals ACACIA, MediWorld en ADMINAC. 
     21 
     22Deze 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: 
     23 
     24 * Overzichten die nodig zijn voor begroting op basis van Audiologische Producten; 
     25 * De branche-kentallen van de FENAC. 
     26 
     27We 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.  
     28 
     29Wanneer men het wenselijk vindt het OpenAC-systeem als client-serverpakket te testen, kan de installatie ook worden gescheiden: 
     30 
     31 * Men installeert dan de database-software op een server;  
     32 * Installeert Python en OpenAC op een netwerk share; 
     33 * Vervolgens kan men vanaf elk werkstation dat toegang heeft tot de netwerk-drive, OpenAC starten.    
     34 
     35== 2. Om te beginnen == 
     36 
     37Log 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. 
     38 
     39Voor de werkstations, wanneer Microsoft SQL server wordt gebruikt, of al een MySQL-database elders is geïnstalleerd: 
     40 
     41OpenAC-v0.40-YYYY-MM-DD.zip                     - de OpenAC software zelf 
     42OpenAC-PythonFiles-YYYY-MM-DD.zip               - de Python libraries 
     43 
     44Voor het opzetten van een database: 
     45 
     46mysql-4.0.23-win.zip                            - de MySQL server 
     47my.ini                                                  - MySQL-configuratiefile 
     48 
     49Voor het gemakkelijk upgraden naar nieuwe versies: 
     50 
     51TortoiseCVS-1.8.11.exe                          - CVS-versiebeheer 
     52  
     53== 3. Aanmaken van een SQL-database “OpenAC” == 
     54 
     55Hier 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. 
     56 
     57De 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. 
     58 
     59 
     60=== 3.1 MySQL === 
     61 
     62Maak 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. 
     63 
     64Kopieer 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! 
     65 
     66Start 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: 
     67 
     68        Username:               fenac 
     69        Password:               dbc 
     70 
     71Start nu een opdrachtprompt (Windows menu -> Programma’s -> Accessoires -> Opdrachtprompt) en typ: 
     72 
     73C:\mysql\bin\mysql –u root –p 
     74<ENTER>                       (leeg wachtwoord) 
     75create database openac; 
     76grant all on openac.* to 'fenac'@'%' identified by 'dbc'; 
     77grant all on openac.* to 'fenac'@'localhost' identified by 'dbc'; 
     78exit 
     79 
     80De OpenAC-database is nu aangemaakt. 
     81 
     82TIP 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: 
     83 
     84drop database openac; 
     85 
     86TIP 2:  het is aan te raden vervolgens een root-wachtwoord in te stellen voor MySQL.  Zie hiervoor de MySQL-documentatie. 
     87  
     88=== 3.2 Microsoft SQL server === 
     89 
     90Installeer de “development server” vanaf de Microsoft SQL server CD. 
     91 
     92Open 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”. 
     93 
     94We gaan nu naar het ODBC-koppelingsbeheer, meestal te vinden in het configu-ratiescherm; zo niet, start het dan direct op als  
     95 
     96C:\WINDOWS\system32\odbcad32.exe 
     97 
     98In 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. 
     99 
     100== 4. De OpenAC-software zelf == 
     101 
     102== 5. Eerste gebruik van OpenAC == 
     103 
     104Als alle installaties goed zijn verlopen, kan OpenAC nu worden gestart (klik op openac.bat of de gemaakte snelkoppeling). 
     105 
     106Er 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. 
     107 
     108Gebruikers 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. 
     109 
     110Men logt altijd in als “admin” met een leeg wachtwoord.  Hierna komt men in OpenAC. 
     111  
     112== 6. Import van data uit een bestaande registratiepakketten == 
     113 
     114OpenAC 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. 
     115 
     116De 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. 
     117 
     118Voor 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. 
     119  
     120=== 6.1 ACACIA === 
     121 
     122Start 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. 
     123 
     124=== 6.2 MediWorld === 
     125 
     126Haal het installatiebestand NexusDB1 ODBC Driver.exe op van de download area op http://www.openac.fenac.nl/. 
     127 
     128Dubbelklik op het installatiebestand NexusDB1 ODBC Driver.exe.  Dit installeert de ODBC-driver voor de MediWorld database.    
     129 
     130Start 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. 
     131  
     132=== 7. Meer begrijpen over OpenAC === 
     133 
     134In 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:  
     135 
     136desktop/                De windows/macintosh interface. 
     137logica/         Toegang tot de database en rekenfuncties. 
     138include/                Ondersteunende functionaliteit 
     139kern/                   FENAC-brede data-definities en berekeningen 
     140adaptaties/     Voor elk AC een eigen map met codelijsten en berekeningen; 
     141Zie in die map het bestand __init__.py voor toelichting over de lokale aanpassingen die de FENAC al heeft voorbereid. 
     142 
     143Voor de informatici onder ons: de applicatielagen zijn strikt van elkaar gescheiden: 
     144 
     145 * De module desktop maakt gebruik van een zeer beperkt aantal standaard-functies en datatypen uit de module logica. 
     146 * De module logica definieert het algemene gedrag van database, codelijsten en scripts. 
     147 * 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. 
     148 
     149 * De modules in kern definiëren de feitelijke applicatie.  Net als desktop maken deze modules ook alleen gebruik van de standaardfunctionaliteit van logica. 
     150 * 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. 
     151 
     152 * 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. 
     153 
     154Alle gebruikersinstellingen worden bijgehouden in het bestand openac.ini, dat wordt aangemaakt wanneer OpenAC de eerste keer wordt opgestart. 
     155 
     156 
     157== 8. Bekende beperkingen == 
     158 
     159De volgende beperkingen en bugs zijn bekend in versie 0.59 van OpenAC: 
     160 
     161* 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. 
     162