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 tri dijela: 1. Instalacija programskog paketa (opisano u uputama za instalaciju) 2. Upisivanje podataka o korisnicima u lokalnu whois++ bazu podataka 3. Indeksiranje posluzitelja 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++-Linux.inst i whois++-Linux.tar.gz u neki privremeni direktorij. 1.3.Pokrenite program whois++-Linux.inst., nakon cega ce se program instalirati u whois kucnom direktoriju(/home/whois/bin-Linux). 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 vec postojece podatke o korisnicima na racunalu u lokalnu i bazu podataka koja ce se pretrazivati na zahtjev korisnika. Naredbom whoiscreate (u scripts direktoriju) Linux direktorij) ce se kreirati tekstualna datoteka host.db sa podacima o korisnicima. Naredba digger_insert upisuje tekstualne podatke u lokalnu bazu podataka. Detaljnije upute su opisane u slijedecem odjeljku. 1.5 Nakon zavrsene instalacije pokrenute pod imenom whois program digger na portu 7777. /home/whois/bin-Linux/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.UPISIVANJE PODATAKA O KORISNICIMA U WHOIS++ BAZU PODATAKA ------------------------------ Postupak: 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. Kad ste sigurni da su podaci ispravno upisani, upisite naredbu "digger_insert" cime ce se podaci iz navedene datoteke ucitati u indeksiranu lokalnu bazu: /home/whois/bin-Linux/digger_insert /home/whois/dbdir/host.db 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 Napomena! 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.) 3. INDEKSIRANJE ----------------- Nakon uspjesno zavrsene instalacije servisa posaljite slijedece podatke o serveru elektronickom postom na adresu whois-admin@carnet.hr: -Ime i prezime administratora: -Naziv ustanove: -Adresa racunala: -Serverhandle: -Broj porta: Slijedeci korak je prikupljanje podataka sa vaseg racunala, tzv. indeksiranje. Glavni whois server na racunalu ds.carnet.hr prikuplja podatke o korisnicima na svim posluziteljima u mrezi, cime se omogucava pretrazivanje na sirem nivou. Indeksiranje se pokrece naredbom /home/whois/bin-Linux/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: CARNETHR Enter the other computers hostname: ds.carnet.hr Enter the other computers port: 8000 Enter the password the other computer will use: Enter the password you will use: Do you want to poll this server: (y/n) n 4. POMOCNI PROGRAMI ZA RAD S ELEKTRONICKIM IMENIKOM 4.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). Instalacija programa chwhois ----------------------------- Kopirajte naredbu chwhois u direktorij /usr/local/bin i postavite setuid whois korisnika: cp chwhois /usr/local/bin chown whois /usr/local/bin/chwhois chmod 4755 /usr/local/bin/chwhois 4.2. UPISIVANJE NOVIH KORISNIKA Nakon svakog dodavanja korisnika na racunalu (useradd) potrebno je istovremeno upisati korisnike i u whois++ bazu. To omogucava program whoisadd. 4.3 BRISANJE PODATAKA O KORISNICIMA Podaci iz imenika brisu se naredbom whoisdel. 4.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. U datoteku /etc/crontab upisite slijedecu liniju: 0 0 * * 0 /usr/users/whois/scripts/whoiscron > /dev/null 4.5 WWW klijent za pretrazivanje imenika U ovom direktoriju nalazi se i 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