Este arquivo contém as instruções de instalação para a versão mais recente do ABCD.
Este texto destina-se para o gerenciador do sistema e do gerenciador de banco de dados.

• Introduction
• Prerequisites
• Preparation
• Install ABCD

---

Introdução

O ABCD código é executado no Windows e sabores de Linux. O código fonte é igual para ambos OS variantes, exceto por algumas pequenas diferenças.

ABCD requer vários outros componentes para suas operações. Componente CISIS (o banco de dados do kernel do software utilizado pela ABCD) é distribuído com o ABCD.
Alguns componentes integrados também são distribuídos com o ABCD.

Outros componentes são indicados como pré-requisitos, e não distribuídas ABCD.
Módulo EmpWeb (avançado empréstimos módulo) tem uma tecnologia completamente diferente, ele é colocado fora do ABCD-pasta www e precisa ser configurado de acordo com as instruções em seu próprio manual.

---

Pré-requisitos

Sempre necessária

• 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 opcionais

• 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

---

Preparação

A fase de preparação garante que um servidor web e PHP com o desejado pré-requisitos estão instalados. Este capítulo endereços de alguns pontos de atenção especificamente para a do ABCD.
Várias soluções existem para preencher essas funções ( nativo, XAMPP, WAMP, EasyPHP,…). Devido a muitas soluções e opções destas soluções é necessário ler a solução de documentação cuidadosamente. Este guia dá o mínimo de directivas.

Bom saber:

• Integrated solutions offer multiple functions. ABCD requires only the web server and PHP
• The firewall requires attention for the ABCD ports

Verifique o servidor web e PHP

Certifique-se de que o servidor web e PHP está instalado corretamente e que o PHP tem as extensões necessárias

Download ABCD

O código para o ABCD contém arquivos de configuração de exemplo para o servidor web.

Todo o código para o ABCD está localizado no GitHub ABCD-DEVCOM / ABCD2
Este repositório contém código para Linux E Windows e de dados específicos para Linux OU Windows.
Os downloads contém todos os 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)

Descompactar o arquivo baixado

Use o seu favorito (utilitário zip/7zip/tar/…) para descompactar o arquivo baixado. A estrutura da pasta
será:

<Release_name> --+-- www ----------+-- bases-examples_Linux
                                   +-- bases-examples_Windows
                                   +-- cgi-bin_Linux
                                   +-- cgi-bin_Windows
                                   +-- extra
                                   +-- htdoc
                 +-- zz_installation
                 +-- zz_miscellaneous

Virtual host do arquivo

O servidor web que serve uma ABCD instalação com uma configuração virtual. Com essa técnica várias, completamente diferente instalações são possíveis.

O exemplo da máquina virtual de arquivos de configuração para Linux e Windows
contêm os valores para um padrão ABCD instalação.

• 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

Virtual host do arquivo de instalação

• 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

Pré-processar o download de pastas

O ABCD código é baixado na fase de preparação.
Observe as diferentes ações para as plataformas Windows e Linux.

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

O conjunto resultante é:

bases                  # Folder with example databases
cgi-bin                # Folder with executable programs
htdocs                 # Contains ABCD

Copiar para o servidor web

O virtual host do arquivo especifica os nomes de pasta para o ABCD instalação.

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

Executar

Inicie o seu navegador favorito e executar ABCD com a seguinte 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

Recomendação: Modificar as senhas dos usuários administrativos para evitar o inesperado logins com excesso de privilégios

Ajuda

Ajuda adicional pode ser obtida juntando-se e usando o endereço de e-mail baseado ISIS-usuários de lista de discussão,

• registering: http://lists.iccisis.org/listinfo/isis-users
• using : mail to ‘isis-users@iccisis.org’