VodiÄ? po namestitvi Dokeos 1.8

Zahvaljujemo se vam, ker ste si prenesli Dokeos! To besedilo vas bo vodilo preko osnovnih korakov namestitve Dokeos 2.0. 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
• php-xml
• (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 2.0 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-2.0.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/main/inc/conf/
• dokeos/main/garbage/
• dokeos/main/upload/
• dokeos/main/img/default_courses_img/
• 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/main/inc/conf/configuration.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)/main/inc/conf/configuration.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)/main/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)/main/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.

3.1. Prenesite si Dokeos 2.0 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-2.0.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 2.0 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 2.0 na mesto stare namestitve (npr. dekomprimirajte Dokeos 2.0 v dokeos/)
• pojdite na naslednji korak nadgraditve

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

• dokeos/main/inc/conf/configuration.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/main/inc/conf/
• dokeos/main/garbage/
• dokeos/main/upload/
• dokeos/main/img/default_courses_img/
• 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.

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)/main/inc/conf/configuration.php, okoli vrstice 90, se nahaja naslednje besedilo
//for new login module
//uncomment these to activate ldap
//$extAuthSource['ldap']['login'] = "./main/auth/ldap/login.php";
//$extAuthSource['ldap']['newUser'] = "./main/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)/main/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: main/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

---