Introduction

ABCD contains 6 modules:

Database Administration
Cataloguing
Loans
Statistics
Acquisitions
Thesaurus

Which are activated according to the rights assigned to users.

Installation:

The system installation consults two directories:

ABCD: which contains the scripts and other necessary resources for the program's operation and system pages presentation.

BASES: which contains the resources that the user generates or modifies in the databases during the ABCD operation (databases, messages files, help files, etc).

The database engine is Bireme WXIS which can be invoked in the different scripts through two methods:

Exec: acts invoking WXIS in a similar way to the commands line.

Http: acts invoking WXIS through a CGI. It is the system administrator´s responsibility to define the virtual directory CGI from which the wxis will be invoked.

The way to invoke WXIS is defined by the system administrator at the time of the installation and is registered in ABCD through the corresponding parameters in the configuration file.

ABCD configuration file

This is located in the directory /abcd/php under the name config.php and has the following parameters:

$db_path
Path to directory which contains the database.
E.g.:   $db_path="/abcd/www/bases/";

Notice that the path must finish with /. It should also keep the parameter syntax in order to avoid errors when scripts are executed.

The databases can be located in any directory in the system hard disk. Then this parameter is used for their localization. ABCD will create a subdirectory for each database in this directory.

$Wxis
Path where executable wxis.exe will locate, if this is the method selected for scripts execution. If CGI method is used, leave this parameter blank.

E.g.: $Wxis="/abcd/www/cgi-bin/wxis.exe";

This indicates that the executable name is wxis.exe and is located in the directory /abcd/www/cgi-bin/

          $Wxis="";

This indicates that the method of WXIS execution will be through a CGI

$wxisUrl
Specifies the URL used to invoke WXIS, when the selected method is through a CGI.

E.g.: $wxisUrl=http://localhost:9090/cgi-bin/wxis.exe;

In this case the parameter $Wxis will be blank ($Wxis="";). However, if both parameters have a value assigned, ABCD takes the url defined in $wxisUrl for the Wxis execution.

$lang
This specifies the default dialogue language to be used.
E.g.: $lang="es"; for spanish
         $lang="en"; for english

The available languages are stored in the directory bases in a file named lang.tab

$lang_db This specifies the dialogue language to be used in order to locate the database structures (FDT, FMT, PFT) when they are not located in the active language.

$institution_name Institution name

$FCKConfigurationsPath Path to FCK Editor´s configuration file.

Notice that these parameters are part of a programming script. Therefore, you cannot change their names or the shown syntax. Only what is in quotes ("....") can be changed to place the proper values.

User Verification

There is a subdirectory named access in the directory bases where the users who have access to ABCD are stored. They are 8 defined user types at the time of installation:

System Administrator
Database Administrator
Database Operator
Loans Administrator
Loans Operator
Acquisitions Administrator
Acquisitions Operator
Thesaurus Administrator

ABCD is dynamically configured according to the rights previously established for each role.

Verification of ABCD installation

To verify if the wxis is properly installed you can run the following url: http://localhost:9090/cgi-bin/wxis.exe?IsisScript=hello. If you receive the reply below:

WXIS|file error|file open|Isis_Script|

To verify if the wxis is properly installed you can run the following url: http://localhost:9090/php/test/test.php. In the resulting page click on the second link, which will show if there is any configuration error.

Then, the wxis is properly installed.

$db_path	Path to directory which contains the database. E.g.: $db_path="/abcd/www/bases/"; Notice that the path must finish with /. It should also keep the parameter syntax in order to avoid errors when scripts are executed. The databases can be located in any directory in the system hard disk. Then this parameter is used for their localization. ABCD will create a subdirectory for each database in this directory.
$Wxis	Path where executable wxis.exe will locate, if this is the method selected for scripts execution. If CGI method is used, leave this parameter blank. E.g.: $Wxis="/abcd/www/cgi-bin/wxis.exe"; This indicates that the executable name is wxis.exe and is located in the directory /abcd/www/cgi-bin/ $Wxis=""; This indicates that the method of WXIS execution will be through a CGI
$wxisUrl	Specifies the URL used to invoke WXIS, when the selected method is through a CGI. E.g.: $wxisUrl=http://localhost:9090/cgi-bin/wxis.exe; In this case the parameter $Wxis will be blank ($Wxis="";). However, if both parameters have a value assigned, ABCD takes the url defined in $wxisUrl for the Wxis execution.
$lang	This specifies the default dialogue language to be used. E.g.: $lang="es"; for spanish $lang="en"; for english The available languages are stored in the directory bases in a file named lang.tab
$lang_db	This specifies the dialogue language to be used in order to locate the database structures (FDT, FMT, PFT) when they are not located in the active language.
$institution_name	Institution name
$FCKConfigurationsPath	Path to FCK Editor´s configuration file.