Instalace

MemoDisx pracuje v OS/2 a v systémech typu Unix. Pokud jej zkusíte použít ve Windows, MemoDisx si bude myslet, že pracuje v OS/2. Možná to bude fungovat, ale není to testováno ani podporováno.

MemoDisx vyžaduje následující softwarové nástroje:

Apache 1.3.10 nebo vyšší s povoleným vkládáním kódu na straně serveru (server-side includes = SSI)
PHP 4 (s PHP 3 nebude fungovat)
MySQL 3.22.19 nebo vyšší
Prohlížeč WWW podporující rámy, CSS2 a JavaScript (JavaScript je doporučen, ale není vyžadován)

Další požadavky závísí na operačním systému:

OS/2 musí mít instalován Rexx. Apache jakož i další nástroje vyžadují EMX.
Unixová verze je závislá na standardních utilitách ls, df, mount, umount a isoinfo.

Chcete-li ukládat obsah archivů, musíte mít InfoZip, tar, gzip a bzip2. Není nutné mít všechny zmíněné programy, později si zvolíte, které z nich chcete užívat.

MemoDisx využívá techniky sjednání obsahu (content negotiation). Než budete s instalací pokračovat, musíte nakonfigurovat Apache pro použití MultiViews. Obvykle je to již nakonfigurováno, ale konfigurační soubor v distribuci může mít chybu v definici českého jazyka. Správný kód ISO pro češtinu je cs, ne cz!

MemoDisx je nyní dostupný v angličtině a v češtině. Ujistěte se, že konfigurační soubor načítá negotiation_module a obsahuje následující direktivy:

AddLanguage en .en
AddLanguage cs .cs
AddCharset iso-8859-2 .iso8859-2

Je povoleno přiřadit ke každému jazyku i několik přípon. Můžete si definovat i další jazyky.

Dále byste si měli nakonfigurovat jazyky ve svém prohlížeči WWW. Primárním jazykem programu MemoDisx je angličtina. Ujistěte se, že konfigurace vašeho prohlížeče WWW obsahuje obecnou angličtinu.

MemoDisx podporuje pouze jednu databázi společnou všem uživatelům. Musíte-li používat více oddělených databází, je nutné vytvořit několik samostatných kopií programu MemoDisx.

Nejprve musí být vytvořena databázová tabulka administrátorem MySQL. Příkazy jsou připraveny v souboru incl.dbcreate.txt. Před jejich použitím změňte alespoň heslo.

Nyní můžete připravit soubory pro Apache. Zkopírujte celý adresář na místo, kde Apache očekává soubory PHP. Tento adresář musí mít povolení zápisu pro uživatele, pod nímž běží Apache! Nezapomeňte použít umask 0, jinak nebudete moci nastavit právo zápisu všem uživatelům! Ujistěte se, že je povoleno vkládání kódu na straně serveru (SSI). Pak musíte nakonfigurovat MemoDisx s použitím příkazů ze souboru incl.htaccess (vložte je do hlavního konfiguračního souboru). Obsah je vysvětlen v následujícím textu.

# MemoDisx configuration
# ======================
# PHP4 and SSI must be enabled.
# MySQL must be installed on the same host.
# AddLanguage and AddCharset directives must be properly set.
# The system will NOT work without register_globals off.
# SSL is not necessary but recommended unless you access MemoDisx
# from your local computer and you are not sure that there is
# no TCP/IP spy which could reveal your password to someone else.

<Directory @@PHPDocumentRoot@@/memodisx>

Jméno adresáře nahraďte jménem použitým na vašem serveru.

  AllowOverride None
  Options +MultiViews +IncludesNOEXEC
  DirectoryIndex index

Tyto direktivy nastavují pro daný adresář SSI a MultiViews.

  <IfModule mod_php4.c>
    # AddType application/x-httpd-php php
    php_flag magic_quotes_gpc off
    php_flag magic_quotes_runtime off
    php_admin_flag register_globals off
  </IfModule>

PHP má výhodu v tom, že lze v konfiguraci Apache nastavit odlišné parametry pro každý adresář. Proto nebudeme měnit php.ini, abychom neporušili činnost jiných skriptů.

MemoDisx z bezpečnostních důvodů neregistruje globální proměnné a sám se stará o uvozovky. Direktiva AddType se obvykle vyskytuje v hlavním konfiguračním souboru a nemusí zde být opakována.

  <IfModule mod_ssl.c>
    SSLRequireSSL
  </IfModule>

SSL není vyžadováno, ale je doporučeno, pokud si však nejste jisti, že žádný síťový špión nemůže číst vaše heslo.

  <IfModule mod_expires.c>
    ExpiresActive On
    ExpiresDefault M3
    ExpiresByType text/css "access 1 day"
    ExpiresByType image/gif "access 1 month"
    ExpiresByType image/jpeg "access 1 month"
  </IfModule>

Stránky jsou vytvářeny dynamicky, proto je nutno řádně nastavit jejich expiraci. Bez tohoto modulu nemusí MemoDisx načíst nové stránky, ale zobrazí starý obsah.

  <IfModule mod_headers.c>
    <FilesMatch "\.php$">
      Header append Pragma "no-cache"
      Header set Cache-Control "no-cache, must-revalidate, private"
    </FilesMatch>
  </IfModule>

Tato část zabrání ukládání obsahu ve vyrovnávací paměti prohlížeče WWW.

  <FilesMatch "incl\.">
    Order allow,deny
    Deny from all
  </FilesMatch>

Tyto soubory obsahují funkce a citlivé informace, které nesmí být zobrazovány.

  AuthGroupFile @@SecurityFiles@@/groups
  AuthUserFile @@SecurityFiles@@/users
  AuthName "MemoDisx"
  AuthType Basic
  require valid-user
  # require group memodisx
  # require user memodisx Alice Bill Dinah Jabberwock Tweedledum Tweedledee

Aby se předešlo neautorizovanému užití, je doporučeno (ale není přísně vyžadováno) přijetí přístupových omezení. Můžete povolit přístup všem uživatelům, skupině uživatelů, nebo vyjmenovaným uživatelům. Superuživatel memodisx má zvláštní práva, jež jsou popsána v jiných částech tohoto návodu.

Poznámka: Bill (Vilík) je ještěrka z knihy Alenčina dobrodružství v kraji divů (Alice's Advantures in Wonderland). Dinah (Dína) je Alenčina kočka ze stejné knížky. Další postavy pocházejí z knížky Alenka za zrcadlem (Through the Looking Glass and What Alice Found There). Jabberwock je stvůra ze ,,zrcadlové básně`` (ve starším překladu Žvahlav, v novém překladu Tlachapoud), Tweedledum a Tweedledee jsou v českém překladu bratři Tydlidum a Tydlity.

</Directory>

Můžete omezit práva k načtení CD vytvořením souboru file incl.readcd.config.php. Příklad takového souboru je dodáván pod názvem incl.readcd-x.config.php. Můžete použít následující předdefinované konstanty:

_superuser_	Jméno superuživatele (memodisx)
_x_user_	Přihlášený uživatel
_x_user_ip_	IP adresa uživatelova počítače
_server_ip_	IP adresa serveru
_notallowed_	Chybová zpráva

Chcete-li si vytvořit demoverzi, uložte kopii souboru incl.demo-x.php pod názvem incl.demo.php.

Pokud jste tak ještě neučinili, restartujte Apache, uložte kopii souboru incl.install.php pod názvem install.php a spusťte MemoDisx v prohlížeči WWW. Další instrukce najdete v návodu zobrazeném v prohlížeči.