4 WISE TIMETABLE 10 8 7 Wise Timetable Web instalacija 6 8 5 korisnički priručnik 1 2 12 Wise Timetable Web instalacija www.wisetimetable.com Wise Technologies d.o.o. Jarška cesta 10a SI-1000 Ljubljana, Slovenija www.wise-t.com support@wise-t.com Datum izdavanja: 21.7.2010 10
Sadržaj: Uvod...3 1 Preduvjeti za instalaciju...4 2 Nadogradnja...4 3 Postavke baze podataka...4 3.1 Microsoft SQL Server... 4 3.2 MySQL... 4 4 Veza sa podacima...5 4.1 ODBC Data Source... 5 4.1.1 MS SQL... 5 4.1.2 MySQL... 7 4.2 Izvoz podataka u bazu... 8 5 Instalacija paketa u bazu poslužitelja...9 5.1 Instalacija na Microsoft Internet Information Services (IIS)... 9 5.2 Instalacija na UNIX/Linux poslužitelje... 13 6 Konfiguracija... 14 6.1 Promjena šifre i informacije o proizvodu (Product information)... 16 6.2 Mogućnosti (Features)... 16 6.3 Administracija (Administration)... 17 6.4 Postavke (Settings)... 17 6.5 Postavke poruka (Custom page messages)... 18 6.6 Napomene... 18 7 Prva pomoć... 18 7.1 Na stranici groups.asp/php ne možete odjednom odabrati više grupa za prikaz...18 8 Prijava neispravnosti... 19 2
Uvod U paketu ste dobili sve Wise Timetable Web skripte, koje su potrebne za pregled rasporeda preko interneta. Cilj priručnika je instalacija Wise Timetable Web aplikacije na bazu poslužitelja i uspostavljanje veze s bazom podataka, tako da podaci budu prikazani na internet stranici. Priručnik ne obuhvaća integracije s drugim internetskim portalima ili stranicama. Ovaj dokument se nadograđuje zajedno sa aplikacijom i moguće su promjene po nastanku. Zadnja elektronska verzija je dostupna na našoj FTP stranici kao i na slijedećoj adresi: http://www.wisetimetable.com/images/import-data/wise-timetable-web-instalacija-bih.pdf. 3
1 Preduvjeti za instalaciju Prije same instalacije, provjerite slijedeće: imate li zadnju verziju priručnika (provjerite na FTP stranici), imate li zadnju verziju web aplikacije (provjerite na FTP stranici), imate li pristup do web servera (IIS, Apache...), gdje ćete staviti web aplikaciju, imate li pristup bazi podataka, gdje želite spremiti podatke. Aplikacija podržava MySQL (5.0.2 ili noviju) i MS SQL 2000 ili noviju, PHP verzija treba vanjske knjižnice ADOdb Database Abstraction Library, koje su lako dostupne na stranici http://adodb.sourceforge.net/. 2 Nadogradnja Aplikacija Wise Timetable Web neprestano se razvija i nadopunjuje. Svoju inačicu ćete najlakše nadograditi po slijedećem postupku: 1. Napravite sigurnosnu kopiju svoje postojeće verzije. 2. Na sigurno i zgodno mjesto spremite datoteku lib/setup.ini ili si je ispišite. 3. Izbrišite kompletan sadržaj direktorija na web poslužitelju, kada aplikacija bude postavljena. 4. Slijedite upute za instalaciju i pri konfiguriranju,koristite se datotekom setup.ini, koju ste već spremili ili ispisali. Napomena: ako ste mijenjali dizajn vaših internet stranica, onda datoteke sa dizajnom treba ponovno ažurirati. 3 Postavke baze podataka 3.1 Microsoft SQL Server Pored osnovne aplikacije Wise Timetable dobili ste i skripte za kreiranje tabela u bazi podataka. Nalaze se u poddirektoriju aplikacije misc (preuzeto C:\Program Files\Wise Timetable\misc). Napravite novu bazu i tabele za izvedbu skripte mssql_create_script.sql. Za djelovanje web aplikacije trebate i korisnika sa SELECT pravima (db_datareader). 3.2 MySQL Pored osnovne aplikacije Wise Timetable dobili ste i skripte za kreiranje tabela u bazi podataka. Nalaze se u poddirektoriju aplikacije misc (preuzeto C:\Program Files\Wise Timetable\misc). 4
Napravite novu bazu sa collation-om UTF-8 i tabele za izvedbu skripte mysql_create_script. sql. Za djelovanje web aplikacije trebate i korisnika sa SELECT pravima. 4 Veza sa podacima Web aplikaciju kao osnovnu inačicu, potrebno je povezati sa bazom podataka. 4.1 ODBC Data Source ASP i osnovna inačica trebaju unos u ODBC Data Source Administrator na računalu, gdje je instaliran. Postupak je opisan za osnovnu inačicu. Ako ćete na vašem web poslužitelju koristiti ASP inačicu, biti će potrebno na isti način postaviti ODBC Data Source i povezati ga. Pri tome obratite pažnju, da osnovna inačica iziskuje prava također za pisanje i brisanje iz baze, dok su internetske stranice jedino za čitanje. 4.1.1 MS SQL 1. Otvorite ODBC Data Source Administrator (Control panel/administrative tools). 2. Kliknite na traku System DSN a zatim na gumb Add... 3. U prozoru Create New Data Source izaberite SQL Server i kliknite Finish. 4. Otvorit će se prozor kao na slici ispod. Ispunite polja i izaberite vaš server te kliknite Next. slika 1 5. Izaberite SQL Server authentication i unesite Login ID i Password (osnovna aplikacija iziskuje smjernice za čitanje, pisanje i brisanje, internetska za čitanje), kada ste postavili pristup do baze, u polja (kao što vidite na slijedećoj slici 2), tada kliknite Next. 5
6. slika 2 U slijedećem prozoru izaberite svoju bazu sa padajućeg popisa. slika 3 7. U posljednjem prozoru ne treba ništa mijenjati. Na kraju kliknite Finish. slika 4 6
8. Otvori se prozor sa sažetkom svih postavki. Kliknite na gumb Test Data Source... i prikazat će se poruka TESTS COMPLETED SUCCESSFULLY!, kao na slijedećoj slici 5. slika 5 9. Potvrdite oba prozora. Sada imate novi unos u System DSN. 4.1.2 MySQL 1. Ako kao bazu podataka na poslužitelju koristite MySQL, morate imati podešen MySQL ODBC 5.1 Driver. Ako nije podešen, preuzmite ga sa slijedeće stranice te podesite: http://dev.mysql.com/downloads/connector/odbc/5.1.html (savjetujemo MSI installer inačicu). 2. Otvorite ODBC Data Source Administrator (Control panel/administrative tools). 3. Kliknite na traku System DSN a zatim na gumb Add... 4. U prozoru Create New Data Source izaberite MySQL ODBC 5.1 Driver i kliknite Finish. 5. Vaše podatke unesite u polja, kao na slici 6. 7
slika 6 6. Kliknite na gumb Test i pojavit će se poruka Connection successful. slika 7 7. Sada imate novi unos u prozoru System DSN. 4.2 Izvoz podataka u bazu Za izvoz podataka iz osnovne aplikacije potrebno je podesiti put do baze. U direktoriju aplikacije (preuzeto C:\Program Files\Wise Timetable\), otvorite datoteku dbsettings.ini. Vrijednost parametra export_db_conn_str postavite na vaš DSN, npr.: export_db_conn_str = DSN=WiseTimetable. 8
Otvorite osnovnu aplikaciju i iz menija Podaci izaberite Spremi podatke u bazu podataka. Na kraju ovaj izbor potvrdite u odgovarajućem prozoru koji se na kraju otvori. Podaci su sada u bazi. 5 Instalacija paketa u bazu poslužitelja U osnovnoj mapi paketa nalaze se skripte, namijenjene korisnicima, u podmapama su pomoćne skripte. Pokreće se iz osnovne mape (glavna stranica) na poslužitelju ali iz podmape (podstranica), iako vam iz sigurnosnih i praktičnih razloga savjetujemo (nadogradnja, mogući konflikti zbog naziva...), da namjestite web aplikaciju kao podmapu na poslužitelju. Slijedeći primjer pokriva tu mogućnost. 5.1 Instalacija na Microsoft Internet Information Services (IIS) 1. Cjelokupan sadržaj paketa si presnimite na poslužitelja u mapu, u koju god želite, da se Wise Timetable Web pokrene. 2. Na poslužitelju otvorite IIS i otvorite izborni meni na lokalnom računalu. U Web Sites mapi kliknite desnim gumbom na mjesto, gdje želite instalirati aplikaciju. slika 8 3. Iz menija izaberite New / Virtual Directory... 9
slika 9 4. Slijedite čarobnjaka (wizard-u): a. Alias: tu unesite ime, pod kojim će rasporedi biti dostupni. Ako unesete»raspored«, stranice će biti dostupne iz URL-a npr. www.organizacija.com/ Timetable/courses.asp. slika 10 b. Directory: tu izaberite direktorij, u kojeg ste prebacili sve datoteke, koje pripadaju aplikaciji. slika 11 10
c. Access Permissions: izaberite Read, Run scripts, Write. slika 12 5. Podmape web aplikacije lib i design oz. datoteke, koje se u njima nalaze trebaju još dodatne smjernice. a. U Windows Exploreru otvorite direktorij aplikacije i desnim gumbom miša kliknite na direktorij lib i izaberite Properties. b. U otvorenom prozoru kliknite na Security i ispod u Group or user names kliknite na gumb Add... slika 13 11
c. Otvorio se prozor Select Users or Groups; tu izaberite gumb Advanced... slika 14 d. Zatim Find Now. Ispod se otvori popis. Nađite IUSR_COMPUTERNAME, gdje je COMPUTERNAME ime računala. Potvrdite klikom na OK i isto tako u slijedećem prozoru. slika 15 e. Sada ste opet na prozoru lib Properties. U malom prozoru Group or user names izaberite upravo dodani unos (Internet Guest Account...). U donjem dijelu označite: Modify, Read & Execute, List Folder Contents, Read, Write i potrdite klikom na Apply te zatvorite prozor sa OK (slika 16). 12
slika 16 f. Ponovite postupak od a) do e) još za direktorij design. 6. Sada je aplikacija dostupna iz web pretraživača. Idite na poglavlje Konfiguracija. 5.2 Instalacija na UNIX/Linux poslužitelje O vrsti vaše programske opreme ovisi, gdje i kako ćete instalirati programski paket. Važno je, da postavite prava za pristup do pojedinih datoteka. Datoteke moraju imati najmanje sljedeća prava: /-r--r--r-- *.php /dr-xr-xr-x design /design/-rw-rw-rw *.* /design/dr-xr-xr-x img /design/img/-r--r--r-- *.* /lib/-r--r--r-- *.php /lib/-r--r--r-- *.js /lib/-rwxrwxrwx langpack.ini /lib/-rwxrw-rw- setup.ini 13
6 Konfiguracija Slijedeći korak prije korištenja rasporeda je konfiguracija web aplikacije. Otvorite web pretraživač i u njemu priloženu skriptu configure.php (configure.php za PHP inačicu), koja se nalazi u osnovnoj mapi same aplikacije. slika 17 Program će najprije tražiti unos šifre. Predefinirana šifra je Popokatepetl (pazite na velika i mala slova), zatim kliknite na Login. Pred vama se sada nalazi konfiguracijska stranica, gdje ćete unijeti sve podatke, koje aplikacija treba da bi radila. 14
slika 18 15
6.1 Promjena šifre i informacije o proizvodu (Product information) 1. Change password: preporučujemo, da odmah promijenite svoju šifru, jer predefinirana nije tajna. Šifru promijenite tako, da u polje unesete novu šifru i zatim na dnu stranice pritisnete gumb Submit. Iako druge postavke još niste izmijenili, nova šifra je spremljena i slijedeća prijava će biti sa vašom šifrom. Kako je sada aktivna (prijavljeni ste u sustavu), ispunite ostale podatke bez ponovnog unašanja šifre. 2. Revision number: to polje je informatičke prirode i služi podršci u slučaju nekog kvara. 3. Modifications: to polje je informatičke prirode i služi podršci u slučaju nekog kvara. 6.2 Mogućnosti (Features) 1. Groups: ako su studenti podijeljeni u više grupa s različitim rasporedima, označite polje Use (grupe će biti prikazane u rasporedu), u protivnom označite Don t use. 2. Reservations: izaberite Use, ako želite, da se pri ispisu rasporeda ispišu i rezervirani (blokirani) termini, u protivnom se prikazuju samo predmeti, raspoređeni u rasporedu. 3. Professor password: označite ako želite da se predavači pri upotrebi prof skripte prijave šifrom ili ne. 4. Groups password: označite, želite li dodijeliti šifru za pregled svake pojedinačne grupe. Ako je šifra aktivirana, kod upotrebe groups skripte studenti će se morati prijaviti šifrom. Pazite, na stranici groups.asp/php nećete moći odabrati više grupa odjednom. 5. Use Sundays: izaberite, želite li, da u rasporedu bude prikazana i nedjelja. 6. Groups in cells: izaberite, želite li, da se u poljima rasporeda ispišu sve grupe. Inače će biti ispisane u pop-up prozoru. 7. Groups selector: izaberite, želite li ponuditi mogućnost odabira grupa u skripti groups. Inače, grupa se ne mogu izabrati, međutim, prikazat će se raspored za sve grupe. 8. Days with day names: izaberite, ako želite, da se u naslovnim stupcima rasporeda pored imena dana (pon, uto,...) ispiše i datum. 9. Timetable valid until: unesite datum, do kojeg želite prikaz rasporeda. Vrijednost»0«ne unosi se u ovaj format. Format: YYYY-MM-DD. 10. Display last change time: ovo izaberite ako želite prikaz datuma i vremena zadnje promjene. 11. Details about the selection when printing: ovo izaberite želite li da se pri ispisu prikažu podaci određenih parametara (nastavnik, predmet, godina, smjer, grupe,...). 12. Week number: ovo izaberite, želite li prikaz tjedna u školskoj godini. 13. Datetime format: upisujete kada zelite prikazeti datum zadnje izmjene. Primjeri upotrebe:»dd.mm.«,»mm-dd«,»yyyy-mm-dd«,»dd.mm.yyyy hh:mm:ss«,»hh:mm DD/MM/ YYYY«. Datum oblikujete po vašoj želji, stim da se pridržavate sljedečeg: a. DD oznaka za dan, b. MM oznaka za mjesec, c. YYYY oznaka za godinu, 16
d. e. f. hh oznaka za sate, mm oznaka za minute, ss oznaka za sekunde. 6.3 Administracija (Administration) 1. Save to log: označite da bi se predavačeve prijave bilježile u datoteku na poslužitelju, koje će administrator moći pregledati uz pomoć admin skripte. 2. Log Filename: put do datoteke i ime datoteke, u koju se bilježe prijave iz točke 1., npr. C:\Log\WiseTimetableLog.txt (direktorij mora postojati). 3. Administrator: unesite osobu iz tabele Tutor u bazi Wise Timetable, koja će imati smjernice pristupa do pregleda prijava. Skripta admin će, ako/kada bude u upotrebi, provjeriti da li je unesena šifra jednaka šifri, koja u bazi odgovara tome zapisu. 6.4 Postavke (Settings) 1. Web character encoding: tabela kodova za prikaz stranica u pretraživaču. 2. Character encoding: tabela kodova, koja će se koristiti pri Ajax komunikaciji (nije nužno ista kao ona za prikaz stranica). 3. Database Type: izaberite vrstu baze podataka, koju koristite. 4. Connection string: unesete niz znakova, s kojima će se program povezati sa bazom. a. ASP inačica treba DSN vezu, koju ste podesili u poglavlju Veza sa podacima. Primjer unosa:»dsn=wisetimetable«(bez navodnika). Ako tada niste unijeli podatke o korisniku baze, unesite ih sada i to u slijedećem obliku:»dsn=<ime_dsnja>;uid=<korisničko_ime>;pwd=<šifra>«. PHP inačica treba Connection string u drugačijem obliku i to: za MySQL:»mysql://DBusername:DBpassword@mysql-server:port_number/ Database«, za MSSQL:»Driver={SQL Server}; Server=<server>; Database=<Database>; UID=<korisničko_ime>; PWD=<šifra>«. 5. ADOdb Driver Location: je bitan samo za korisnike PHP verzije paketa. Unesite put do php knjižnice/upravljačkog programa (driverja) za pristup do baze podataka. Put je obično»/ apache/adodb5/adodb.inc.php«, mada ovisi o postavkama vašeg poslužitelja. 6. Language: izaberite, jezik na kojem će biti prikazana internetska stranica. 7. Application path: unesite put do datoteka, koje su dio aplikacije. Put završava kosom crtom, u Microsoft-ovoj sredini sa»\«, u UNIX/Linux sa»/«. Primjer:»C:\Web\Timetable\«i»/var/www/timetable/«. U poddirektoriju design se nalaze datoteke, koje definiraju oblik rasporeda, koji su prikazani na internetu. Mogu se oblikovati u skladu sa svojim grafičkim izgledom. Upute za izmjenu dizajna su dostupne na našoj FTP stranici i na adresi: http://www. wisetimetable.com/images/import-data/wise-timetable-web-design-bih.pdf. 17
6.5 Postavke poruka (Custom page messages) Imamo postavke za dodatne poruke, koje se prikažu kao naslov na vrhu odgovarajuće stranice. Služe kao dodatna upozorenja. Pogledajte slijedeći primjer: slika 19 6.6 Napomene Kada završite sa konfiguriranjem Wise Timetable Web aplikacije, ne zaboravite pritisnuti gumb Submit. Zatim isprobajte neku od priloženih skripti. Ako sve radi kako treba, stranice će biti prikazane i koristit će podatke iz baze. Konfiguracijsku skriptu (configure.asp oz. configure.php) sada možete izbrisati. Podaci su spremljeni i program radi neovisno o njoj. Ako je i ne obrišete, ona je svejedno zaštičena šifrom, koju ste već izmijenili. 7 Prva pomoć Poglavlje je namijenjeno rješavanju najčešćih problema, koji se pojavljuju kod instalacije. Sadržaj se često ažurira. 7.1 Na stranici groups.asp/php ne možete odjednom odabrati više grupa za prikaz U konfiguraciji ste namjestili, da koristite grupe (Groups=Use) koje trebaju šifru za pristup (Groups password=use). Svaka grupa ima svoju šifru, zato ne možete izabrati više grupa odjednom. Ako uredite parametar Groups password na Don t use, onda ćete moći odabrati više grupa odjednom. 18
8 Prijava neispravnosti Eventualne neispravnosti želimo što prije otkloniti tako da ne gubite vaše dragocijeno vrijeme. Odmah nam se javite porukom sa opisom problema, i molimo vas, provjerite, da li se možda vaš problem nalazi u rubrici Prva pomoć. Ako ga nema tamo, onda nam pošaljite e-mail slijedečeg sadržaja: Primatelj: support@wise-t.com Predmet: Wise Timetable Web: prijava neispravnosti U sadržaju poruke ukratko opišite problem te dodajte slijedeće podatke: Baza podataka koju koristite (MySQL, MS SQL), i koja verzija. Stranice su postavljene u ASP ili PHP. Ako su stranice dostupne javnosti, navedite URL, tako da uključite sliku prozora sa problemom. Datoteku lib/setup.ini (ona sadrži vezu sa bazom, možda želite taj podatak izbrisati). 19