Este archivo contiene las instrucciones de instalación para la versión más reciente de ABCD.
Este texto está destinado para el administrador del sistema y el gestor de base de datos.
Introducción
El ABCD de código se ejecuta en Windows y Linux sabores. El código fuente es igual para ambos OS variantes, excepto por algunas pequeñas diferencias.
ABCD requiere otros componentes para sus operaciones. Componente CISIS (la base de datos del núcleo del software usado por ABCD) se distribuye con ABCD.
Algunos componentes integrados también se distribuyen con ABCD.
Otros componentes son indicados como requisitos previos y no se distribuyen con ABCD.
Módulo de EmpWeb (módulo avanzado de préstamos) tiene una completamente diferente de la tecnología, es puesta fuera de la ABCD-carpeta www y debe ser configurado de acuerdo a las instrucciones en su propio manual.
Requisitos previos
Siempre se requiere
- A webserver. ABCD is tested with an Apache web server.
In order to minimize security problems the latest version is recommended. ABCD requires for a minimal installation at least - Module
mod_cgi: To allow execution of CGI scripts - Module
mod_rewrite: To allow rewrite rules in the.htaccessfile - A PHP processor. The unicode implementation of ABCD requires PHP 7.4.x.
The default loaded extensions depend on the actual PHP processor. ABCD requires for a minimal installation at least - Extension
mbstring: Multibyte support. To enable unicode. - Extension
gdorgd2: Image functions. The name depends on the PHP implementation
Requisitos opcionales
- Web server extensions
- Module
mod_ssl: Enables certificates and the https protocol - PHP Extensions
- Extension
curl: Required ifDSpace bridgeis used (to download records from DSpace repositories) - Extension
ldap: Required if login with LDAP is used - Extension
xmlrpc: Required if Site is used - Extension
xsl: Required if Site is used - Extension
yaz: Required ifZ39.50client is used (to download records via the Z39.50 communication protocol) - Apache Tika. This content analysis toolkit is required by the Digital Document functionality in ABCD.
ABCD uses the archivetika-app***.jarandjavato execute this jar.
Download thetikaarchive from https://tika.apache.org/download.html
Preparación
La fase de preparación se asegura de que un servidor web y PHP con la deseada requisitos previos se instalan. Este capítulo presenta algunos puntos de atención específicamente para ABCD.
Múltiples soluciones existen para cumplir estas funciones ( nativo, XAMPP, WAMP, EasyPHP,…). Debido a las muchas soluciones y opciones de estas soluciones es necesaria para leer la solución de la documentación cuidadosamente. Esta guía le da sólo un mínimo de directivas.
Bueno saber:
- Integrated solutions offer multiple functions. ABCD requires only the web server and PHP
- The firewall requires attention for the ABCD ports
Compruebe el servidor web y PHP
Asegúrese de que el servidor web y PHP está instalado correctamente y que PHP tiene las extensiones necesarias
Descargar ABCD
El código para ABCD contiene archivos de configuración de ejemplo para el servidor web.
Todo el código para que ABCD se encuentra en GitHub ABCD-DEVCOM / ABCD2
Este repositorio contiene el código compartido para Linux Y Windows y datos específicos para Linux O Windows.
La descarga contiene todos los componentes.
- Select option Releases on the right side of the window
- Scroll to the desired release and select Assets
- Select Source code (zip) or Source code (tar.gz)
Descomprimir archivo descargado
Use su favorito utilidad (zip/7zip/tar/…) descomprimir el archivo descargado. La estructura de la carpeta
será:
<Release_name> --+-- www ----------+-- bases-examples_Linux
+-- bases-examples_Windows
+-- cgi-bin_Linux
+-- cgi-bin_Windows
+-- extra
+-- htdoc
+-- zz_installation
+-- zz_miscellaneous
Virtual host de archivos
El webserver sirve una instalación ABCD con una virtual de configuración. Con esta técnica múltiples, completamente diferentes de las instalaciones son posibles.
El ejemplo de configuración del virtual host de archivos para Linux y Windows
contienen los valores por defecto ABCD de la instalación.
- These example files are located in
<Release_name> --+-- zz_installation - These files are example files. MUST be examined and updated to serve your needs and match the actual webserver.
- The virtual host file determines the protocol, port and server name for the ABCD installation.
- The port number is picked up by the ABCD installation
- The protocol (http/https) is picked up by the ABCD installation
- The https protocol is recommended. Take care of a certificate. To enable https: uncomment the lines with parameter names SSL*
- The virtual host file determines the locations for the ABCD components. The defaults are different for Linux and Windows.
The webserver adresses these folders with parameters: - DocumentRoot : folder with ABCD PHP-scripts
- ScriptAlias cgi-bin : folder with executable files (e.g. CISIS, jar’s,…)
- Alias docs : folder with database folders
- The example virtual host file specifies a specific location for the logs of this virtual host. Must be an existing folder ! Create it if it does not exist.
- The example virtual host file contains common PHP flags
Host Virtual archivo de instalación
- Copy the example file to the webserver configuration. The file name can be arbitrarily chosen.
Example locations: - WAMP →
wamp/alias, - XAMPP →
apache/conf/extra, - native Ubuntu →
/etc/apache2/sites-available/ - The existence of the file must be made known to the server. Method depends on the installed webserver solution
- XAMPP → edit
httpd.conf→include conf/extra/vhost_ABCD_9090_Windows.conf - native Ubuntu →
sudo a2ensite vhost_ABCD_9090_Linux.conf - Check configuration
- XAMPP → Start service and check log files
- native Ubuntu →
sudo apachectl -S/sudo apachectl -t -D DUMP_MODULES/sudo systemctl start apache2
Instalar ABCD
Preprocesar la descarga de carpetas
El ABCD de código es descargado en la fase de preparación.
Nota las diferentes acciones para Windows y Linux plataformas.
bases-examples_Linux # Linux users: Rename to "bases". Windows users: Delete
bases-examples_Windows # Windows users: Rename to "bases". Linux users: Delete
cgi-bin_Linux # Linux users: Rename to "cgi-bin". Windows users: Delete
cgi-bin_Windows # Windows users: Rename to "cgi-bin". Linux users: Delete
extra # Contains c-source code: Delete
htdocs # Contains ABCD
zz_installation # Contains this file, the "virtual host example files", and related files: Delete after installation
zz_miscellaneous # Only used by developers: Delete
El conjunto resultante es:
bases # Folder with example databases
cgi-bin # Folder with executable programs
htdocs # Contains ABCD
Copia en el servidor web
El virtual host de archivos especifica los nombres de carpeta para la instalación ABCD.
- Copy the content of htdocs to the folder specified by parameter DocumentRoot
- Copy the content of cgi-bin to the folder specified by parameter ScriptAlias
- Copy the content of bases to the folder specified by parameter docs
- If the Digital Document feature is used: Copy the downloaded tika jar to the folder specified by parameter ScriptAlias
- For Linux installations
- Change ownership of the folders to the owner/group of the webserver (
chown -R ...) - Change protection of the folders to correct values (
chmod -R ...)
- Restart the webserver/web server service
Ejecutar
Inicie su navegador web favorito y ejecutar ABCD con la siguiente URLs.
https://localhost:9090/phpinfo: Show information about PHP settings and extensionshttps://localhost:9090: The central module. Login usernameabcd, passwordadm.https://localhost:9090/iah: The iAH module. Login usernameabcd, passwordadm.https://localhost:9090/site: The SITE module. No loginhttps://localhost:9090/site/admin: The SITE module. Login usernameadm, passwordx.https://localhost:9090/opac: The OPAC module. No login
Configurar
Recomendación: Modificar las contraseñas de los usuarios administrativos para evitar sorpresas inesperadas inicios de sesión con demasiados privilegios
Ayuda
Ayuda adicional puede ser obtenida mediante la combinación y el uso de la dirección de e-mail basado ISIS-users lista de discusión,
- registering: http://lists.iccisis.org/listinfo/isis-users
- using : mail to ‘isis-users@iccisis.org’
