Guía de instalación Linux

Última modificación por jhurst el 2021/11/15 09:22


Vocabulario

En todas estas páginas de documentación, las "aplicaciones" hacen referencias a los archivos con la extensión .war presentes en el servidor DigDash Enterprise: 

  • Servidor: ddenterpriseapi.war
  • Cuadro de mandos: digdash_dashboard.war
  • Web Studio: studio.war
  • Página de inicio y Desktop Studio: adminconsole.war

Este conjunto de aplicaciones forma un dominio. Según las necesidades, este dominio se puede duplicar para, por ejemplo, poder tener un entorno de desarrollo y un otro de producción.

Para desplegar varios dominios, siga este enlace.

La instalación de DigDash Enterprise en un sistema Linux se puede hacer de dos maneras: 

  • usando el servidor de aplicación Tomcat proveído en el archivo de instalación DigDash Enterprise
  • usando su propio servidor Tomcat o el servidor de aplicación compatible JEE. 

Esta página describe como usar el servidor Tomcat proveído, y también la instalación con un otro Tomcat. 

Para hacer la instalación en un sistema Windows, siga Guía de instalación de DigDash Enterprise en Windows.

Para hacer la actualización de una instalación exístante, siga Guía de actualización DigDash Enterprise.

Tomcat Proveído en la instalación DigDash Enterprise

Descompresión

  • Descomprima el archivo digdash_enterprise_2021R1_numpatch.zip dentro del directorio deseado.(Aconsejamos de descomprimirlo en /user/share/digdash_enterprise).
    • La manera ideal de hacerlo es de elegir un nombre sin versión dentro, para no equivocarse en el contenido de la instalación durante las próximas actualizaciones que vendrán. 
  • Compruebe que su carpeta de instalación contenga un archivo version.txt.
    • Es este archivo que indicara con certitud la versión del producto (sin deber encender el servidor).

Propietarios y derechos

De al usuario <USER> deseado la propiedad y las permisiones de lectura y escritura en el directorio /usr/share/digdash_enterprise_20xxxx con la ayuda de las siguientes comandos:

USER@domain:~# chown –R USER /usr/share/digdash_enterprise
USER@domain:~# chmod –R 755 /usr/share/digdash_enterprise

Indique donde se encuentra el archivo de configuración

El archivo digdash.properties en el directorio de instalación le permite de configurar todo el entorno.

Para que sea usado de forma correcta para DigDash Enterprise, copie este archivo digdash.properties en el directorio /etc/digdash.

Cuidado a las permisiones de acceso: aplique los mismos comandos que en el previo paso.

Puede pues modificar este archivo digdash.properties para personalizar su entorno: en este sentido, siga el enlace: Externalización de los parámetros en el archivo digdash.properties.

Ubicación del directorio de sus datos

DigDash Enterprise almacena los datos de configuración, los modelos de datos, las carteras de información, los cubos, el historial de los flujos y varios otros archivos de trabajo en la carpeta del usuario del sistema operativa en un subdirectorio Application Data/Enterprise Server/<dominio>.

Por ejemplo, en Windows, este archivo es:
C:\Users\<usuario>\AppData\Roaming\Enterprise Server\ddenterpriseapi

Es importante modificar este archivo para garantizar la accesibilidad (derechos en lectura, escritura, ejecución) y para supervisar el espacio de almacenamiento. 
Esta modificación es también interesante para razones de organización, de scripting, etc.

Existe varias maneras de modificar esta ubicación. 

Directorio común a todos los dominios

Archivo modificado: digdash.properties

Es la manera la más sencilla y la más eficaz. Todos los dominios de su instalación DigDash Enterprise aprovecharon de esta modificación (una única configuración para todos).
(La secunda manera es a reservar en caso de necesidad específica).

La variable digdash.appdata permite especificar el único directorio de los datos.
En el archivo <DDE Install>/digdash.properties quita el simbol # delante de la línea  #digdash.appdata=c:/data  para descomentar la línea :

digdash.appdata=/var/lib/digdash/appdata

Si este directorio no existe, DigDash Enterprise lo crea. Los datos no se almacenan directamente en este directorio, pero en subdirectorios para cada uno de los dominios. 

  • <digdash.appdata>/Enterprise Server/<dominio>
  • <digdash.appdata>/Enterprise Administrator
  • <digdash.appdata>/ldapdigdash

