9.1 Instalace

Tato kapitola popisuje instalaci a o¾ivení systému Agent. Prvním krokem instalace je rozbalení distribuèního balíku (jeho¾ souèástí je mimo jiné i tato dokumentace) do zvoleného adresáøe pevného disku. Nadále pøedpokládáme, ¾e distribuèní balík je ji¾ instalován ve vybraném adresáøi. Kapitola 9.1.1 popisuje kroky nutné ke spu¹tìní serverù systému Agent. Kapitola 9.1.2 zachycuje instalaci klienta systému Agent. V kapitole 9.1.3 se dozvíte, jak systém spustit a jak ovìøit korektnost jeho instalace.

9.1.1 Servery

Servery není nutné nijak instalovat. Jediné co musíte udìlat, je zkontrolovat, jestli máte nainstalovány potøebné dynamické knihovny. Jedná se o Msvcp50.dll (verze 5.00.7022) a Msvcrt.dll (verze 5.00.7303). Pokud se nenalézají v systémovém adresáøi va¹eho Windows, zkopírujte tyto soubory z adresáøe runtime_dll do adresáøe bin. Souèástí distribuce je pro jistotu i knihovna Wsock32.dll (verze 4.10.1511), nepøedpokládáme v¹ak, ¾e ji budete potøebovat, mìla by být standardnì ve va¹em systému Windows.

Upozoròujeme na mo¾né problémy, pokud ji¾ máte v systému nainstalovanou jinou verzi uvedených knihoven. Zjistili jsme jisté problémy s nìkterými verzemi Msvcrt.dll dodávané s Visual Studiem verze 6 (tedy s knihovnami verze 6.00.*). Ov¹em napøíklad s verzí 6.00.8337.0 fungovalo v¹e dobøe. Zdá se, ¾e problémy jsou zpùsobeny knihovnami z raných verzí Visual Studia 6 (bez instalovaných záplat).

Jestli¾e chcete otestovat tento problém, zkuste pou¾ít nástroj FLCREAT.EXE z adresáøe bin. (Návod viz kapitola 9.1.4). Pokud bude program padat, budete muset (alespoò doèasnì) pøepsat knihovny v adresáøi Windows\System námi dodanými verzemi. Nakopírování na¹ich verzí DLL do bin adresáøe systému Agent nepomù¾e, jeliko¾ dané knihovny jsou ji¾ zpravidla v pamìti a je nutné znovuzavedení systému s na¹imi knihovnami v systémovém adresáøi.

9.1.2 Klient

Instalace klienta je ponìkud komplikovanìj¹í. Probereme ji postupnì v bodech.

1. Nainstalujte si na Java Runtime Environment 1.2 nebo Java Developer Kit 1.2. Ani jeden z balíkù není souèástí distribuce systému Agent a je nutné je poøídit zvlá¹». Mù¾ete si je napøíklad stáhnout z adresy http://java.sun.com/jdk/.
2. S pomocí nástroje Control Panel zálo¾ka Fonts nainstalujte dva fonty z adresáøe bin\client\fonts systému Agent. Jedná se konkrétnì o fonty Tahoma a Tahoma Bold. Oba jsou nutné pro správné zobrazování diakritických znakù v Javovém klientovi systému Agent. Rovnì¾ se ujistìte, ¾e máte nastaveno èeské lokální prostøedí (Control Panel/Regional Settings).
3. Zkopírujte font.properties.cs z adresáøe bin\client\fonts do jre\lib adresáøe va¹í instalace JVM (Java Virtual Machine - buï JRE 1.2 nebo JDK 1.2). Vodítkem vám mù¾e být to, ¾e v tomto adresáøi u¾ musí být pøítomny dal¹í soubory font.properties.*. Napøíklad font.properties.ru.

9.1.3 O¾ivení systému

Nyní by ji¾ mìlo být v¹e pøipraveno ke spu¹tìní sytému Agent. Narozdíl od pøedchozích verzí (1.1.0300) je tato dodávána s ji¾ pøedpøipravenou databází Main a s naplnìným stoplistem pro tuto databázi. Procedura o¾ivení systému se díky tomu podstatnì zkrátila a zjednodu¹ila. Spu¹tìní systému si opìt probereme v jednotlivých bodech.

1. Spus»te dávku run_search_svr.bat z adresáøe bin systému Agent. Vyèkejte a¾ vyhledávací server nastartuje. V sekci Poznámky (9.1.4) najdete vzorový výpis serveru.
2. Spus»te dávku run_net_svr.bat z adresáøe bin systému Agent. Vyèkejte a¾ sí»ový server nastartuje. Opìt se o korektnosti mù¾ete pøesvìdèit porovnáním výpisu se vzorovým v sekci 9.1.4.
3. Spus»te dávku admin_agent.bat z adresáøe bin systému Agent. Vyèkejte startu klienta a pøihlaste se do systému: v zálo¾ce "Connect" vyberte variantu "Real server Agent", vyberte "Mode" "Modify". Do kolonky "Username" napi¹te "a", do kolonky "Password" rovnì¾ "a". Stisknete tlaèítko "Connect" a vyèkejte a se vysvítí tlaèítko "Disconnect" a naopak "Connect" za¹edne - budete pøihlá¹eni do systému.
4. V zálo¾ce "Browser" nastavte cestu k va¹emu Webovému prohlí¾eèi. Ulo¾te je stisknutím tlaèítka "Save".
5. V zálo¾ce "Administration/Databases/Main/Statistics" stisknete tlaèítko "Reload". Ujistìte se, ¾e polo¾ka "Stoplist count" ukazuje èíslo 511 a ostatní polo¾ky 0. Pokud je tomu tak, va¹e instalace systému Agent byla právì úspì¹nì dokonèena.

