csacekServer www.ics.muni.cz ?>
This page is part of documentation of
C-SaCzech.
It has been created and is maintained by
Jaromír Doleček,
dolecek@sky.cz |
![]() |
Autor:
Jaromír Doleček,
dolecek@sky.cz
Datum poslední změny tohoto dokumentu: $Date: 2000/03/29 17:08:42 $
Dokumentace CSáčku Úvodní stránka
Postup instalace:
Obvykle je tedy nutno na Unixu CSáček zkompilovat ze zdrojových souborů.
V ideálním případě stačí rozbalit distribuční soubor
csacek-VERZE.tar.gz, přejít do adresáře, který se tak
vytvoří a zadat:
./configure
Skript configure ověřuje vlastnosti systému a vygeneruje
příslušné hlavičkové soubory a soubor Makefile. Skript
configure akceptuje několik parametrů, kterými lze ovlivnit
některé vlasnosti výsledného CSáčku. Popis významu jednotlivývh parametrů viz
níže.
Po skončení configure je třeba zadat:
make
a počkat, až se CSáček zkompiluje. V podadresáři compile/
se vytvoří binárka a potřebné symbolické linky na ni. Po dokončení
kompilace je třeba celý obsah adresáře compile/ přesunout
do adresáře na WWW serveru, ve kterém máte ostatní CGI skripty tak,
aby se na CSáček dalo odkazovat. Můžete ověřit funkci CSáčku
pokusným http://www.vas-server.cz/cgi-bin/toASCII/. Pokud
se stránka zobrazí v pořádku, tato část instalace je hotova.
Pro rozchození whichcode je ještě nutno nainstalovat jeho šablonu. Jedná se o soubor whichcode_template.html v podadresáři templates/. Tento soubor je nutno zkopírovat do adresáře /www/csacek. Lze použít i jiný adresář, pokud jeho jméno předáte CSáčku při kompilaci přes parametr --with-templatedir. Šablonu lze umístit i přímo do adresáře, kde jsou umístěny binárky CGI CSáčku - pokud CSáček nenalezne šablonu ve výše uvedeném adresáři, pokusí se jen otevřít v aktuálním adresáři. Většina WWW serverů nastavuje aktuální adresář pro spouštěné CGI skripty právě na adresář, kde je daný skript umístěn, takže to může zafungovat. Ještě ověřit funčnost testovacím http://www.vas-server.cz/cgi-bin/whichcode/ a instalace je hotova.
Skript configure je třeba volat s
parametrem
--with-target=FastCGI, jinak by se zkompilovat obyčejný
CGI CSáček.
Pokud je FastCGI knihovna nainstalována na nějakém nestandardním místě
(za "standardní" se považuje /usr/lib; na Linuxu ještě
/lib a na BSDi /shlib), je třeba skriptu
configure předat informaci o jejím umístění přes proměnnou
prostředí LIBS - je jej třeba volat takto:
Pokud je knihovna v některém ze "standardních" adresářů, počáteční LIBS="-L...." není samozřejmě třeba psát.
Dále instalace postupuje stejně jako u CGI.
Pod Apache 1.1.X nebyl CSáček nikdy testován v žádném "opravdovém" provozu (alespoň ne autorem). Měl by pod ním však fungovat přinejmenším stejně dobře jako pod 1.2.X.
Na Apache 1.2.4 byl Apache CSáček vyvíjen a probíhala na něm většina úvodních testů. Nasazení CSáčku na Apache řady 1.2.X by tedy nemělo způsobit žádný problém. Autorovi nejsou známy žádné problémy specifické pro CSáčka na Apache 1.2.X.
V současnosti je CSáček přednostně odlaďován na Apache 1.3.1 popř. 1.3.9. Množství spokojených uživatelů CSáčku na Apache řady 1.3 ukazuje, že i zde je CSáček velmi stabilní a dobrá volba. CSáček je například jediný češtinářský modul, který lze bez úprav serveru používat jako DSO modul.
Postup instalace je podobný jako v případě mutace
CGI a FastCGI,
jen je skript configure třeba spustit
s parametrem --with-target=Apache:
./configure --with-target=Apache
Nastavení ostatních parametrů není u Apache modulu tak
důležité, protože většinu z nich lze nastavit v konfiguraci
WWW serveru, nez nutnosti rekompilace modulu.
Příkazem make se vytvoří soubor mod_csacek.c. Další postup se liší podle verze Apache, který používáte:
Po vlastní kompilaci serveru či modulu je třeba ještě nainstalovat šablonu pro csáčkovské whichcode. Jedná se o soubor whichcode_template.html, je v podadresáři templates/ v adresáři s rozbaleným CSáčkem. Defaultně CSáček tuto šablonu hledá v adresáři /www/csacek/. Pokud ji chcete umístit jinam, jméno adresáře se dá změnit konfigurační direktivou csacekTemplateDir.Pokud používáte jako operační systém RedHat či odvozený systém a Apache 1.3.X máte z RPM, je třeba defaultní konfiguraci serveru přece jen ještě mírně doplnit. Konfigurace z RPM používá direktivy ClearModuleList a AddModule proto, aby se zbytečně neaktivovaly moduly, které nejsou používány. Do seznamu AddModule direktiv je nutné přidat jednu pro CSáček, aby se i on aktivoval - jinak nebude funční. Na konec seznamu je tedy třeba přidat
AddModule mod_csacek.cTím instalace Apache CSáčku končí a můžete si už jen užívat komfortu, který vám CSáček nabízí ;-)
Zpět
Unix - Apache 1.1.X a 1.2.X
U Apache 1.1.X a 1.2.X se CSáček musí zakompilovat do serveru.
Je nutné mít k dispozici zdrojový kód serveru Apache
a bude třeba mírně upravit konfigurační soubor pro kompilaci
Apache
Nejdřív je třeba překopírovat nebo nalinkovat soubor mod_csacek.c do adresáře se zdrojovým kódem Apache. Pak do souboru Configuration přidat direktivu:
Module csacek_module mod_csacek.oCSáček musí být poslední uvedený modul, jinak hrozí problémy.
Pokud se při vytváření souboru mod_csacek.c programem make vypsalo:
Pouziva se systemova knihovna: -lzje ji nutné přidat do EXTRA_LIBS, tj. v Configuration musí být uvedeno něco jako:
EXTRA_LIBS= -lzDále je třeba zajistit, aby se při kompilaci mod_csacek.c našly CSáčkovské hlavičkové soubory. Nejjednodušší cesta je modifikace CFLAGS (Apache 1.1.X) nebo EXTRA_CFLAGS (Apache 1.2.X) v souboru Configuration tak, aby obsahoval
-I/adresar/kde/je/rozbalen/CSacek
Nyní se postupuje už klasickým způsobem, spustí se apachovský skript ./Configure, který vygeneruje to, co je třeba. Následné make pak zkompiluje server. Výslednou binárku je třeba přemístit na své místo a WWW server je možné nastartovat. Po rozchození whichcode je instalace hotova. Pokud používáte RedHat, prosím přečtěte si tuto poznámku ke konfiguraci.
Apache CSáček se dá dále konfigurovat několika direktivami, přehled je uveden jinde.
Zpět
Unix - Apache 1.3.X - DSO
Jednoznačně nejpohodlnější a preferovaná cesta, jak dostat CSáček
na server. CSáček se jako dynamicky nahrávaný modul zkompiluje
pomocí nástroje apxs, který je součástí Apache 1.3.
Pokud je apxs v cestě při spuštění csáčkovského
configure, při následném make se automaticky
spustí a vytvoří příslušný soubor mod_csacek.so.
Jinak se jen vypíše, jakým způsobem se má apxs volat
a musíte to udělat "ručně" sami.
Výsledný soubor mod_csacek.so přesunete do adresáře s ostatními dynamickými moduly. Pak je třeba do konfigurace serveru přidat direktivu
LoadModule csacek_module /cesta/k/modulum/mod_csacek.soCestu není potřeba zadávat v případě, že je modul umístěn ve standardním adresáři.
Nyní stačí už jen rozchodit whichcode a instalace je hotova. Pokud používáte RedHat, prosím přečtěte si tuto poznámku ke konfiguraci.
Zpět
Unix - Apache 1.3.X - statický
Zakompilovat CSáček do serveru způsobem podobným jako pod Apache
1.1.X nebo 1.2.X lze samozřejmě i u Apache 1.3.X. Je to ale
ta obtížnější a méně flexibilní cesta, za normálních okolností
pravděpodobně použijete CSáček jako
DSO modul.
Postup instalace je víceméně shodný jako u Apache 1.2.X, jen je lepší soubor mod_csacek.c nakopírovat nebo nalinkovat do adresáře .../apache_1.3.X/src/modules/extra/ a direktiva v apachovském Configuration musí být
AddModule modules/extra/mod_csacek.omísto Module. Opět platí, že CSáček by měl být uveden jako poslední modul, jinak si koledujete o problémy. Obsah EXTRA_LIBS a EXTRA_CFLAGS je třeba upravit tak, jak je uvedeno u popisu kompilace pod Apache 1.2.X.
Druhá možnost je přidat CSáček do serveru bez přímé editace
souboru Configuration. Při spuštění APACI configure
přidáte parametr
--add-module=src/modules/extra/mod_csacek.c
a skript zajisti vložení a zakompilování modulu. Není ale možné
nijak specifikovat extra adresáře s hlavičkovými soubory, takže
při tomto postupu je třeba do adresáře
.../src/modules/extra/ kromě mod_csacek.c
zkopírovat i všechny CSáčkovské hlavičkové soubory.
Pak se příkazem make zkompiluje server a je možno
ho restartovat. Stačí jen
rozchodit whichcode a instalace je hotova.
Pokud používáte RedHat, prosím přečtěte si tuto
poznámku ke konfiguraci.
Apache CSáček se dá dále konfigurovat několika direktivami, přehled je uveden jinde.
Pokud kompilujete CGI CSáček pomocí nějakého IDE, může přijít vhod skript copy_cgi.bat, který program, zadaný jako argument, rozkopíruje na jednotlivé toXXX, whichcode. Jinak pak platí to samé jako u kompilace pomocí přiloženého Makefile.
Dále je třeba změnit konfiguraci serveru IIS tak, aby CSáček použil. CSáček je třeba nainstalovat jako globální ISAPI filtr. Dá se to udělat přes program MS Management Console (v menu je obvykle označován jako Správce služeb sítě Internet). V oknu s Console root je pod záložkou Internet Informational Server záložka podle jména počítače. Na toto jméno je třeba kliknout pravým myšítkem. Objeví se menu, je třeba vybrat Vlastnosti. Objeví se samostatné okno, obsahuje mimo jiné sekci Řídící vlastnosti, která obsahuje combo box (výběr). Je třeba tam třeba ponechat Služba WWW a klinout na vedlejší tlačítko Upravit. Objeví se další okno, s několika záložkami. Je třeba vybrat záložku Filtry ISAPI. Objeví se seznam již nainstalovaných ISAPI filtrů. Zde se provádí i přidávání nových filtrů. Stiskne se tlačítko Přidat, pak se zadá jméno filtru (může být jakékoli, např. CSáček) a cesta k DLL souboru, který jej implementuje. Pro CSáček bude cesta něco jako C:\CSacek\csacek_isapi.dll - jméno adresáře je třeba zadat stejně, jako při volání skriptu install_isapi.bat, csacek_isapi.dll je vlastní filtr. Pokud si cestu přesně nepamatujete, lze použít tlačítko Procházet a soubor nalézt takto.
Nyní je třeba přestartovat IIS a můžete CSáček začít používat.