Context Navigation

Installatiehandleiding

Timestamp:: Apr 21, 2006 3:17:52 PM (20 years ago)
Author:: annius
Comment:: --

Legend:

: Unmodified
: Added
: Removed
: Modified

Documentatie/Beheerder/Installeren/Installatiehandleiding

-                      v8
+                      v9
 == 1. Opzet van de software ==
+== Opzet van de software ==
 Om OpenAC te draaien, dienen lokaal twee dingen te worden geinstalleerd:
 …
  * 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.
+ * 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 bovendien 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.
+Het wordt afgeraden om OpenAC te installeren op een netwerkschijf.  In plaats daarvan raden we aan de starter kit op een netwerkschijf te installeren, zodat men snel met OpenAC aan de slag kan 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.
 === 3.1 MySQL ===
+== Aanmaken van een SQL-database “OpenAC” ==
+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.
+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 webser-ver IIS, apart worden aangeschaft.
+=== MySQL ===
+Maak op het bureaublad een map mysql aan.  Pak in deze map het ZIP-bestand [http://openac.fenac.nl/downloads/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!
 …
 drop database openac;
+TIP 2:  het is aan te raden vervolgens een root-wachtwoord in te stellen voor MySQL.  Zie hiervoor de MySQL-documentatie.
+TIP 2: Het is aan te raden vervolgens een root-wachtwoord in te stellen voor MySQL.  Zie hiervoor de MySQL-documentatie.
+TIP 3: Voor prettig gebruik met OpenAC moeten er instellingen worden gewijzigd in MySQL.  Zie hiervoor het voorbeeldbestand [http://openac.fenac.nl/downloads/my.ini]  Let op: deze instellingen verhogen de prestatie van de database in hoge mate, maar reserveren daarvoor vrij veel intern geheugen.
 === 3.2 Microsoft SQL server ===
+=== 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”.
+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 configu-ratiescherm; zo niet, start het dan direct op als
+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.
-== 4. De OpenAC-software zelf ==
 == 5. Eerste gebruik van OpenAC ==
+== OpenAC zelf installeren ==
 Als alle installaties goed zijn verlopen, kan OpenAC nu worden gestart (klik op openac.bat of de gemaakte snelkoppeling).
+Het installeren van OpenAC is eenvoudig.  Download de [http://openac.fenac.nl/downloads/openac-v0.90-starterkit.exe 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.
+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.
+Dit proces wordt vervolgens op elk werkstation herhaald, waarop OpenAC gaat worden gebruikt.
+Wanneer op het OpenAC-pictogram wordt geklikt, verschijnt een loginscherm.  Klik hierin op Details om de connectie met de database in te stellen.   Wanneer MySQL wordt gebruikt op het 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 altijd in als “admin” met als wachtwoord "finux".  Hierna komt men in OpenAC.
+== 6. Import van data uit een bestaande registratiepakketten ==
+Men logt op OpenAC de eerste keer in als “admin” met als wachtwoord "finux".  Hierna komt men in OpenAC.
+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.
+== 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.
 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 ===
+=== 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.
+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: eige-naar/eigenaar.  Druk twee keer OK, en de verbinding met ACACIA/Access is gelegd.
 === 6.2 !MediWorld ===
+=== !MediWorld ===
 Haal het installatiebestand NexusDB1 ODBC Driver.exe op van de download area op http://www.openac.fenac.nl/.
 …
 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 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.
-=== 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.