Installatie WebUntis 2013

WebUntis 2014
Instructies basisinstallatie
Copyright © 2013 Untis Benelux Rotterdam
Installatie WebUntis
1 Algemeen ....................................................2
1.1
1.2
1.3
1.4
Java JRE 7 ........................................................................... 2
Apache Tomcat .................................................................. 2
Een database. ..................................................................... 4
JDBC-Driver ........................................................................ 4
2 WebUntis installeren ....................................5
2.1 Initialiseren van WebUntis .................................................. 5
2.2 Opstarten WebUntis ........................................................... 8
2.3 Instellen Nederlandse taal .................................................. 8
3 Bijlage: installatie MySQL ...........................10
3.1 Installatie: MySQL Server 5 ............................................... 10
3.2 Installatie MySQL Workbench ........................................... 10
1
Installatie WebUntis
2
1 Algemeen
WebUntis 2014 werkt goed samen met Untis 2013 (vanaf 3-2-2014) of hoger.
Om WebUntis te kunnen installeren, dienen de onderstaande onderdelen
aanwezig te zijn.
Let op!
De browser Internet Explorer moet van versie 9 of hoger zijn. Browsers als
Chrome of Firefox werken sneller.
1.1 Java JRE 7


Pagina: http://www.java.com/nl/download
Selecteer: Gratis Java-download
1.2 Apache Tomcat
1.2.1
Apache Tomcat 7.x Servlet/JSP Container


1.2.2
Pagina: http://tomcat.apache.org/download-70.cgi
Selecteer: Windows Service installer (pgp, md5)
Tomcat: User voor webuntis toevoegen
Voor het installeren van WebUntis 2014 moet eenmalig in Tomcat een user
webuntis worden toegevoegd.
 Open ../Apache Software foundation/Tomcat 7.0/conf/tomcat-users.xml
 Voeg de onderstaande regels toe onder het kopje <tomcat-users>.
