Instalace CSáčku

Postup instalace:

• Unix a unix-like systémy
  • CGI
  • FastCGI
  • Apache modul
  • Parametry skriptu configure

• MS Windows NT
  • CGI
  • ISAPI modul
  • Apache modul - nefunční

Unix - CGI mutace

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.

 Zpět

Unix - FastCGI mutace

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:
     LIBS="-L/adresar/s/libfcgi" ./configure --with-target=FastCGI

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.

 Zpět

Unix - Apache modul

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:

• Apache 1.1.X a 1.2.X
• Apache 1.3.X - DSO
• Apache 1.3.X - statický

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.c

 Zpět
 

Unix - Apache 1.1.X a 1.2.X

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.o

Pokud se při vytváření souboru mod_csacek.c programem make vypsalo:

Pouziva se systemova knihovna: -lz

EXTRA_LIBS= -lz

-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

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.so

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ý

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.o

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.

 Zpět

Parametry skriptu configure

--without-gcc

Nepoužije se gcc, i když je na systému k dispozici.

--with-templatedir=PATH

Určuje plnou cestu k adresáři se šablonami; cesta musí být uvedena tak, jak je na souborovém systému, nikoli WWW URL. Pod Apache lze tuto hodnotu nastavit také konfigurační direktivou csacekTemplateDir.
Default: /www/csacek

--with-server-charset=KOD

KOD bude nastaven jako defaultní kódování serveru - tato hodnota se použije pri překódování stránek, které nemají označeno sve kódování; vstup od uživatele bude také překódován do tohoto kódování. Pod Apache lze pouzit k nastavení téhož direktivu csacekDefaultCharset.
Povolené hodnoty: např. iso-8859-2, windows-1250, CP852, Mac, koi8-r (viz pole cstools_itab[] v cstools.c)
Default: iso-8859-2

--with-debug[=LEVEL]

Zapíná ladění CSáčku a pořizování záznamu o tom, co CSáček při běhu dělá. Výstupní soubory jsou /tmp/csacek_``PID''_``PORADOVE_CISLO''.

--with-target=MUTACE

Mutace, kterou chcete kompilovat.
Povolené hodnoty: Apache, CGI, FastCGI
Default: CGI

--disable-decodequery

Pomocí tohoto parametru lze vypnout překódovávání dat poslaných klientem do kódování serveru. U Apache CSáčku lze použít k témuž direktivu csacekRecodeInput Off.

--disable-compression

Nezakompilovat podporu pro kompresi. V případě, že je tento parametr uveden, CSáček se zkompiluje bez kódu pro kompresi. V případě, že tento parametr není uveden, u Apache CSáčku se dá direktivou csacekCompress komprese zapnout nebo vypnout.

--with-cmdtag=X

Určuje znak označující CSáček "tag".
Default: ?

--program-suffix=SUFFIX

Má význam pouze pro (Fast)CGI.
Pomocí tohoto parametru lze zařídit, aby generované skripty měly nějakou příponu (nejčastěji .cgi).

--with-method=METODA

Má význam jen pro (Fast)CGI.
Metoda, kterou se budou stránky vyzvedávat. http je jistota, ale může být zbytečně pomalá. guess se snaží uhádnout, jestli je daný soubor obyčejné HTML. Pokud ano, dokument předá přímo, jinak použije metodu http (tj. obsah dokumentu získá dalším požadavkem na server). Metoda file je nyni ekvivalentní s guess a je zachována jen kvůli kompatibilitě se starším CSáčkem a SaCzechem.
Povolené hodnoty: guess, http, file
Default: guess

--with-partlist="CASTI"

Má význam jen pro (Fast)CGI.
Názvy částí se použijí při generování jednotlivých linků. Pro každou část se vygeneruje přislušná sada toXXX.CAST.
Default: "cs en"

--disable-secure

Má význam pouze pro (Fast)CGI, pod Apache se použijí standardní bezpečnostní mechanismy serveru.
CSáček normálně testuje, zda někde "po cestě" k souboru, o který byl požádán, není soubor .htaccess nebo .nsconfig. Tento soubor slouží k nastavování konfigurace pro daný podstrom na WWW serveru - např. přístupových práv. Pokud onen soubor nalezne, pro vyzvednutí dokumenu použije metodu http. Tímto parametrem lze toto chovani potlačit.

--disable-symlink

Má význam pouze pro (Fast)CGI.
Může se vyskytnout sitace, kdy nelze použít symlinky. Pokud je uvedena tato volba, jednotlivé soubory se kopírují místo linkování.

 Zpět

MS Windows NT - CGI

Kompilace ze zdrojového kódu

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.

 Zpět

MS Windows NT - ISAPI

Instalace probíhá v těchto krocích:

1. Je třeba stáhnout distribuční soubor z adresy http://www.csacek.cz/distrib/bin/isapi/ a rozbalit jej.
2. Pro instalaci souborů slouží skript install_isapi.bat. Akceptuje dva parametry. První je jméno adresáře, kam se má umístit csáčkovské ISAPI dll (pokud tento adresář neexistuje, bude vytvořen). Druhý parametr určuje, zda se má do registry zapsat defaultní konfigurace CSáčku (obsah souboru csacek_isapi.reg). Platné hodnoty jsou a jako ano (toto je default) a n jako ne. Skript install_isapi.bat také zajistí vytvoření adresáře C:\CSacek a zkopíruje tam soubor whichcode_tamplate.html.
3. 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):
   1. V oknu s Console root je pod záložkou Internet Informational Server záložka podle jména počítače.
   2. Na toto jméno je třeba kliknout pravým myšítkem.
   3. Objeví se menu, je třeba vybrat Vlastnosti.
   4. Objeví se samostatné okno, obsahuje mimo jiné sekci Řídící vlastnosti, která obsahuje combo box (výběr).
   5. Je třeba tam třeba ponechat Služba WWW a klinout na vedlejší tlačítko Upravit.
   6. Objeví se další okno, s několika záložkami. Je třeba vybrat záložku Filtry ISAPI.
   7. Objeví se seznam již nainstalovaných ISAPI filtrů. Zde se provádí i přidávání nových filtrů.
   8. 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 předchozím 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.
4. Nyní je třeba přestartovat IIS a můžete CSáček začít používat.

Pozor: distribuce ISAPI CSáčku dostupná na WWW funguje pouze jeden měsíc.

 Zpět

MS Windows NT - Apache modul

 Zpět

 Úvodní stránka