Installation_instructions

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 .htaccess file
  • 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 gd or gd2 : 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 if DSpace bridge is 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 if Z39.50 client 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 archive tika-app***.jar and java to execute this jar.
    Download the tika archive 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.

  1. Select option Releases on the right side of the window
  2. Scroll to the desired release and select Assets
  3. 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.confinclude 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.

  1. Copy the content of htdocs to the folder specified by parameter DocumentRoot
  2. Copy the content of cgi-bin to the folder specified by parameter ScriptAlias
  3. Copy the content of bases to the folder specified by parameter docs
  4. If the Digital Document feature is used: Copy the downloaded tika jar to the folder specified by parameter ScriptAlias
  5. 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 ...)
  1. 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 extensions
  • https://localhost:9090 : The central module. Login username abcd, password adm.
  • https://localhost:9090/iah : The iAH module. Login username abcd, password adm.
  • https://localhost:9090/site : The SITE module. No login
  • https://localhost:9090/site/admin : The SITE module. Login username adm, password x.
  • 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’

Deja una respuesta