jWebPDM Readme

1. Instalacija sistema

Program jWebPDM je odjemalec/strežnik program. Na strani strežnika mora teči program JWebPDMServer, ki komunicira s podatkovno bazo, ki je prav tako na strani strežnika. Podprte podatkovne baze so: MySQL, PostgreSQL, MS SQL Server, MS Access.

1.1. Instalacija strežnika

Na poljuben direktorij administratorja sistema kopiramo .class datoteke programa strežnika. V istem direktoriju mora biti datoteka "datasource.txt", ki je tekstovna datoteka s podatki za komunikacijo s podatkovno bazo in vsebuje naslednje podatke:

- datasource.database=ime vrste podatkovne baze (mysql, pgsql, mssql, msaccess),
- datasource.name=ime baze v podatkovni bazi (npr. za test je to jwebpdmtest),
- datasource.username=ime uporabnika baze, ki ima dostop do nje in možnosti spreminjanja le-te,
- datasource.password=geslo uporabnika baze, za povezavo z bazo,
- datasource.homedir=pot do direktorija, kjer so poddirektoriji za shranjevanje dokumentov (datotek, ki so vnešene v sistem z vnos-v oz. check-in in so na voljo za branje-iz in check-out).

Datoteka "datasource.txt" naj bo skrita in zaščitena pred ogledi uporabnikov, ki nimajo dostopa oz. niso administratorji sistema, saj vsebuje pomembne podatke za dostop in spreminjanje baze podatkov.

Za zaganjanje programa strežnika je potrebno na sistem instalirati ustrezno inačico Java programskega okolja ali Java sistema za zagon Java programov (J2SE - jdk 1.4.1 ali višje oz. jre 1.4.1 ali višje). Lahko se uporabi jre od spletnega brskalnika (npr. Netscape ali Firefox).

Za povezavo z bazo mora biti instaliran program za komunikacijo z bazo (MS SQL Server, MSAccess - jdbc:odbc most, MySQL in PostgreSQL - jdbc gonilnik za ustrezno podatkovno bazo).

Program strežnik se zažene z ukazom za (jdk 1.4.1):

java -server pdm.server.JWebPDMServer

1.2. Postavitev odjemalca

Program odjemalca je na spletnem strežniku na določeni povezavi. Nameščena je .html datoteka "jWebPDM.html", "jWebPDM.jar" in direktorij z ikonami "images/", ki vsebuje potrebne .gif datoteke za ikone v porgramu.

Dodatne povezave so: "jWebPDMslo.html", "jWebPDMeng.html" in samo za začetno nastavitev baze "jWebPDMsetup.html".

Program (Java Applet) se zažene ko pridemo z brskalnikom na določeno stran jWebPDM.html. Seveda mora imeti brskalnik omogočeno opcijo zaganjanja Java programov 1.4.1 (npr. Netscape 7.1 ali Firefox 1.0).

1.3. Osnovna vsebina baze

Za začetek dela mora biti v baze konfiguriranih nekaj tabel:

Tabela "users":

Kreirana mora biti tabela users z vsaj enim uporabnikom, ki ima vlogo administratorja sistema (kreira in dodeljuje vloge ostalim uporabnikom) in administratorja skladišč (določa direktorije, kjer se bodo shranjevali dokumenti).

Tabela "elements":

To je tabela s podatki o gradnikih. Ta mora biti kreirana.

Ta dva pogoja zadostimo, če v podatkovni bazi v novo kreirani bazi izvršimo SQL stavke iz priložene datoteke "Table_start.sql".

Za polno delovanje sistema morajo biti kreirane še dodatne tabele, kar lahko storimo znotraj jWebPDM odjemelca. Ker je tabela users že kreirana se prijavimo kot administrator:

username: pdmadmin
password: admin

in iz menuja SQL izberemo Izvrši datoteko ter izberemo priloženo datoteko "Table_other.sql".

1.4. Konfiguracija spletnega brskalnika

Omogočanje funkcije branja in pisanja po lokalnem disku programu jWebPDM se določa v datoteki ".java.policy", ki jo ima vsak uporabnik na lokalnem sistemu kjer dela v direktoriju npr. "C:\Documents and Settings\username\.java.policy". Datoteka je že na sistemu, če uporabnik dela z java programi ali jih zaganja preko spleta in jo je potrebno ustrezno spremeniti, drugače se jo namesti. Za spreminjanje se uporabi lahko orodje "policytool" iz jdk ali pa se uredi v urejevalniku teksta.

Datoteko se spremeni, tako da vsebuje ime datoteke kjer je shranjen certifikat, ki zagotavlja avtentičnost prenesene in zaganjane kode java programa:

keystore "file:/C:/keystore.soft";

in dovoljene operacije kode podpisane s tem certifikatom:

grant signedBy "softcert" {
  permission java.security.AllPermission;
};