UPUTE ZA INSTALACIJU I KORISTENJE PROGRAMSKOG PAKETA DIGGER Programski paket Digger sadrzi alate za kreiranje i odrzavanje podataka o korisnicima na racunalu tzv. whois++ elektronicki imenik. Postupak kreiranja imenika moze se podijeliti u 4 dijela: 1. Instalacija programskog paketa (opisano u uputama za instalaciju) 2. Upisivanje podataka o korisnicima u lokalnu whois++ bazu podataka 3. Indeksiranje servera 4. Upotreba pomocnih skripti ( Dodavanje novih korisnika u bazu, promjena podataka, brisanje podataka o korisnicima itd.) Nakon uspjesno zavrsene instalacije paketa, potrebno je kreirati imenik. Prva stvar koju je nakon instalacije potrebno napraviti je kreiranje lokalne baza podataka o korisnicima. Uz pomoc programa "whoiscreate" upisite podatke o korisnicima koji su vec prisutni na racunalu. Takodjer je potrebno da kod svakog novog otvaranja korisnickih racuna (adduser), upisuju potrebni podaci i u imenik uz pomoc pomocnih programa sto je objasnjeno u uputama. 1. INSTALACIJA (OBAVEZNO PROCITATI) 1.1 Prije instalacije programa na racunalu kreirajte korisnicko ime whois (login:whois). 1.2. Iskopirajte datoteke whois++-Decunix.inst i whois++-Decunix.tar.gz u neki privremeni direktorij. 1.3.Pokrenite program whois++-Decunix.inst., nakon cega ce se program instalirati u whois kucnom direktoriju(/home/whois/bin-Decunix). Prilikom instalacije program ce Vas upitati za identifikator servera (Serverhandle). Svako racunalo u imeniku je jedinstveno odredjeno identifikatorom kojeg odredjuje administrator servisa. Najjednostavnije je da identifikator definirate prema imenu domene i rednog broja servera. Primjerice, serverhandle racunala na Srcu je SRCEHR01, dok je na Pedagoskom fakultetu u Puli EFPUHR01. 1.4. Upisite postojece podatke o korisnicima na racunalu u whois++ bazu (iz passwd datoteke) Pokrenite program "whoiscreate" (u ./scripts direktoriju), nakon cega ce se kreirati datoteka u direktoriju ../dbdir/host.db sa vec postojecim podacima o korisnicima na racunalu. Program koristi podatke iz /etc/passwd datoteke. nakon toga provjerite ispravnost podataka u host.db datoteci. Datoteka host.db sadrzi slijedece podatke o korisnicima: # FULL USER LOCAL USER-pero USERNAME: pero EMAIL: ppero@public.srce.hr NAME: Petar Peric ORGANIZATION: SRCE WORK-PHONE: - WORK-ADRESS: - HOME-PHONE: - HOME-ADRESS: - IMAGE: http://regoc.srce.hr/images/book.gif RESPONSIBLE-HANDLE: pero # END Zapisi u datoteci su odvojeni praznim redom. VAZNO! -------- Provjerite podatke u datoteci host.db. Iz datoteke izbacite sve zapise koji ne predstavljaju korisnike (root, daemon, bin, sys, adm, lp, smtp, nobody itd.) Kad budete sigurni da su podaci ispravno upisani, naredbom "digger_insert" ce se podaci iz navedene datoteke ucitati u indeksiranu lokalnu bazu: /home/whois/bin-Decunix/digger_insert /home/whois/dbdir/host.db 1.5 Nakon upisivanje podataka u bazu pokrenute digger na portu 7777 (Vlasnik procesa je whois korisnik) cd /home/whois/bin-Decunix;./digger & Provjera uspjesne instalacije vrsi se naredbom help nakon telneta na port 7777: jagor>telnet 0 7777 Trying 0.0.0.0... Connected to 0. Escape character is '^]'. % 220-This is jagor running Bunyip-Whois++: DIGGER 1.0.5p1 % 220 Ready to go! help Search executing 2. INDEKSIRANJE ----------------- Slijedeci korak je upisivanje podataka na glavni server odredjene regije (Zagreb, Split, RIjeka, Osijek) tzv. indeksiranje. Time se omogucava pretrazivanje svih postojecih ustanova u regiji, odnosno hr domeni. Indeksiranje se pokrece naredbom /home/whois/bin-Decunix/digger_add_server. Nakon poziva naredbe upisite potrebne podatke o index serveru kao u dolje navedenom primjeru: >digger_add_server This program enters data in the password table: Enter the other computers handle: CARNETHR01 Enter the other computers hostname: ds.carnet.hr Enter the other computers port: 8001 Enter the password the other computer will use: Enter the password you will use: Do you want to poll this server: (y/n) n NAPOMENA: Navedeni podaci o indeks serveru su vazeci za ustanove i racunala locirana u Zagrebu. Za ustanove u ostalim gradovima upisite slijedece podatke o regionalnom serveru: Computers handle: Hostname: Port: ------------------------------------------------------------------------------ Split, Dubrovnik CARNETHR03 ferata.st.carnet.hr 8000 Rijeka, Pula CARNETHR02 ulika.pu.carnet.hr 8000 Zagreb CARNETHR01 ds.carnet.hr 8001 Nekon sto zavrsite s instalacijom, posaljite slijedece podatke elektronickom postom na adresu whois-admin@carnet.hr: -Ime i prezime administratora: -Naziv ustanove: -Adresa racunala: -Serverhandle: -Broj porta: 3. POMOCNI PROGRAMI ZA RAD S ELEKTRONICKIM IMENIKOM ----------------------------------------------------- 3.1. AZURIRANJE PODATAKA Svaki korisnik moze promijeniti vlastite podatke u imeniku pozivom programa "chwhois". jagor>chwhois ################################################################# ## White pages service ## ## Elektronicki imenik ## ## ## ## Detaljnije informacije o upotrebi ovog servisa mozete ## ## pogledati na URL adresi ## ## http://www.srce.hr/digger-white.html ## ################################################################# E-mail adresa[Pero.Peric@srce.hr]: Mogu se mijenjati slijedeci podaci korisnika: - E-mail adresa - Ime organizacije - Adresa i broj telefona na poslu - Adresa i broj telefona kod kuce - URL adresa slike osobe (npr. http://regoc.srce.hr/slika.gif) - Kucna stranica korisnika (http://jagor.srce.hr/~pperic). 3.2. UPISIVANJE NOVIH KORISNIKA Nakon svakog dodavanja korisnika na racunalu (useradd) potrebno je istovremeno upisati korisnike i u whois++ bazu. To omogucava program whoisadd. 3.3 BRISANJE PODATAKA O KORISNICIMA Podaci iz imenika brisu se naredbom whoisdel. 3.4. AUTOMATSKO DODAVANJE KORISNIKA Osim programa addwhois novi podaci o korisnicima na racunalu se mogu automatski generirati iz /etc/passwd datoteke i upisivati u whois++ bazu pozivom programa whoiscron. Postupak: Program se poziva iz crontab datoteke naredbom "crontab -e". Prije poziva crontab datoteke podesite env varijablu EDITOR: >setenv EDITOR joe Nakon toga editirajte datoteku crontab: >crontab -e Editiranjem datoteke upisite slijedecu liniju: 0 0 * * * /home/whois/scripts/whoiscron > /dev/null Podaci bi se time trebali upisivati jednom dnevno u whois++ imenik. 3.5 WWW klijent za pretrazivanje imenika WWW i pretrazivanje dostupno je na URL adresi: http://ds.carnet.hr/whois/ Na ftp posluzitelju nalazi se paket za instalaciju WWW klijenta diggerperl.tar.gz i php.tar.gz pomocu kojeg mozete pretrazivati imenik. Za ispravan rad perl klijenta potrebna je potpuna instalacija perl .ph datoteka. (.ph datoteke se kreiraju naredbom h2ph) --------------------------------------------------------------------------- Za sva pitanja i pomoc kod instalacije mozete se obratiti elektronickom postom na adresu: cecuk@srce.hr, ili whois-admin@carnet.hr tel. 01/6165-578