Código fuente wiki de Guide d'Installation Linux

Última modificación por jhurst el 2021/07/12 12:10
Mostrar los últimos autores
1 {{ddtoc/}}
2
3 ----
4
5 (% class="box infomessage" %)
6 (((
7 __Vocabulario__
8
9 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:
10
11 * **Servidor**: ddenterpriseapi.war
12 * **Cuadro de mandos:** digdash_dashboard.war
13 * **Web Studio:** studio.war
14 * **Página de inicio y Desktop Studio:** adminconsole.war
15
16 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.
17
18 Para desplegar varios dominios, siga [[este enlace>>path:/xwiki/wiki/howtos/view/howtos/server/Domain_management/]].
19 )))
20
21 La instalación de DigDash Enterprise en un sistema Linux se puede hacer de dos maneras:
22
23 * usando el servidor de aplicación Tomcat proveído en el archivo de instalación DigDash Enterprise
24 * usando su propio servidor Tomcat o el servidor de aplicación compatible JEE.
25
26 Esta página describe como usar el servidor Tomcat proveído, y también la instalación con un otro Tomcat.
27
28 Para hacer la instalación en un sistema Windows, siga [[Guía de instalación de DigDash Enterprise en Windows.>>Guide d'installation de DigDash Enterprise sur Windows.]]
29
30 Para hacer la actualización de una instalación exístante, siga [[Guía de actualización DigDash Enterprise>>doc:Digdash.deployment.installation.upgrade_dde.WebHome]].
31
32 = Tomcat Proveído en la instalación DigDash Enterprise =
33
34 == Descompresión ==
35
36 * Descomprima el archivo **digdash_enterprise_2021R1_numpatch.zip** dentro del directorio deseado.(Aconsejamos de descomprimirlo en **/user/share/digdash_enterprise**).
37 ** 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.
38 * Compruebe que su carpeta de instalación contenga un archivo **version.txt**.
39 ** Es este archivo que indicara con certitud la versión del producto (sin deber encender el servidor).
40
41 == Propietarios y derechos ==
42
43 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:
44
45 {{code language="unix"}}
46 USER@domain:~# chown –R USER /usr/share/digdash_enterprise
47 USER@domain:~# chmod –R 755 /usr/share/digdash_enterprise
48 {{/code}}
49
50 == Indique donde se encuentra el archivo de configuración ==
51
52 El archivo ##**digdash.properties**## en el directorio de instalación le permite de configurar todo el entorno.
53
54 Para que sea usado de forma correcta para DigDash Enterprise, copie este archivo **##digdash.properties## **en el directorio ##**/etc/digdash**##.
55
56 (% class="box" %)
57 (((
58 Cuidado a las permisiones de acceso: aplique los mismos comandos que en el previo paso.
59 )))
60
61 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>>/xwiki/wiki/howtos/view/howtos/server/Domain_management/||anchor="HExternalisationdesparamE8tresdansleA0fichierdigdash.properties" target="_blank"]].
62
63 == Ubicación del directorio de sus datos ==
64
65 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>**##.
66
67 Por ejemplo, en Windows, este archivo es:
68 ##C:\Users\<usuario>\AppData\Roaming\Enterprise Server\ddenterpriseapi##
69
70 Es importante modificar este archivo para garantizar la accesibilidad (derechos en lectura, escritura, ejecución) y para supervisar el espacio de almacenamiento. 
71 Esta modificación es también interesante para razones de organización, de //scripting//, etc.
72
73 Existe varias maneras de modificar esta ubicación.
74
75 === Directorio común a todos los dominios ===
76
77 Archivo modificado: {{code language="text"}}digdash.properties{{/code}}
78
79 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).
80 (La secunda manera es a reservar en caso de necesidad específica).
81
82 La variable {{code language="text"}}digdash.appdata{{/code}} permite especificar el único directorio de los datos.
83 En el archivo {{code language="text"}}<DDE Install>/digdash.properties{{/code}} quita el simbol # delante de la línea {{code language="text"}} #digdash.appdata=c:/data {{/code}} para descomentar la línea :
84
85 {{code language="text"}}
86 digdash.appdata=/var/lib/digdash/appdata
87 {{/code}}
88
89 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.
90
91 * {{code language="text"}}<digdash.appdata>/Enterprise Server/<dominio>{{/code}}
92 * {{code language="text"}}<digdash.appdata>/Enterprise Administrator{{/code}}
93 * {{code language="text"}}<digdash.appdata>/ldapdigdash{{/code}}
94
95 **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.
96
97 **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.
98 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.
99
100 === Directorio diferente para cada dominio ===
101
102 (% id="cke_bm_275S" style="display:none" %) (%%)Archivo modificado: {{code language="text"}}digdash.properties{{/code}}
103
104 La variable {{code language="text"}}<dominio>.AppDataPath{{/code}}  definida en este archivo tiene el mismo comportamiento que la variable global descrita antes.
105 La diferencia es que esta configuración es específica por un dominio  DigDash Enterprise.
106
107 Para definir un directorio de los datos especifico a un dominio, modifica el parámetro  {{code language="text"}}AppDataPath{{/code}} prefijado por el nombre del dominio.
108
109 Si tiene un dominio {{code language="text"}}ddenterpriseapi_dev{{/code}}, la variable será a especificar así:
110
111 {{code language="text"}}
112 ddenterpriseapi_dev.AppDataPath=/var/lib/digdash/appdata_dev
113 {{/code}}
114
115 **Ventajas**:
116
117 * Configuración especifica a un dominio
118 * Archivo externo de los WAR
119
120 **Inconveniente**: Esta configuración se debe reproducir para cada dominio.
121
122 == Encender Tomcat ==
123
124 Con su usuario ##<USER>## ejecuta la comando para encender Tomcat :
125
126 {{code language="bash"}}
127 USER@domain:~# cd /usr/share/digdash_enterprise_20xxxx/apache-tomcat/bin/
128 USER@domain:~# sh startup.sh
129 {{/code}}
130
131 = Su propio servidor Tomcat como servicio =
132
133 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.
134
135 1. Instale Tomcat
136 1. Descargue y descomprima el archivo de instalación de DigDash Enterprise
137 1. Como usuario ##**root**##, ejecute la comando siguiente: {{code language="bash"}}mkdir /etc/digdash{{/code}}
138 1. En el directorio ##**/etc/digdash**##:
139 11. Copie el archivo ##**digdash.properties**##
140 11. Quite el **#** prefijando el parámetro ##digdash.appdata##, y dele el siguiente valor: {{code language="ini"}}digdash.appdata=/var/lib/digdash/appdata{{/code}}
141 1. Copie los archivos WAR ubicados en el directorio {{code language="text"}}<DDE Install>/apache-tomcat/webapps/{{/code}} hacia el directorio ##**webapps** ##de Tomcat (puede ser ##**/var/lib/tomcat8/webapps**##).
142 1. Tomcat debería extraer los WARs agregados de manera automática. Si no es el caso, re-encienda Tomcat (con el comando{{code language="bash"}}service tomcat8 restart{{/code}}).
143 1. (((
144 Como usuario ##**root**##, ejecuta los siguientes comandos:
145
146 {{code language="bash"}}
147 cd /var/lib
148 mkdir digdash
149 chown tomcat8:tomcat8 digdash
150 cd /var/log
151 mkdir digdash
152 chown tomcat8:tomcat8 digdash
153 {{/code}}
154 )))
155 1. En el archivo:{{code language="text"}}/etc/digdash/digdash.properties{{/code}}
156 1*. Active el parámetro {{code language="text"}}log4j.appender.R.File{{/code}} para cada aplicación (borre el **#** de los inicios de líneas).
157 1*. El valor predeterminado permite de tener un único archivo de log: {{code language="text"}}/var/log/digdash/ddenterpriseapi.log{{/code}}
158 Lo puede modificar para tener, según su necesidad, un archivo por aplicación.
159 Por ejemplo, es interesante de separar los logs de la aplicación del studio (studio.war)
160 {{code language="text"}}studio.log4j.appender.R.File=/var/log/digdash/studio.log{{/code}}
161 1. Re-encienda Tomcat (con el comando{{code language="bash"}}service tomcat8 restart{{/code}})
162
163 == Solución en caso de incidente ==
164
165 === "//Permission denied//" o "//Read-only system//" ===
166
167 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.
168
169 Para más información (en ingles): [[https:~~/~~/www.freedesktop.org/software/systemd/man/systemd.exec.html#Sandboxing>>https://www.freedesktop.org/software/systemd/man/systemd.exec.html#Sandboxing]]
170
171 Para solucionar estos problemas:
172
173 1. Encuentre el archivo {{code language="bash"}}tomcat8.service{{/code}}
174 1. Abra este archivo como usuario **root**
175 1. Asegúrese de que el campo {{code language="text"}}ProtectSystem{{/code}} exista
176 1. Añada {{code language="text"}}ReadWritePaths=/var/lib/digdash{{/code}} y {{code language="text"}}ReadWritePaths=/var/log/digdash{{/code}} si no existen ya
177 1. Guarde el archivo
178 1. Ejecute el siguiente comando como usuario **root** para recargar el archivo servicio: {{code language="bash"}}systemctl daemon-reload{{/code}}
179 1. Re-encienda Tomcat (con {{code language="bash"}}service tomcat8 restart{{/code}} o {{code language="bash"}}systemctl restart tomcat8.service{{/code}})