<role rolename="webuntis"/>
<user username="admin" password="admin" roles="webuntis"/>
1.2.3
Maximaal te gebruiken geheugenruimte
Standaard is door Tomcat de maximaal te gebruiken geheugenruimte zeer
gering ingesteld. Wij raden u daarom aan om deze te verhogen. De grootte is
afhankelijk van de vrije geheugencapaciteit van de server.
Installatie WebUntis
3
Windows: venster Apache Tomcat properties - tabblad Java Linux:
1.2.4
Maximum Permanent Memory Size
Afhankelijk van de snelheid en de geheugencapaciteit van de server kunnen
deze waarden lager (of hoger) worden ingesteld. WebUntis werkt sneller met
hogere waarden.
Als WebUntis heel langzaam wordt of af en toe hangt, dan zie je soms in een
logfile (../Tomcat 7
Probeer in dit geval de Maximum Permanent Memory Sizehoger in
te stellen.
Voor bijv. 1024 Mb is dit het volgende commando (zie ook afbeelding):
-XX:MaxPermSize=1024m
Windows: venster Apache Tomcat properties  tabblad Java  Java options.
Linux: parameter in het startscript van Tomcat
1.2.5
Codetabel wijzigen
WebUntis werkt standaard met de codetabel ISO-8859-1. Indien gewenst, kan
WebUntis ook met de codetabel Unicode UTF-8 functioneren.
Voer hiertoe bij de Java options de volgende parameter toe :
-Dwebuntis.encoding=UTF-8
Installatie WebUntis
1.2.6
4
Activeren van Apache Tomcat
Apache Tomcat kan worden gestart of gestopt in het venster
7.0 Tomca
. Dit venster kan worden geopend via:
C:\Program Files\Apache Software Foundation\Tomcat 7.0\bin\Tomcat7w.exe
 Start na het instellen van de bovenstaande aanwijzingen Tomcat een keer
opnieuw op.
1.3 Een database.
Op dit ogenblik worden MySQL vanaf versie 5.1 (zie bijlage) en Microsoft SQL
Server 2005 en 2008 ondersteund.
1.4 JDBC-Driver
Voor verbinding met de database is een driver nodig.

MySQL
http://www.mysql.com/downloads/connector/j/
drivernaam: mysql-connector-java-5.1.21.zip
MS SQL
http://www.microsoft.com/download/en/driver.aspx?q=driver
Microsoft JDBC Driver 4.0 for SQL Server
drivernaam: Sqljdbc4.jar
Plaats de driver in de map: ..\Apache Software Foundation\Tomcat 7.0\lib
Let op!
Hebt u niet voldoende rechten om de driver in deze map te plaatsen, dan kan
de driver ook in de map ..\Webapps\WebUntis\WEB-INF\lib worden geplaatst.
Installatie WebUntis
5
Houdt u er dan wel rekening mee dat bij iedere update de driver opnieuw in
deze map geplaatst moet worden.

Start de Apache software opnieuw op.
2 WebUntis installeren



Download de file WebUntis2014_8_0_71.zip (of latere versie) naar een map
op de computer.
De zip bevat de file WebUntis.war en deze file moet geplaatst worden in de
map ..\Apache Software Foundation\Tomcat 7.0\webapps.
Tomcat herkent deze file en installeert (direct) automatisch de software in de
map ..\WebUntis. Zo niet, dan is de Apache server niet actief en moet deze
gestart worden.
2.1 Initialiseren van WebUntis


Start een Internet browser.
Activeer de file http:/<server>:8080/WebUntis/super/inst.do
<server> is localhost voor installatie op uw eigen pc of het IP-adres van de webserver.
Er verschijnt een venster, waarin de gebruikersnaam en het wachtwoord voor
Tomcat wordt gevraagd. Voer
(zie hoofdstuk 1.2.2).
In het venster kunnen de volgende velden worden ingevoerd.
Schoolnaam
Naam volgens de licentie van WebUntis.
Mandantnummer
Is standaard nummer 1. Als verschillende afdelingen in één WebUntis werken,
dan kan elke afdeling gegevens im- en exporteren onder een eigen nummer (en
met een eigen licentienaam).
Database server
Op welke webserver staat de database. In het voorbeeld staat localhost, ofwel
mijn eigen computer. In werkelijkheid zal naar het IP-adres van de webserver
worden verwezen.
Databasenaam
Hoe moet de database (schema in MySQL) gaan heten.
Installatie WebUntis
6
Let op!
U kunt vooraf zelf de database definiëren of uw kunt een vinkje plaatsen bij
tabase aanmaken
se automatisch tijdens de WebUntis
installatie wordt aangemaakt. In het laatste geval mag de databasenaam nog
niet bestaan, anders stopt de installatieprocedure.
Database
Welke database wordt gebruikt? Op dit ogenblik worden MySQL vanaf versie
5.1 en Microsoft SQL Server 2005/2008 ondersteund.
Gebruikersnaam en wachtwoord
De gebruikersnaam en het wachtwoord waarmee u rechten hebt tot de
database.
Voor het installeren van WebUntis (aanmaken van de database) zijn meer
rechten noodzakelijk dan voor het dagelijks gebruik van WebUntis. In het veld
kunt u eventueel de naam invoeren van de
Installatie WebUntis
7
gebruiker met voldoende rechten voor de installatie. De naam en het
wachtwoord van deze gebruiker wordt niet bewaard, dus nergens opgeslagen.
Let op!
Als u een gebruikersnaam met privileges invoert, dan moet u toch ook de
eerste gebruikersnaam (met gewone databaserechten) invoeren.
Database engine / JDBC databasedriver
Als u niets invoert, wordt automatisch de standaarden gebruikt.
JDBC databaseverbinding
Als localhost als databaseserver en webuntis als databasenaam is ingevoerd,
dan wordt standaard (bij geen invoer) de onderstaande string voor de JDBC
databaseverbinding gebruikt.


MySQL
dbc:mysql://localhost/
MS SQL
jdbc:sqlserver://localhost;databaseName=webuntis;selectMethod=cursor
Voorbeeld
De default instance van de databaseserver MySQL gebruikt port 3306. Wilt u
een andere instance gebruiken, dan moet u de bovenstaande string invoeren en
achter localhost een dubbele punt met het portnummer van de instance
vermelden (bijv localhost:3307).
Ook i
atabase server moet het portnummer worden toegevoegd.
Na een klik op <Verder> worden in de database alle benodigde tabellen
aangemaakt en gevuld met basisinformatie, zoals:



aanmaken (of updaten) van het bestand ..WEB-INF\webtermin.xml. Hierin
staat informatie over de databaseverbinding.
aanmaken van tabellen.
aanmaken van basisinformatie voor de school.
U krijgt het verzoek om met de button <Bladeren> het licentiebestand te
selecteren.
Na een klik op de button <Import> volgt nog een bevestiging van WebUntis.
Installatie WebUntis
8
2.2 Opstarten WebUntis




Start een internet browser.
Activeer de url: http://localhost:8080/WebUntis
Meldt u aan met de schoolnaam (naam volgens de licentie van WebUntis)
Voer de gebruikersnaam admin met wachtwoord admin (standaard
aanwezig).
2.3 Instellen Nederlandse taal



Selecteer Administration  Benutzer  admin, selecteer Niederländisch en
sla op met button <Speichern>.
Selecteer Administration  Benutzer  Untis, selecteer Niederländisch en
sla op met button <Speichern>.
Selecteer Administration  Einstellungen, selecteer Niederländisch en sla op
met button <Speichern>.
Let op!
Lizenz
bevat de eerste licentieregel van de Untis
licentie en niet de WebUntis licentienaam. Mocht dit veld nu nog leeg zijn,
voer dan handmatig de eerste licentienaam in. Deze invoer is belangrijk voor de
export van Untis naar WebUntis.


Klik op Abmelden in de menubalk.
WebUntis bevat nu de Nederlandse taal. U kunt zich aanmelden in de
horizontale balk.
Installatie WebUntis
9
Installatie WebUntis
10
3 Bijlage: installatie MySQL
3.1 Installatie: MySQL Server 5

Pagina: http://www.mysql.com/downloads/mysql/
Let op!
Als een Personal Firewall is geactiveerd, dan moet port 3306 open staan voor
MySQL.
Start de MySQL installatie en gebruik de standaard wizard instellingen.
3.2 Installatie MySQL Workbench



Pagina: http://www.mysql.com/downloads/workbench
Selecteer: MySQL Workbench 6.1.4 (of hoger)
Bestandsnaam: mysql-workbench-community-6.1.4-win32.msi