OAI Szerver Perl/PHP implementációjának telepítési útmutatója

A Perl/PHP OAI szerver Apache alá történő telepítéséhez az alábbi beállításokat kell elvégeznie:

1.	Hozzon létre az adatbázisszerveren egy adatbázist, vagy használjon egy meglévő adatbázist.

2.	Hozza létre az adatbázisban a táblákat a megfelelő adatbázisszerverhez, a csomagban mellékelt sql scriptek valamelyikének segítségével.
MYSQL-hez: mysql_create.sql
FIREBIRD-hez: fb_create.sql
POSTGRESQL-hez: psql_create.sql

3.	Hozzon létre egy könyvtárat az alkalmazás számára (ez Perl esetén rendszerint  [path]/cgi-bin)
Helyezze el a könyvtárban a szervereket.

A PHP szerver a következő file-okból áll:	A Perl szerver a következő file-okból áll:	
.htaccess

common.css
cfg_utils.php
config.php
config_ruleset.php
config_up.php
config_xml.php
domxml-php4-to-php5.php
manager.php
oai.php
oai_functions.php
oaicommon.php
oaidb.php
parameters_inc.php
upload.php
upload_functions.php
Repository.xml
	.htaccess
.htpasswd
common.css
cfg_utils.pl
config.pl
config_ruleset.pl
config_up.pl
config_xml.pl

manager.pl
oai.pl
oai_functions.pl
oaicommon.pl
oaidb.pl
parameters_inc.pl
upload.pl
upload_functions.pl
Repository.xml	

A további példákban a php szervert a /var/www/php könyvtárban, a perl szervert a /var/www/cgi-bin könyvtárban helyeztük el.

PHP szerver beállításai

Telepítse a megfelelő modulokat az operációs rendszerre:
A PHP szerver a következő modulokat használja (php4 futtatókörnyezet esetén)

php4-curl
php4-domxml
php4-interbase
php4-mysql
php4-pgsql
php4-xslt

A telepítés debian linux sarge alatt az
apt-get install php4-curl php4-domxml php4-interbase php4-mysql php4-pgsql php4-xslt paranccsal lehetséges.
Windows alatt a php.net-ről letölthető disztribúcióban mellékelik az összes modult.

Konfigurálja a php-t, hogy használja a modulokat, amennyiben ezt a rendszer nem tette meg automatikusan a modulok telepítése közben. Ezt a php.ini file szerkesztésével teheti meg. A következő sorokat kell a php.ini-be beírni:

Linux alatt	Windows alatt	
extension=curl.so
extension=domxml.so
extension=interbase.so
extension=mysql.so
extension=pgsql.so
extension=xslt.so	extension=php_curl.dll
extension=php_domxml.dll
extension=php_interbase.dll
extension=php_mysql.dll
extension=php_pgsql.dll
extension=php_xslt.dll	

A php.ini file-t Windows alatt általában a C:\WINDOWS\, Linux alatt a /etc/php4/apache útvonalon találtja meg (amennyiben nem itt lenne, úgy a 'phpinfo()' parancs kimenetében szerepel ez az információ)

Konfigurációhoz szükséges alapértelmezett felhasználónév, illetve jelszó a következő:
Felhasználónév: htrw
Jelszó: qwerty

Perl szerver beállításai

Telepítse a megfelelő modulokat az operációs rendszerre:
A Perl szerver a következő CPAN modulokat használja
Data::Dumper
CGI
XML::DOM
Digest::SHA1
CGI::Session
MIME::Base64
Storable
WWW::Curl::easy
DBI
DBD::CSV
DBD::mysql
DBD::Pg

A modulok telepítése debian linux sarge alatt az
apt-get install perl perl-base perl-modules libxml-dom-perl libwww-curl-perl libdbi-perl libdigest-sha1-perl libcgi-session-perl libdbd-csv-perl libdbd-mysql-perl libdbd-pg-perl paranccsal lehetséges.

Perl szerver esetén a webszerver konfigurációjában az alábbi beállítást kell elvégezni:

<Directory /var/www/cgi-bin/>
    Options ExecCGI
</Directory>

A Perl szerver működéséhez szükséges még módosítani a .htaccess file-t is, a következőképpen:
Módosítsa a file-ban található összes AuthUserFile kezdetű sort (pl: AuthUserFile /var/www/oai/cgi-bin/.htpasswd) úgy, hogy az elérési útvonal a .htpasswd file filerendszerbeli abszolút pozícióját tartalmazza. (Ha például a /var/www/cgi-bin/ tartalmazza a perl szervert, akkor a következőre kell módosítani: AuthUserFile /var/www/cgi-bin/.htpasswd)

Töltse fel a központilag kiosztott konfigurációs csonkot a [host]/php/config_up.php ill. [host]/cgi-bin/config_up.pl címen, a következő oldalon pedig konfigurálja a szerver többi adatát. 

Amennyiben “kritikus hiba a .htaccess vagy a .htpasswd file-ban” hibaüzenet jelenik meg  a config_up.pl megnyitásakor, akkor a webszerver nem veszi figyelembe a cgi-bin könyvtárban levő .htaccess file-t. Ilyenkor mozgassa egy könyvtárral feljebb a file-t.

Konfigurációhoz szükséges alapértelmezett felhasználónév, illetve jelszó a következő:
Felhasználónév: htrw
Jelszó: qwerty