9.1.4 Práce se systémem - struèný úvod

Nyní ji¾ mù¾ete pøidávat dokumenty. Buï mù¾ete indexovat dokumenty dostupné pøes HTTP nebo mù¾ete indexovat soubory z lokálního disku. HTTP dokument musí mít v¾dy adresu zaèínající "http://" naopak soubor z lokálního disku (mínìno z lokálního disku serveru - proto¾e dokumenty stahuje server) musí mít prefix "file://". Pøíklad viz tabulka.

Indexování velkého mno¾ství dokumentù si mù¾ete usnadnit pomocí seznamu URL. Mù¾e se jednat jak o "http://" tak o "file://" odkazy. Pøi indexování tímto zpùsobem nezapomeòte zatrhnout volbu "add documents from index file". Kolonka "document/index file URL" musí v takovém pøípadì obsahovat url seznamu (seznam URL také mù¾e být na Webu).

V bin adresáøi najdete nástroj FLCREAT.EXE s pomocí kterého mù¾ete vytvoøit seznam dokumentù na lokálním disku. Jako parametry mu zadáte jméno adresáøe a souborovou masku, nástroj prohledá rekurzivnì zadaný adresáø a vytvoøí seznam URL v¹ech souborù se zadanou maskou.

Dal¹í nápovìdu mù¾ete hledat v integrované nápovìdì klienta systému Agent. Pøi potøebì hlub¹ích informací se obra»te na pøíslu¹nou kapitolu dokumentace k projektu Agent. Dokumentaci mù¾ete vyu¾ít jak v elektronické tak ti¹tìné formì.

9.1.5 Ukonèení systému

Pro ukonèení systému Agent je tøeba nejprve odpojit klienta. To uèiníte stisknutím tlaèítka "Disconnect" na zálo¾ce "Disconnect". Po té mù¾ete klienta ukonèit.

Poté ukonèete sí»ový server. Ukonèuje se pøíkazem "quit" zadaným na pøíkazové øádce serveru.

Nakonec ukonèete vyhledávací server, opìt pøíkazem "quit" zadaným z pøíkazové øádky. Zejména u vyhledávacího serveru je dùle¾ité ukonèovat jej tímto zpùsobem a nikoliv pomocí Ctrl+C nebo jiným víceménì násilným zpùsobem. V opaèném pøípadì mù¾e dojít k nenávratnému po¹kození databáze.

9.1.6 Poznámky

V této kapitole je uveden pøehled standardních výpisù uvádìných jednotlivými servery systému Agent.

Vyhledávací server - start

compiled by MS Visual C++ version 1.1.0300 (1999-03-02) (RELEASE) Search server starting... starting thread pool with 3 threads listening on port 45454

První øádka udává kompilátor, kterým byla tato verze serveru zkompilována. Na druhé øádce je èíslo verze, datum sestavení této verze a typ (DEBUG nebo RELEASE). Dal¹í øádky informují o startu serveru, poètu vláken pro konkurentní vykonávání pøíkazù a portu na kterém server naslouchá klientùm.

Vyhledávací server - stop

Search server going down... shutdown kernel... invalid socket returned by "accept" kernel is down. net subsystem down

Sever postupnì vypisuje stav v jakém se nachází. Zejména upozoròuji na tøetí øádek výpisu. Jedná se o standardní varování pøi pøeru¹ení spojení a je na tomto místì naprosto v poøádku.

Sí»ový server - start

compiled by MS Visual C++ version 1.1.0300 (1999-03-02) (RELEASE) Net server starting... starting thread pool with 3 threads listening on port 45455

První øádka udává kompilátor, kterým byla tato verze serveru zkompilována. Na druhé øádce je èíslo verze, datum sestavení této verze a typ (DEBUG nebo RELEASE). Dal¹í øádky informují o startu serveru, poètu vláken pro konkurentní vykonávání pøíkazù a portu na kterém server naslouchá klientùm.

Sí»ový server - stop

Net server going down... shutdown kernel... invalid socket returned by "accept" Connector: error receiving data, quit... kernel is down. freeing socket: 29 net subsystem down

Sever postupnì vypisuje stav v jakém se nachází. Tøetí øádka indikuje stejnì jako u vyhledávacího serveru pøeru¹ení spojení s klientem. Ètvrtá naopak pøeru¹ení spojení s vyhledávacím serverem. Pøedposlední øádek indikuje, ¾e datové struktury urèené pro spojení s klientem byly uvolnìny z pamìti.