Installatie van WerkMeester WerkMeester is een WIN32 database-applicatie op basis van een enkele executable, met een aantal werkbestanden en een MySQL database. De software is niet ontwikkeld voor gebruik onder een ander besturingssysteem dan Windows. De software is volledig vanaf onze server te downloaden. De download bestaat uit 4 onderdelen: • MySQL redistributables. De bestanden zijn nodig voor het product en worden vanaf een andere locatie aangeboden, maar maken geen deel uit van het product WerkMeester. • Een ‘image’ als zip-bestand. Deze image bevat de programmadirectory. (na kopiëren letten op ‘read-only’-tag!!). Deze image kan worden gebruikt bij herinstallatie voor een nieuwe installatie. • Een zip-bestand met hulpbestanden, waaronder: o Lettertype voor barcode • De meest recente wm.exe (de executable)
Installatie De installatie van WerkMeester bestaat uit de volgende stappen: 1. Installeren van de MySQL database-server 2. Configureren en starten van de My-SQL server 3. Plaatsen van de applicatiebestanden 4. Inrichten van de database van WerkMeester 5. Configureren applicatie (WM.ini) 6. Lettertype voor barcode installeren 7. Meest recente versie van wm.exe downloaden 8. Registreren van WerkMeester 9. Raadplegen helpfile voor het werken met WerkMeester 10. Eerste keer inloggen Hierna worden deze stappen behandeld.
Installatiehandleiding WerkMeester 2010
1 van 11
1. Installeren van MySQL database-server De MySQL Community database-server kan onder de GNU General Public License, (GPL) zonder kosten of registratie worden gebruikt. Voor de exacte (en juridisch geldige) teksten van de GPL-licentie kan men terecht op de site van GNU. Installatie dient door de gebruiker zelf te geschieden. WerkMeester draait onder MySQL CommunityServer versie 4 of 5. Beta-releases of hogere releases van MySQL worden niet ondersteund. Als regel zullen hogere versies geen problemen geven, tenzij dat expliciet wordt aangegeven door MySQL. WerkMeester is zowel stand-alone als in een netwerk te gebruiken. De databaseserver kan op een willekeurige server worden geïnstalleerd. Omdat de applicatie door middel van IP-protocol communiceert met de server is er geen verschil in installatie in stand-alone of netwerk. De server maakt standaard gebruik van poort 3306. In de regel staat deze poort open op het interne netwerk. De data van de MySQL-database(te backuppen) moet op dezelfde host staan als de MySQLserver! (standaard-instelling MySQL) De MySQL databaseserver wordt geïnstalleerd met behulp van de installatiebestanden. Ga hiervoor naar http://www.mysql.com/downloads/mysql/. Vanaf onze server zijn 2 setupkits te downloaden als extra service: o De MySQL-server: http://www.fesp.nl/producten/werkmeester/download/mysqlessential-5.0.45-win32.msi o De administrator-tool: http://www.fesp.nl/producten/werkmeester/download/mysql-guitools-5.0-r12-win32.msi
Installatiehandleiding WerkMeester 2010
2 van 11
2.Configureren en starten MySQL DataBase Het instellen van de MYSQL database gebeurt tijdens de installatie. Na de installatie start de MySQL-database-service (indien ingesteld) automatisch op. !!Installeren van een MySQL-server is werk voor een applicatiebeheerder. Eventueel kunnen we ondersteuning verzorgen.
Installatiehandleiding WerkMeester 2010
3 van 11
3. Plaatsen van de applicatiebestanden o Download de image:
http://www.fesp.nl/producten/werkmeester/download/WorkDir.zip o Zet de image met alle bestanden lokaal of op een server o Maak een snelkoppeling naar ….\workdir\wm.exe voor de gebruikers o Stel de rechten in: o Geef alle gebruikers leesrechten o Geef hoofdgebruikers alle rechten Zorg voor een regelmatige back-up. Hoofdgebruikers voegen bestanden toe aan deze map.
Installatiehandleiding WerkMeester 2010
4 van 11
4. Inrichten van de database van WerkMeester De database van WerkMeester moet worden aangemaakt op de server. Daarvoor kan de administratortool worden gebruikt. Stap 1: Log in met (het in de installatie opgegeven) login voor de administrator. (standaard is dat root, zonder wachtwoord)
Stap 2: Importeer de database: o Kies ‘Restore’ o Kies ‘Open BackUp File’
Installatiehandleiding WerkMeester 2010
5 van 11
o Kies het bestand WM_MySQL_BackUp.sql in de map WerkMeester\WorkDir\BackUp
o Stel de ‘ Restore Options’ in zoals hierboven aangegeven o Kies Start Restore
Installatiehandleiding WerkMeester 2010
6 van 11
o Bij ‘Catalogs’ zal nu de database zijn geplaatst met alle tabellen. Stap 3: Maak gebruiker voor database aan
o Gebruiker: werkmeester o Wachtwoord: Bel 0683 233 184 voor wachtwoord Stap 4: Geef gebruiker rechten op database Installatiehandleiding WerkMeester 2010
7 van 11
Stap 5: Stel backup van de database in U kunt de backup laten draaien vanuit de administratortool, als job. Maar er zijn ook voldoende eenvoudige scripts te vinden. Er wordt dan een database_yymmdd_hhmmss.sql bestand gemaakt. Dit is een tekstbestand. Voor vrijwel alle gebruik een prima oplossing. U kunt alle informatie over database-backup vinden op http://www.mysql.com/products/backup/ .
Stap 6: Sluit administratortool af. De database is nu klaar voor gebruik.
Installatiehandleiding WerkMeester 2010
8 van 11
5. Configureren van de applicatie De applicatie wordt automatisch geconfigureerd. De executable (wm.exe) maakt zelf een bestand aan: wm.ini, in de root van het programma (de map workdir.) Het bestand is te bewerken met een tekst-editor en ziet er zo uit: [server] server=localhost port=3306 [database] database=werkmeester lijst=0 standaard=werkmeester [registratie] registratie=demo [klokken] keuze=1 Wanneer de instellingen niet juist zijn, opent wm.exe het volgende scherm:
o o
Username: zit in het programma geprogrammeerd. Komt overeen met de gebruiker in de MySqlServer. Wordt niet opgeslagen in wm.ini. Password: zit in het programma geprogrammeerd. Komt overeen met wachtwoord van de gebruiker in de MySqlServer (mag worden gewijzigd! – maar dan moet telkens het wachtwoord worden opgegeven bij de inlog). Wordt niet opgeslagen in wm.ini.
Installatiehandleiding WerkMeester 2010
9 van 11
o o o
Server: dit is de naam van de server. Kan ip-adres zijn of hostname. Wordt opgeslagen in wm.ini. Port: IP-poort gebruikt door MySQL-server. Wordt opgeslagen in wm.ini. Database: Lijst met beschikbare databases op de server. (zie hieronder)
Na invoeren van de juiste parameters start WerkMeester op, en wordt het wm.ini-bestand gevuld met de juiste gegevens.
Meerdere databases. Er kunnen meerdere databases worden gebruikt. In de MySql-server moet dan voor iedere database het inrichten van de database worden herhaald. Door Original Schema bij optie Target Schema te vervangen door bijv ‘Timmerafdeling’, kan WerkMeester door meerdere afdelingen met een eigen database worden gebruikt. Er kan dan worden gekozen voor een eigen workdir met WM.ini: In WM.ini moet de entry database worden aangepast. [database] database=Timmerafdeling lijst=0 Er kan ook worden gekozen voor één workdir met een keuzemogelijkheid voor de database: [database] database=eendatabase lijst=1
Installatiehandleiding WerkMeester 2010
Vul in ieder geval één geldige database in
10 van 11
6. Lettertype barcode installeren De applicatie gebruikt barcodes. Op ieder werkstation dat WerkMeester gebruikt moet het bijgeleverde (gratis) lettertype worden geïnstalleerd. Het lettertype is te vinden in de map …\workdir\BarcodeFont\.
7. Meest recente versie van WerkMeester downloaden Wanneer WerkMeester moet worden geüpdate krijgt de applicatiebeheerder bericht via de email. De meest recente executable (WM.exe) staat op www.fesp.nl/producten/werkmeester/help . 8. Registratie van WerkMeester Wanneer WerkMeester is geïnstalleerd kan het programma de registratiecode ‘demo’ worden gebruikt. Een registratiecode kan worden aangevraagd door een e-mail te sturen naar:
[email protected] , met de volgende gegevens:
• • • •
Correcte gespelde naam van de school Adres en contactgegevens van de school Correcte gespelde naam van de host waarop de MySQL-server draait Naam en emailadres van de applicatiebeheerder
Er wordt dan een nieuwe executable beschikbaar gesteld, met registratiecode. 9. Raadplegen helpfile van WerkMeester De helpfile staat op www.fesp.nl/producten/werkmeester/help . 10. Eerste keer inloggen U kunt de eerste keer inloggen met beheerder / beheerder. Zie de helpfile om dit te wijzigen.
Veel plezier met WerkMeester. Hans Hoogbergen Footprint ESP 0683 233 184 Installatiehandleiding WerkMeester 2010
11 van 11