AYUDA PARA LA INSTALACIÓN DE HONTZA

Hontza está diseñado para ofrecer un Servicio web de modo continuo. No tiene sentido instalar Hontza y ofrecer un servicio web de modo intermitente.

Para ello te recomendamos que lo instales en un Servidor Web con S.O. Linux que funcione conectado a Internet con una IP Fija y funcionando las 24 horas.

 

Características recomendadas del Servidor Web:

 

Para que funcione el Servicio Hontza correctamente el Servidor Web debería tener:

  • Sistema operativo:   Ubuntu server 18.04 LTS (es la ultima versión estable o “Long Term Support”)
  • Complementos:         Infraestructura LAMP = Linux, Apache, MySQL, PHP (últimas versiones estables)
  • Servidor de correo:  SendMail (última versión estable)
  • Disco Duro:                 No es necesario tener dos discos separados, para sistema y datos. 50 Gb es más que suficiente
  • Memoria RAM:          2Gb es suficiente
  • Ancho de banda:       No hay ninguna especificación
  • IP:                                  Fija
  • Dominio web:            Es conveniente para que los usuarios web identifiquen el servicio, pero técnicamente es suficiente con tener una IP.

 

PASOS para instalar Hontza:

 

A) Si no tienes un Servidor Web y sólo quieres PROBAR/EVALUAR Hontza:

  1. Instalación de la Máquina Virtual – VirtualBox 
  2. Instalación de Ubuntu Server 18.04 LTS
  3. lnstalación de LAMP
  4. Instalación del Servidor de Correo – SendMail

B) Si ya tienes un Servidor Web Linux y deseas DAR SERVICIO con Hontza

5. Instalación de la aplicación Hontza

1. Instalación de la Máquina Virtual – VirtualBox

Este paso te permite que, aunque no tengas un Servidor Web, puedas PROBAR la instalación y ejecución de Hontza en tu ordenador personal.

Esta opción no es la recomendada para dar un servicio profesional, porque tendrías que tener tu ordenador personal conectado a la red y funcionando las 24 horas.

Para poner en marcha un Servidor Web Linux en tu ordenador personal con Windows, lo primero es instalar una máquina virtual.

La máquina virtual es un programa que te permitirá arrancar un ordenador Linux, incluyendo el Servicio Hontza, desde de tu ordenador Windows, cuando quieras.

Al instalar la máquina virtual, debes indicar los recursos de tu ordenador que cedes a la máquina virtual (al menos una parte del Disco Duro y de la memoria RAM).

No es algo permanente; cuando apagues la máquina virtual, tu ordenador volverá a tener todos los recursos.

No debes preocuparte por tu ordenador, disco duro, datos, etc. Si algo falla en la máquina virtual, este fallo no afectará en absoluto a tu ordenador.

Es decir, al ejecutar la máquina virtual, tendrás dos ordenadores que funcionarán de modo simultáneo e independiente, sin interferir entre ellos. Mas info aquí.

Hemos seleccionado VirtualBox como software de máquina virtual.

Ejecuta los pasos de este vídeo para instalar VirtualBox en tu ordenador, es una instalación de Windows muy simple.

2. Instalación de Ubuntu Server 18.04 LTS

Una vez instalada la máquina virtual, debes instalar en ella el sistema operativo Ubuntu Server 18.04 LTS.

Si acabas de instalar tu máquina virtual, sólo tienes que ejecutar los comandos que hemos grabado en el siguiente vídeo.

Si deseas más información puedes pulsar aquí para leer un tutorial que explica los pasos de la instalación de Ubuntu Server.

3. Instalación de LAMP

LAMP son las siglas que definen la infraestructura típica de un Servidor Web:

  • Linux:      Nucleo del Sistema Operativo libre tipo Unix
  • Apache:  El servidor de páginas Web http de código abierto más popular
  • Mysql:     La base de datos de código abierto más popular de mundo
  • PHP:        Lenguaje de programación muy utilizado (nota: a veces la P de LAMP se refiere a PerlPython que también son lenguajes de programación)

En Ubuntu Server 18.04 LTS, hay que instalar cada componente por separado ejecutando su propio instalador.

Si acabas de instalar tu máquina virtual, sólo tienes que ejecutar los mismos comandos que hemos grabado en el siguiente vídeo.

Si deseas más información puedes pulsar aquí para leer un tutorial que explica los pasos de la instalación de LAMP.

 

4. Instalación del Servidor de Correo – SendMail

Si acabas de instalar tu máquina virtual, sólo tienes que ejecutar los comandos que hemos grabado en el siguiente vídeo (falta).

