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
. <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 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 het licentiebestand te selecteren.
Na een klik op de button 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