Ventaja: La configuración se hace al nivel del archivo digdash.properties, y pues no será borrada durante una actualización de DigDash Enterprise con el despliegue de nuevos archivos WAR.

Inconveniente: Esta configuración es global por el Tomcat de DigDash Enterpise, así que todos los dominios de DigDash de su servidor serán concernidos esta configuración.
Sin embargo, los datos de los diferentes dominios DigDash Enterprise desplegados en este Tomcat tienen sus subdirectorios propios, así que no hay riesgos de destrucción de datos. 

Directorio diferente para cada dominio

Archivo modificado: digdash.properties

La variable <dominio>.AppDataPath  definida en este archivo tiene el mismo comportamiento que la variable global descrita antes.
La diferencia es que esta configuración es específica por un dominio  DigDash Enterprise.

Para definir un directorio de los datos especifico a un dominio, modifica el parámetro  AppDataPath prefijado por el nombre del dominio.

Si tiene un dominio ddenterpriseapi_dev, la variable será a especificar así: 

ddenterpriseapi_dev.AppDataPath=/var/lib/digdash/appdata_dev

Ventajas:

  • Configuración especifica a un dominio
  • Archivo externo de los WAR

Inconveniente: Esta configuración se debe reproducir para cada dominio.

Encender Tomcat

Con su usuario <USER> ejecuta la comando para encender Tomcat :

USER@domain:~# cd /usr/share/digdash_enterprise_20xxxx/apache-tomcat/bin/
USER@domain:~# sh startup.sh

Su propio servidor Tomcat como servicio

Con las opciones de seguridad y del modo de ejecución de Tomcat en los diferentes servicios Tomcat de las distribuciones Linux, asegúrese de que el usuario utilizado para ejecutar Tomcat tenga derechos suficientes para crear los archivos que necesita DigDash.

  1. Instale Tomcat
  2. Descargue y descomprima el archivo de instalación de DigDash Enterprise
  3. Como usuario root, ejecute la comando siguiente: mkdir /etc/digdash
  4. En el directorio /etc/digdash:
    1. Copie el archivo digdash.properties
    2. Quite el # prefijando el parámetro digdash.appdata, y dele el siguiente valor: digdash.appdata=/var/lib/digdash/appdata
  5. Copie los archivos WAR ubicados en el directorio <DDE Install>/apache-tomcat/webapps/ hacia el directorio webapps de Tomcat (puede ser /var/lib/tomcat8/webapps).
  6. Tomcat debería extraer los WARs agregados de manera automática. Si no es el caso, re-encienda Tomcat (con el comandoservice tomcat8 restart).
  7. Como usuario root, ejecuta los siguientes comandos:

    cd /var/lib
    mkdir digdash
    chown tomcat8:tomcat8 digdash
    cd /var/log
    mkdir digdash
    chown tomcat8:tomcat8 digdash
  8. En el archivo:/etc/digdash/digdash.properties
    • Active el parámetro log4j.appender.R.File para cada aplicación (borre el # de los inicios de líneas).
    • El valor predeterminado permite de tener un único archivo de log: /var/log/digdash/ddenterpriseapi.log
      Lo puede modificar para tener, según su necesidad, un archivo por aplicación.
      Por ejemplo, es interesante de separar los logs de la aplicación del studio (studio.war)
      studio.log4j.appender.R.File=/var/log/digdash/studio.log
  9. Re-encienda Tomcat (con el comandoservice tomcat8 restart)

Solución en caso de incidente

"Permission denied" o "Read-only system"

Si tiene en los logs un mensaje "permission denied", "read-only system" o unos problemas similares después de la instalación de DigDash y que usa un servicio systemd para encender Tomcat (es el tipo de servicio predeterminado en la mayoridad de las distribuciones Linux), unos parámetros de seguridad en el archivo servicio pueden ser la razón de estos problemas. 

Para más información (en ingles): https://www.freedesktop.org/software/systemd/man/systemd.exec.html#Sandboxing

Para solucionar estos problemas: 

  1. Encuentre el archivo tomcat8.service
  2. Abra este archivo como usuario root
  3. Asegúrese de que el campo ProtectSystem exista
  4. Añada ReadWritePaths=/var/lib/digdashReadWritePaths=/var/log/digdash si no existen ya
  5. Guarde el archivo
  6. Ejecute el siguiente comando como usuario root para recargar el archivo servicio: systemctl daemon-reload
  7. Re-encienda Tomcat (con service tomcat8 restartsystemctl restart tomcat8.service)