# Vodič po namestitvi Dokeos 1.6.3

Zahvaljujemo se vam, ker ste si prenesli Dokeos! To besedilo vas bo vodilo preko osnovnih korakov namestitve Dokeos 1.6.3. Preberite ga v celoti preden pričnete z namestitvijo.

Ta vodič je dostopen tudi v drugih jezikih, seznam se nahaja na tej strani. Spletna stran Dokeos bo vsebovala obvestilo vsakič, ko bo dostopen nov prevod.

Tole je le kratek vodič po postopku namestitve. Pripravljamo priročnik s podrobnejšimi informacijami o namestitvi, ki pa v času nastanka tega dokumenta še ni na voljo. Ko bo, bo priročnik dostopen na naslovu Dokeos documentation page. Nastajanje priročnika si lahko ogledate na web writing area. Vzdržujemo tudi seznam pogosto zastavljenih vprašanj (FAQ).

Vsebina

1. Zahteve
2. Namestitev nove različice Dokeos
3. Nadgradnja predhodne različice Dokeos
4. Odpravljanje težav
5. Administracija
6. Ldap (opcijsko)

## 1. Zahteve

Dokeos je spletna aplikacija, ki za svoje delovanje zahteva nekaj dodatne programske opreme:

- Spletni strežnik - priporočamo Apache
- PHP
- MySQL strežnik podatkovne baze

Ta programska oprema mora biti nameščena na računalniškem sistemu preden pričnete z namestitvijo Dokeos.
Zahtevano programsko opremo lahko namestite po delih (vsako posamezno), kar ponavadi daje boljše rezultate. Uporabniki začetniki, ki bi želeli preskusiti Dokeos, pa lahko uporabijo sestavljen paket programske opreme (bundle) , ki vse potrebno namesti z enim samim namestitvenim postopkom. Če želite tak sestavljen paket, priporočamo Wamp (dostopen na WAMP5 spletni strani, pri tem potrebujete tudi PHP4 add-on) ali XAMP.

### 1.1. Spletni strežnik

Priporočamo Apache spletni strežnik. Dokeos vsebuje možnosti izkoriščanja nakaterih Apache varnostnih mehanizmov. Če vam ta ne odgovorja, lahko uporabite poljuben drug spletni strežnik. Za ustrezno uporabo varnostnih mehanizmov Apache spletnega strežnika, morate namestiti in aktivirati Apache modul mod_rewrite. Pravila mod_rewrite za Dokeos so zapisana v .htaccess datoteki mape courses, torej jih morate omogočiti v nastavitvah strežnika Apache (AllowOverride FileInfo v datoteki httpd.conf).
Prenesi si Apache spletni strežnik
Priročnik za uporabo Apache spletnega strežnika

### 1.2. PHP

Potrebujete PHP verzije 4.3.2 ali kasnejše (4.x verzije), konfiguriranega z naslednjimi moduli : mysql, zlib, preg, xml. PHP verzije 5 ali novejši še niso podprti s strani Dokes. Potrebujete tudi ldap modul , če želite uporabljati ldap v povezavi z Dokeos. Večina PHP4 predprevedenih distribucij prihaja z vsemi naštetimi moduli. Kakorkoli že, njihova prisotnost se preveri v Dokeos namestitvenem postopku.
Prenesi si PHP
PHP priročnik

Nekateri uporabniki lahko naletijo na težave v primeru, de se nastavitev PHP razlikuje od:

- short_open_tag = On
- safe_mode = Off
- magic_quotes_gpc = On
- magic_quotes_runtime = Off

Predhodne različice Dokeos zahtevajo register_globals nastavljen na vrednost On. To ni več potrebno.

BSD uporabniki: naslednje php knjižnjice (moduli) morajo biti vključeni v namestitev php:

- php-mysql The mysql shared extension for php
- php-pcre The pcre shared extension for php
- php-session The session shared extension for php
- php-zlib The zlib shared extension for php
- (opcijsko) php-ldap če želite uporabiti LDAP autentifikacijo

