|
Installing WebUntis |
  
|
|
Installing WebUntis |
|
a) WebUntis is supplied by Gruber & Petters or your Untis partner in a zipped file with a name such as WebUntis2008_2_0_1.zip and a licence file with a name such as WUnnnnnK-08.xml (where nnnnn stands for your Gruber & Petters customer number).
Please unzip the WebUntis.war file and copy it into your Tomcat application directory (e.g. C:\Programs\Apache Software Foundation\Tomcat 5.5\webapps).
b) Launch Tomcat. Tomcat will now install WebUntis. You should now see a new WebUntis folder in the Tomcat application directory.
c) Setting up the database for WebUntis
If you did not previously copy the JDBC driver files into the Tomcat directory, you should now copy them (i.e. those with the .jar extension) from the relevant installation package into the directory WebUntis\WEB-INF\lib .
If the installation script is unable to create the database, create an empty database with the desired name manually, e.g. WebUntis, and perform the following steps.
Launch the WebUntis installation script by entering the following URL into your web browser:
http:// <Server>:8080/WebUntis/Install.do
If, for example, you have set up Tomcat and WebUntis on a computer with the IP address 10.0.0.100, the URL will be:
http://10.0.0.100:8080/WebUntis/Install.do
If Tomcat is running correctly and WebUntis has been installed you should now see a page with the title "Installation".
Please fill in the fields on this page. Input fields marked with a * are mandatory.
School short name for login
A short name used to designate your school. This is the short identifier that you specified when ordering your licence. Your input must match the short identifier in the licence details. This short name identifies your school in WebUntis and is required for login.
Client number
This field can remain empty. WebUntis will assign a number itself (normally 1). This number is used to identify your school internally in the database.
Database server
The IP address or host name of the computer running the database. You can enter localhost here if the database is running on the same computer as Tomcat.
Database name
The desired name for the database (e.g. WebUntis).
Database Select the database application that you are using, e.g. MySQL.
User name The user name that WebUntis should use to access the database.
Password
The password for the user name.
The fields „Database engine“, "JDBC database" and "JDBC database connection" are only required if you do not intend using the standard drivers.
Note: If you are using MS SQL as your database you can select either MS SQL 2000 or MS SQL 2005. Irrespective of the actual version of MS SQL used, select MS SQL 2005 if your JDBC driver is called sqljdbc.jar and MS SQL 2000 if your JDBC driver consists of 3 files (including mssqlserver.jar).
Once you have made all the entries, press <Continue>.
The installation script will generate the database, create the required database tables, create the file <WebUntis_directory>\WEB-INF\webtermin.xml with the database parameters and create the several basic data records such as the user admin.
An error message will be displayed if any problems are encountered. In this case, try to resolve the problem and launch the installation script once more.
The installation script might not be able to create the database. In this case, please create the database manually using an appropriate administration program.
If everything was successful, press <Continue> once more.
d) Installing the licence
This step enters the licence in WebUntis.
The licence page will already display the school short name. Please select your licence file, e.g. WU12345K-08.xml and press <Import> in order to activate WebUntis with your licence data.