Hemos seleccionado SendMail porque es un servidor de correo clásico, muy simple y muy estable.

Si deseas más información puedes pulsar aquí para leer un tutorial que explica los pasos para instalar el servidor de correo SendMail

1) Desinstalar Postfix

$ sudo systemctl stop postfix
$ sudo apt remove postfix && apt purge postfix

2) Instalar sendmail

$ sudo apt install sendmail

3) Configurar sendmail: Elegir y o yes en todas las opciones para una configuración básica.

$ sudo sendmailconfig

4) Editar el /etc/mail/sendmail.mc y comentar las lineas que vienen a continuación poniendo dnl al principio de la linea.

dnl DAEMON_OPTIONS(`Family=inet, Name=MTA-v4, Port=smtp, Addr=127.0.0.1′)dnl
dnl DAEMON_OPTIONS(`Family=inet, Name=MSP-v4, Port=submission, M=Ea, Addr=127.0.0.1′)dnl

 

5) Compilar archivos de configuración de Sendmail

$ sudo m4 /etc/mail/sendmail.mc > /etc/mail/sendmail.cf

6) Reiniciar Sendmail

$ sudo systemctl restart sendmail

5. Instalación de la aplicación Hontza

Si tienes tu propio Servidor Web, verifica:

 

  • Que está instalada la infraestructura LAMP completa: Linux, Apache, mysql, PHP
  • Cuál es la restricción de password de tu mysql, por defecto suele ser 8 caracteres, con al menos una mayúscula, un número y un carácter especial.

Para verificarlo, usa este comando:

mysql -u root -p   ->    show VARIABLES LIKE ‘validate_password%’;

  • Cuál es el usuario y contraseña de mysql con derechos de admin
  • Cuál es el repositorio /home de tu servidor web
  • Descarga el instalador de Hontza y descomprímelo, se generará la carpeta hontza
  • Mueve la carpeta hontza al directorio /home

 

Si acabas de instalar tu máquina virtual, sólo tienes que ejecutar los comandos que hemos grabado en el siguiente vídeo 

Para más información puedes pulsar aquí para leer los pasos del instalador

 

1) Descarga el instalador de Hontza y descomprímelo

wget http://www.hontza.es/wordpress/wp-content/uploads/2019/09/hontza-5.7.zip
unzip hontza-5.7.zip

2) Ejecuta como root el archivo installer-ES.sh mediante el comando bash.

bash installer-ES.sh

 

3) Notas a varios pasos criticos de la instalación:

En este paso, el instalador ha creado en mysql la base de datos “hontza” y el usuario “hontza” y te pide que definas su contraseña (es nueva y no tiene nada que ver con el sistema donde se instala hontza)

Si acabas de instalar la máquina virtual, define una contraseña que tenga 8 caracteres con al menos una mayúscula, un número y un carácter especial.

En este paso, el instalador te pide que le indiques un usuario de mysql con derechos de admin que, por defecto, es root.

Si acabas de instalar la máquina virtual, solo debes pulsar Return

Si ya tienes tu servidor con mysql, indica un usuario de mysql con derechos de admin; root es uno de ellos, pero puede haber otros.

Indica la dirección de la raiz del servidor web.

Si acabas de instalar la máquina virtual, sólo debes pulsar Return

Si ya tienes tu servidor web, selecciona la dirección deseada.

4) Verificaciones

  • Cuando obtengas el mensaje final de que todo ha ido correctamente, es recomendable comprobar que se han escrito correctamente los trabajos del cron. Mediante el comando crontab -e, vemos que están escritas estas líneas:

0 * * * * wget -O /dev/null http://[url_hacia_la_herramienta]/cron.php &> /dev/null
15,30,45 * * * * wget http://[url_hacia_la_herramienta]/hontza_solr/indexar 2>&1 > /dev/null
15,30,45 * * * * wget http://[url_hacia_la_herramienta]/cron_google_sheet.php 2>&1 > /dev/null
#5,35,50 * * * * lynx -dump http://[url_hacia_la_herramienta]/red/solr/apachesolr_index_batch_index_remaining 2>&1 > /dev/null

Si la URL que dirige a la herramienta está mal configurada o directamente vacia, debes ponerla bien.

 

  • Entra en la url [url_hacia_la_herramienta]/hontza/admin/settings/file-system y verifica que el file system path esta definido. Si no lo estuviera, pon alguna carpeta de confianza (también se recomienda poner el sites/default/files).

 

  • La dirección, usuario y contraseña para entrar como administrador a la herramienta hontza son:

http://[direccion IP]/hontza

Username: admin

password: hontza