Nõuded süsteemile
=================

* Apache veebiserver, sealjuures:
** .htaccess kasutamise võimalus
** mod_rewrite
* PHP versioon 4.1 või uuem
** PHP peab olema kompileeritud GNU gettext toega
* MySQL 4.1 või uuem

VIKO töötamiseks on hädavajalik, et VIKO oleks installeeritud eraldi domeeni või
alamdomeeni. Sobivad näiteks: example.com, viko.example.com, localhost. Ei sobi:
www.example.com/viko/, localhost/viko/ jms.


Installeerimisjuhend
====================

1. Aseta VIKO lähtekood veebiserveri avalikku kataloogi. VIKO tarballi
lahtipakkimisel, näiteks käsuga

 tar -xvzf viko-2.0.tar.gz

tekib kataloog viko/. Selle sisu ongi tarvis tõsta veebiserveri avalikku
kataloogi. Näiteks FTP programmiga, kui server ei asu kohalikus masinas.

VIKO failid on jaotatud järgmistesse alamkataloogidesse:

* viko/css/ - stiililehed
* viko/img/ - pildid
* viko/js/ - JavaScripti failid
* viko/locale/ - tõlked
* viko/lib/ - VIKO oma koodifailid
* viko/PEAR/ - PEAR'i paketid
* viko/sql/ - andmebaasi struktuur

Kataloogi sql/ ning faile INSTALL, LICENSE ja CHANGELOG pole tarvis
veebiserverisse paigutada - VIKO töötamine nendest ei sõltu.

Tähele tasub panna, et peakataloogis on ka fail .htaccess, mis võib *UNIX
süsteemis tegutsedes jääda nähtamatuks. Ka see tuleb kindlasti paigutada
veebiserverisse.

2. Loo MySQL andmebaas. Kasutades siis selleks mõnda graafilist liidest nagu
PhpMyAdmin või lihtsalt käsurealt:

 CREATE DATABASE viko;

3. Loo VIKO andmebaasistruktuur. SQL-kood struktuuri loomiseks asub failis
sql/viko.sql. Kasutades PhpMyAdmin'i saab selle faili käivitada kasutades
import-funktsiooni. Käsurealt:

 SOURCE sql/viko.sql;

4. Loo MySQL andmebaasi kasutajakonto, mida hakkab kasutama VIKO PHP kood ja
määra loodud kasutajakontole minimaalselt õigused DELETE, INSERT, SELECT ja
UPDATE õpikeskkonna VIKO andmebaasile. Kui veebiserver on samas masinas
(localhost), kasutajanimeks "vikouser" ja parooliks "vikopass" siis:

 GRANT DELETE,INSERT,SELECT,UPDATE
 ON viko.*
 TO 'vikouser'@'localhost'
 IDENTIFIED BY 'vikopass';

5. Ava fail viko/viko.conf ning asenda seal andmebaasi nimi, kasutajanimi ja
parool:

 database_name = viko
 database_username = vikouser
 database_password = vikopass

Soovi korral võid muuta ka muid konfiguratsiooniseadeid.

6. Kustuta fail convert-viko-files.php - see on tarvilik vaid neile, kes
uuendavad VIKO-t vanema versiooni pealt.

7. Käivita brauser ja mine aadressile, kuhu sa viko installeerisid, a'la
http://viko.example.com. Esimene sisselogimine administraatori liidesesse toimub
kasutajanime "admin" ja parooli "admin" abil.


Versiooniuuendus
================

** Uuendamine versioonilt 1.1 versioonile 2.0 **

NB! Enne uuendamist tee varukoopia VIKO andmebaasist ja failidest files/
kataloogis.

1. Märgi üles failis include/mysql_connect.php olevad andmebaasi ühendumise
andmed.

2. Eemalda VIKO kataloogist kõik failid ja kataloogid v.a. files/.

 rm -R .htaccess *.php admin/ css/ gif/ include/ opetaja/ sql/

3. Paki viko-2.0.tar.gz lahti viko kausta.

 tar -xzvf viko-2.0.tar.gz

4. Muuda andmebaasiühenduse andmed failis viko.conf.

5. Uuenda VIKO andmebaasistruktuur, käivitades andmebaasis skripti, mis asub
failis sql/changes_2.0.sql.

6. Mine brauseriga aadressile minu.viko.server/convert-viko-files.php ning järgi
seal olevaid instruktsioone, et laadida kataloogis files/ olevad failid
andmebaasi. Peale selle tegevuse edukat õnnestumist võid files/ kataloogi
kustutada. Samuti tuleks kustutada kasutatud skript convert-viko-files.php