### 1.3. MySQL strežnik podatkovne baze

Potrebujete uporabniško ime in geslo, ki dovoljujeta upravljanje in kreiranje vsaj ene podatkovne baze. Dokeos vam prednastavljeno kreira novo podatkovno bazo z vsakim kreiranim tečajem. To pomeni, da vam mora strežnik dovoliti kreiranje in upravljanje večih podatkovnih baz. V postopku namestitve lahko izberete namestitev z eno samo podatkovno bazo, če vam ponudnik storitve ne omogoča kreiranje večih.
Prenesi si MySQL strežnik
MySQL uporabniški priročnik

Opomba:
Vse kaže da znak za povešenko /backticks character/ (`), vstavljen v večino Dokeos SQL povpraševanj od različice 1.3 ne deluje z MySQL verzijami pred 3.23.6.

### 1.4. Pravice dostopa

Nadalje, potrebujete pisalni dostop (Write access) pri dostopu do spletnih map, kjer se nahaja nameščen Dokeos. Na Windows platformah z lokalno namestitvijo to ni problem. Pri oddaljenem dostopu pa potrebujete dovoljenje za funkcijo CHMOD vsled uporabe protokolov FTP, telnet ali drugih.

## 2. Namestitev nove različice Dokeos

2.1. Prenesite si 1.6.3 namestitveni paket (.zip za Windows uporabnike ali .tar.gz za ostale) s Dokeos spletnega naslova.

2.2. Dekomprimirajte (unzip / untar) prenesen namestitveni paket. Večina novejših operacijskih sistemov je to zmožna izvesti z vgrajenimi grafičnimi aplikacijami, če pa to ne deluje, lahko to izvedete preko ukaznega poziva: v mapi, kamor ste si prenesli namestitveni paket odtipkajte tar -zxvf dokeos-1.6.3.tar.gz

2.3. Prestavite (FTP, SCP, lokalno kopiranje datotek) vsebino Dokeos namestitvenega paketa na želeno spletno stran spletnega strežnika (ali v korensko mapo spletnega strežnika ali njegovo poljubno podmapo). Vaš spletni strežnik je lahko tudi vaš lokalni računalnik. Pazite, da boste prestavili vse mape (archive, home, claroline, courses) kot tudi vse .php datoteke.

Za Windows uporabnike, ki nameščajo Dokeos lokalno: če uporabljate Apache/PHP/MySQL sestavljen paket, uporabite funkcijo povleci in izpusti (drag and drop) na vsebini Dokeos namestitvenega paketa v WWW mapo nameščenega sestavljenega paketa:

- EasyPHP - C:\Program Files\easyphp\www\
- WAMP - C:\Program Files\wamp\www\
- XAMP - C:\Program Files\xamp\www\

2.4. Naslednje mape morajo imeti bralne, pisalne in izvršilne pravice za vse in vsakogar:

- dokeos/claroline/inc/conf/
- dokeos/claroline/garbage/
- dokeos/claroline/upload/
- dokeos/archive/
- dokeos/courses/
- dokeos/home/

Na operacijskih sistemih Linux, Mac OS X in BSD lahko uporabite ukaz CHMOD 777 za dodeljevanje pravic. Pri Windows OS, preverite lastnosti map (klik z desnim miškinim gumbom na mapi).

2.5. Naslednje mape morajo imeti bralne in pisalne pravice za vse in vsakogar:

- dokeos/claroline/inc/conf/claro_main.conf.php (če obstaja)
- dokeos/home/*.html

Na operacijskih sistemih Linux, Mac OS X in BSD lahko uporabite ukaz CHMOD 666. Pri Windows OS, preverite lastnosti map (klik z desnim miškinim gumbom na mapi).

OPOMBA:
Ne spreminjajte vsebine home_*.html datotek direktno. Namesto tega, uporabite možnost "Uredi domačo stran" v Dokeos administracijskem področju.

2.6. Odprite okno spletnega brskalnika in pojdite na http://www.vasstreznik.org/vasastran/dokeos/index.php Če ste Dokeos namestili lokalno, odprite: http://localhost/dokeos/index.php

2.7. Kliknite na gumb install in sledite navodilom. Windows: pri uporabi sestavljenega paketa, kot je npr. easyphp, bosta uporabniško ime in geslo za MySQL verjetno prazna /ju ni/.

2.8. Nastavitve in varnost po postopku namestitve

- Zaščita datoteke z nastavitvami: zagotovite, da je nihče ne bo mogel spremeniti. Datoteko z nastavitvami najdete na (dokeos mapa)/claroline/inc/conf/claro_main.conf.php. Naredite jo zgolj bralno (windows/xwindows: desni miškin klik na datoteki, lastnosti. linux/bsd/macosx: uporabite ukaz chmod 444 ). Datoteka z nastavitvami je generirana s strani Apache, torej boste morali imeti pravice root uporabnika za spremembo pravic.
- Zaščita namestitvene mape: v primeru, da je (dokeos mapa)/claroline/install mapa še vedno dostopna, lahko nepooblaščena oseba izvrši novo namestitev preko trenutne namestitve (s ponovno namestitvijo so vaši trenutni podatki lahko izgubljeni). Premaknite mapo nekam izven obsega vaših spletnih map, da preko spletnega strežnika ne bo dosegljiva, in spremenite lastnosti tako, da datotek ne bo mogel nihče brati in izvrševati.
- Za boljšo varnost: nastavitev pravic dostopa na način, da so vse datoteke in mape dostopne vsem pri pisalnih in izvršilnih dostopih, je lahko v pomoč pri namestivi portala, in je tudi lahko v pomoč pri reševanju določenih problemov, predvsem za uporabnike z malo ali nič administratorske prakse. Kakorkoli že, za varnost je veliko bolje, da je lastnik vseh datotek in map Dokeos namestitve apache proces (običajno poimenovan apache, www ali httpd). Na ta način, morajo datoteke namestitve biti le bralne in pisalne za lastnika (Apache proces), ne pa tudi za vse ostale.
- Konfiguracija in prilagajanje Dokeos namestitve: v administracijskem področju Dokeos lahko uporabite Dokeos nastavitve za prilagoditev vaše namestitve.
- Nastavitev Dokeos e-poštnih storitev: pretežni del Dokeos-a uporablja poštne nastavitve iz php.ini datoteke. Le orodje obvestil uporablja phpMailer (drug odprtokodni projekt) in nastavitve za to orodje se nahajajo v datoteki (dokeos mapa)/claroline/inc/conf/mail.conf.php.

## 3. Nadgradnja predhodne različice Dokeos

Pred nagraditvijo toplo priporočamo izdelavo popolne rezervne kopije trenutnih Dokeos map, njihove vsebine in podatkovnih baz. Če niste prepričani, kako boste to izvedli, se obrnite po nasvet na gostitelja oz. ponudnika storitve.
V primeru, da izvajate nadgraditev različice 1.6.x, lahko preprosto stare datoteke namestitve prepišete z datotekami iz različice 1.6.3.
Če izvajate nadgraditev nižje različice (1.5.x), morate uporabiti vgrajen mehanizem za nadgrajevanje, kot je opisano v spodnjem postopku.

3.1. Prenesite si Dokeos 1.6.3 namestitveni paket (.zip za Windows uporabnike ali .tar.gz za vse ostale) s spletnega naslova Dokeos download page.

3.2. Dekomprimirajte (unzip / untar) prenesen namestitveni paket. Večina novejših operacijskih sistemov je to zmožno izvesti z vgrajenimi grafičnimi aplikacijami, če pa to ne deluje, lahko to izvedete preko ukaznega poziva: v mapi, kamor ste si prenesli namestitveni paket odtipkajte tar -zxvf dokeos-1.6.3.tar.gz

3.3. Premaknite Dokeos mapo pod koren mape spletnega strežnika, proč od obstoječe namestitve

OPOZORILO:
Ne brišite obstoječe namestitve Dokeos pred namestitvijo nove. Staro namestitev lahko odstranite šele po uspešnem zaključku nadgraditve.

NASVET:
Če želite namestiti Dokeos 1.6.3 v isto mapo, kot je bil nameščen pred nadgraditvijo:

- prestavite mapo s staro namestitvijo na novo mesto (npr. move dokeos/ dokeos_old/)
- dekomprimirajte Dokeos 1.6.3 na mesto stare namestitve (npr. dekomprimirajte Dokeos 1.6.3 v dokeos/)
- pojdite na naslednji korak nadgraditve

3.4. Naslednje datoteke morajo biti bralne in pisalne za vsakogar:

- dokeos/claroline/inc/conf/claro_main.conf.php (če obstaja)
- dokeos/home/*.html

Na operacijskih sistemih Linux, Mac OS X in BSD lahko uporabite ukaz CHMOD 666. Pri Windows OS, preverite lastnosti map (klik z desnim miškinim gumbom na mapi).

OPOMBA:
Ne spreminjajte vsebine home_*.html datotek direktno. Namesto tega uporabite možnost "Uredi domačo stran" v Dokeos administracijski sekciji.

3.5. Naslednje mape morajo biti bralne, pisalne in izvršne za vsakogar:

- dokeos/claroline/inc/conf/
- dokeos/claroline/garbage/
- dokeos/claroline/upload/
- dokeos/archive/
- dokeos/courses/
- dokeos/home/

Na operacijskih sistemih Linux, Mac OS X in BSD lahko uporabite ukaz CHMOD 777 za doseljevanje pravic. Pri Windows OS, preverite lastnosti map (klik z desnim miškinim gumbom na mapi).

3.6. Odprite okno spletnega brskalnika in pojdite na http://www.yourserver.org/yoursite/dokeos/index.php .
Windows lokalno, z npr. easyphp ali drugim primerljivim, pojdite na: http://localhost/dokeos/index.php

3.7. Kliknite gumb install , nato kliknite na "Update from Dokeos 1.5 | 1.5.4 | 1.5.5" in sledite navodilom.

3.8. Ta del je opcijski!
Od različice 1.5.5, so naslednje tabele v dokeos_main podatkovni bazi lahko odstranjene pri nadgradnji iz 1.5.5 različice ali nižje, če jih seveda niste uporabili med prilagajanjem svojega Dokeos sistema:

- `todo`
- `pma_bookmark`
- `pma_column_comments`
- `pma_pdf_pages`
- `pma_relation`
- `pma_table_coords`
- `pma_table_info`

Tabele lahko odstranite tako, da se povežete s podatkovno bazo kot Dokeos uporabnik in izvedete naslednje povpraševanja: DROP TABLE dokeos_main.my_table; kjer je dokeos_main ime glavne dokeos podatkovne baze my_table pa vsaka posamezna izmed zgoraj naštetih tabel (ponovite povpraševanje za vsako izmed tabel posebej)
Čiščenje neuporabljanih polj tudi lahko vpliva na hitrost izvrševanja kode: Polje main_db.cours.cours_id je bilo odstranjeno, kot tudi vse reference na to polje v Dokeos kodi. Namesto njega je v novejših različicah uporabljena koda tečaja. Upoštevajte, če imate izvedene kakršnekoli prilagoditve v vaši kodi.
V določenih primerih, kot je npr. odstranjevanje tabel, so lahko odstranjena tudi naslednja polja, če jih ne uporabljate pri vaši prilagoditvi, s preprostim povpraševanjem, kot je npr.: ALTER TABLE database.table drop column abc; kjer so database ime podatkovne baze (dokeos_main? ali koda tečaja) table ime tabele (cours?) abc ime podatkovnega polja tabele, ki ga želite odstraniti Odstranite lahko naslednja polja:

- `_dokeos_main_`.`cours`.`versionDb`
- `_dokeos_main_`.`cours`.`versionClaro`
- `_dokeos_main_`.`cours`.`cahier_charges`
- `_dokeos_main_`.`faculte`.`bc`
  # tabela `faculte` je bila preimenovana v `course_category` od verzije 1.6
- `_cours_`.`announcement`.`code_cours`
- `_cours_`.`course_description`.`upDate`

## 4. Odpravljanje težav

V prihodnosti imamo namen zagotoviti navodila za "ročno" namestitev Dokeos, vključno z "ročnim" kreiranjem podatkovne baze in vseh potrebnih tabel. Če naletite na kakršenkoli problem, pojdite na Dokeos spletno stran in zastavite vprašanje na našem forumu podpore. Preberi prosim najprej predhodna sporočila! Lahko, da je bil vaš problem že rešen, vprašanje predhodno že zastavljeno. Vzdržujemo tudi seznam pogosto zastavljanih vprašanj.

## 5. Administracija

Za dostop do Dokeos administracijskega področja, odprite brskalnik, pojdite na Dokeos naslov vašega portala in se prijavite kot adminstratorski uporabnik. Videli boste "Platform admin section / področje Upravitelj tečaja" povezavo v glavi spletne strani portala.

## 6. LDAP

Ta del je opcijski, sledeče besedilo je namenjeno le organizacijam z LDAP strežnikom .
LDAP modul je integriran v Dokeos distribucijo, potrebno ga je le ustrezno nastaviti, da ga usposobite za delo.

Prevajanje
Linux strežniki: Možno je, da boste morali ponovno prevesti php z ldap podporo. Novejše distribucije tudi dovoljujejo selektiven prenos rpm-jev za dodatne podporne pakete.
Enako velja tudi za BSD uporabnike.

Activiranje LDAP v Dokeos
V (dokeos mapa)/claroline/inc/conf/claro_main.conf.php, okoli vrstice 90, se nahaja naslednje besedilo
//for new login module
//uncomment these to activate ldap
//$extAuthSource['ldap']['login'] = "./claroline/auth/ldap/login.php";
//$extAuthSource['ldap']['newUser'] = "./claroline/auth/ldap/newUser.php";
odstranite // izpred zadnjih dveh vrstic za aktiviranje LDAP.

Nastavitve
Pozanimajte se pri upravitelju LDAP strežnika za naslednje nastavitve:

- ldap ime strežnika
- ldap strežniška vrata (običajno 389)
- ldap dc

Te vrednosti morate vnesti v datoteko (dokeos mapa)/claroline/auth/ldap/ldap_var.inc.php
//parameters for LDAP module
$usesLDAP = TRUE;
$usesCurriculum = FALSE;
$ldaphost = "myldapserver.com"; // vaš ldap strežnik
$ldapport = 389; // vaša ldap številka strežniških vrat
$ldapDc = "dc=xx, dc=yy, dc=zz"; //domena

Učitelj/tečajnik status
Če želite, lahko učitelju/tečajniku dodelite znotraj dokeos status iz vpisov ldap strežnika. To ni standarna možnost, torej boste morali rahlo spremeniti programsko kodo: claroline/auth/ldap/ldap_var.inc.php okoli vrstice 189, function putUserInfoInClaroline ($login, $infoArray)

if (tvoj kriterij)
{
$statut = STUDENT;
}
else
{
$statut = COURSEMANAGER;
}

Če se vam to zdi pretežko, je najenostavnejša rešitev ta, da enostavno določite $statut = STUDENT; in dodeljute upravljalcu tečaja pravice preko administracijske sekcije portala.

Zaščiteni LDAP strežniki
Nekateri LDAP strežniki ne podpirajo anonimne uporabe direktorijskih storitev V tem primeru, potrebujete dodatno programsko kodo, ki bo povezovala LDAP z uporabniškim imenom in geslom - koda je zagotovljena, le vprašajte na forumu ali jo zahtevajte preko e-pošte.

Kontaktni naslov: Dokeos, 44 rue des palais, B-1030 Brussels, Belgium
E-pošta: info@dokeos.com