Última modificación por Aurelie Bertrand el 2025/02/07 10:18
Mostrar los últimos autores
1 {{ddtoc/}}
2
3 ----
4
5 (% class="box" %)
6 (((
7 A continuación, **<digdash.appdata>** se refiere a la ubicación que ha elegido para guardar los datos (fuentes, gráficos, formatos, ...).
8 Debe ingresarse en el archivo** digdash.properties** bajo el parámetro **digdash.appdata** o **ddenterpriseapi.AppDataPath** (consulte la Guía de instalación de Windows [[Guía de instalación de Windows>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||target="_blank"]] o la [[Guía de instalación de Linux>>doc:Digdash.deployment.installation.install_guide_linux.WebHome||target="_blank"]])
9 También puede verlo en la página "Estado del servidor" de las páginas de administración de su servidor (con el servidor encendido).
10 )))
11
12 (% class="box infomessage" %)
13 (((
14 __Vocabulario__
15
16 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:
17
18 * **Servidor**: ddenterpriseapi.war
19 * **Cuadro de mandos:** digdash_dashboard.war
20 * **Web Studio:** studio.war
21 * **Página de inicio y Desktop Studio:** adminconsole.war
22
23 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.
24
25 Para desplegar varios dominios, siga [[este enlace>>path:/xwiki/wiki/howtos/view/howtos/server/Domain_management/]].
26 )))
27
28 Este documento describe las configuraciones avanzadas de los parametros del servidor DigDash Enterprise (DDE).
29
30 Los siguientes archivos seran modificados:
31
32 * ##server.xml##
33 ** Ubicación (Tomcat global) :
34 <DDE Install>/apache-tomcat/conf/server.xml
35 * ##web.xml##
36 ** Ubicación (Tomcat global) :
37 <DDE Install>/apache-tomcat/conf/web.xml
38 * ##system.xml##
39 ** Ubicación :
40 **<digdash.appdata>**/Enterprise Server/ddenterpriseapi/config/**system.xml**
41 * ##digdash.properties##
42 ** Ubicación :
43 <DDE Install>/**digdash.properties**
44 o /etc/digdash/**digdash.properties** (en Linux)
45 o la ubicación personalizada que hubiera configurado.
46 * ##web.xml## (este metodo es obsoleto, use el archivo **digdash.properties**)
47 ** Ubicación (ddenterpriseapi) :
48 **<DDE Install>**/apache-tomcat/webapps/**ddenterpriseapi**/WEB-INF/**web.xml**
49 ** Ubicación (dashboard) :
50 **<DDE Install>**/apache-tomcat/webapps/**digdash_dashboard**/WEB-INF/**web.xml**
51 ** Ubicación (adminconsole) :
52 **<DDE Install>**/apache-tomcat/webapps/**adminconsole**/WEB-INF/**web.xml**
53 ** Ubicación (studio) :
54 **<DDE Install>**/apache-tomcat/webapps/**studio**/WEB-INF/**web.xml**
55 ** Ubicación (adswrapper) :
56 **<DDE Install>**/apache-tomcat/webapps/**adswrapper**/WEB-INF/**web.xml**
57 * ##setenv.bat## (//Windows//)
58 ** Ubicación : <DDE Install>/configure/**setenv.bat**
59 * ##setenv.sh ##(//Linux//)
60 ** Ubicación : <DDE Install>/apache-tomcat/bin/**setenv.sh**
61 * ##dashboard_system.xml##
62 ** Ubicación : **<digdash.appdata>**/Application Data/Enterprise Server/**dashboard_system.xml**
63
64 = Configuración Tomcat =
65
66 == Asignar más memoria a Tomcat ==
67
68 Archivo modificado: **setenv.bat** o**setenv.sh**
69
70 * En Windows: **setenv.bat** ubicado en el directorio **<install DD>/configure**.
71 * En Linux: **setenv.sh** ubicado en el directorio **<install DD>/apache-tomcat/bin**
72
73 Ubique las siguientes lineas al inicio del archivo:
74
75 {{code language="batch" cssClass="notranslate"}}
76 set JVMMS=512
77 set JVMMX=512
78 {{/code}}
79
80 Cambie las 2 apariciones de "512" por la cantidad de memoria (megabytes) que desea asignar a Tomcat. Por ejemplo, "4096" asignará 4 GB de memoria a Tomcat.
81
82 {{code language="batch" cssClass="notranslate"}}
83 set JVMMS=4096
84 set JVMMX=4096
85 {{/code}}
86
87 (% class="box errormessage" %)
88 (((
89 Importante: en Windows de 64 bits no hay otro límite que no sea la memoria física de su computadora. Si el valor es demasiado alto, Tomcat no se iniciará.
90 )))
91
92 (% class="box infomessage" %)
93 (((
94 //Nota para Windows de 32 bits: si tiene una configuración de 32 bits (máquina / SO), o si ha implementado la versión de 32 bits de DigDash Enterprise en su máquina de 64 bits, entonces está limitado en la cantidad de memoria puede asignar en Tomcat. Se sabe que el límite en este caso es de aproximadamente 1,5 GB. Depende en particular de la fragmentación de la memoria en este momento. Nuestras pruebas generalmente muestran que podemos asignar 1.4GB en Windows de 32 bits. Por esta razón, recomendamos una combinación de máquina / sistema operativo de 64 bits.//
95 )))
96
97 (% class="box errormessage" %)
98 (((
99 Importante: cuando instale Tomcat como un servicio de Windows (consulte la página de la [[Guía de instalación de Windows>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||anchor="HInstallationentantqueserviceWindows" target="_blank"]]), utilizando **servers_install_service.bat,** la configuración de **setenv.bat** se aplicará al instalar el servicio.
100
101 Entonces, si desea cambiar la memoria asignada a Tomcat, debe:
102
103 1. Cambie las variables JVMMS y JVMMX del archivo** setenv.bat**
104 1. Reinicie **servers_install_service.bat** (este script desinstalará el servicio antes de reinstalarlo con la nueva configuración)
105 )))
106
107 == Cambiar los puertos de red de Tomcat ==
108
109 Archivo modificado: **server.xml**
110
111 Si uno de los puertos que necesita Tomcat ya está siendo utilizado por otro proceso, no se iniciará. Es necesario verificar la disponibilidad de los puertos y si es necesario reconfigurar Tomcat. Por defecto, están configurados los siguientes 3 puertos: 8005, 8080 y 8009. Para modificarlos:
112
113 1. Abra el directorio **<install DDE>\apache-tomcat\conf** y luego edite el archivo **server.xml**
114 1. Busque y reemplace los valores de los puertos 8005, 8080 y 8009 con los números de puerto disponibles en el sistema
115
116 == Cambiar la duraciónde vida de las sesiones inactivas (//timeout//) ==
117
118 Archivo modificado: **web.xml** (configuración global de Tomcat ubicado en la ubicación **<DDE Install>/apache-tomcat/conf/web.xml**)
119
120 Busque las siguientes líneas en el archivo:
121
122 {{code language="xml" cssClass="notranslate"}}
123 <session-config>
124 <session-timeout>30</session-timeout>
125 </session-config>
126 {{/code}}
127
128 Cambie el valor para modificar la duración en minutos de una sesión inactiva (tiempo de espera). Por defecto, el tiempo de espera es de 30 minutos.
129
130 == Cambiar el número máximo de consultas simultáneas ==
131
132 Archivo modificado: **server.xml**
133
134 De forma predeterminada, Tomcat no aceptará más de 200 solicitudes **simultáneas**. Esta configuración puede resultar limitante en el caso de una implementación para una gran cantidad de usuarios (varios miles o millones), o durante un banco de rendimiento (por ejemplo, jmeter) que ejecuta cientos o miles de solicitudes simultáneas.
135
136 Para aumentar este límite, debe agregar un atributo **maxthreads **en el elemento **Conector **correspondiente al conector utilizado.
137
138 Ejemplo cuando el conector utilizado es http (no hay Apache en el front-end):
139
140 {{code language="xml" cssClass="notranslate"}}
141 <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" maxthreads="400" redirectPort="8443" maxPostSize="-1" URIEncoding="UTF-8" ></Connector>
142 {{/code}}
143
144 Ejemplo cuando el conector utilizado es AJP (hay un Apache en el front-end):
145
146 {{code language="xml" cssClass="notranslate"}}
147 <Connector port="8009" protocol="AJP/1.3" maxthreads="400" redirectPort="8443" maxPostSize="-1" URIEncoding="UTF-8" ></Connector>
148 {{/code}}
149
150 == Activar la compresión HTTP ==
151
152 Archivo modificado: **server.xml**
153
154 La compresión HTTP reduce el consumo de ancho de banda de la red al comprimir las respuestas HTTP. De forma predeterminada, esta opción no está habilitada en Tomcat, aunque todos los navegadores modernos la admiten.
155
156 Esta opción a veces puede ahorrar hasta un 90% de ancho de banda en ciertos tipos de archivos: HTML, Javascript, CSS. Consumiendo poca CPU en el servidor y el cliente.
157
158 (% class="box errormessage" %)
159 (((
160 Importante: esta opción solo funciona si Tomcat se utiliza directamente como servidor de aplicaciones para el usuario a través del conector HTTP / 1.1. Si hay un httpd de Apache de front-end, deberá activar la opción equivalente en el propio httpd de Apache (consulte la documentación directamente en el sitio httpd de Apache).
161 La compresión HTTP no es compatible con el conector AJP ni con ningún conector que no sea HTTP (S) /1.1.
162 )))
163
164 En el archivo **server.xml**, agregue los parámetros **compression="on"** y **compressionMinSize="40000"** en el conector HTTP/1.1:
165
166 Ejemplo :
167
168 {{code language="xml" cssClass="notranslate"}}
169 <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" maxPostSize="-1" URIEncoding="UTF-8" compression="on" compressionMinSize="40000"></Connector>
170 {{/code}}
171
172 El atributo **compressMinSize **define un tamaño de respuesta mínimo (en bytes) por debajo del cual no se utiliza la compresión. Le recomendamos que especifique este atributo a un valor suficiente para no comprimir archivos que ya son muy pequeños (iconos PNG, etc.).
173
174 (% class="box infomessage" %)
175 (((
176 Nota: esta configuración no tiene ningún efecto si un navegador que está utilizando no es compatible con la compresión HTTP. Tomcat decidirá entonces no comprimir las respuestas HTTP para este navegador.
177 )))
178
179 = Configuración avanzada de rendimiento =
180
181 Archivo modificado: **system.xml**
182
183 Ejemplo de sintaxis XML:
184
185 {{code language="xml" cssClass="notranslate"}}
186 <Property key="CORE_TP_EXECSIZE" value="64"></Property>
187 {{/code}}
188
189 == //Threads //utilizados para la ejecución de flujos programados ==
190
191 Modifica el número de subprocesos (//threads//) utilizados para la ejecución de flujos programados (planificador) o en evento.
192
193 Propriedades disponibles:
194
195 * //Nombre//: **MAX_TP_EXECSIZE**
196 * //Valor//: entero > 0 (por defecto: 16)
197 //Descripción//:  Número máximo de subprocesos para procesar tareas de sincronización.
198 * //Nombre// : **TP_SYNC_PRIORITY**
199 //Valor//: cadena de carácteres("flow" o "none") (por defecto: //flow//)
200 //Descripción//: Mode de priorité des tâches.
201 ** Valor //**flow **//:Procese la sincronización de la secuencia lo antes posible después de que se haya generado el cubo para esa secuencia.
202 ** Valor //**none **//: el flujo se sincronizará cuando haya espacio en la cola de subprocesos. Este parámetro solo se tiene en cuenta cuando el parámetro **TP_PRIORITYPOOL **se establece en //**true**//.
203 * //Nombre// : **TP_SYNC_GROUPFLOWBYCUBE**
204 //Valor//: booleano (por defecto : //false//)
205 //Descripción//: Cambia el modo de procesamiento de trabajos en espera.
206 ** Valor **false**: las tareas de procesamiento de flujo se distribuyen entre todos los subprocesos disponibles independientemente del cubo utilizado. Esto conduce a un procesamiento paralelo de los flujos en detrimento de los cubos, recomendado cuando hay pocos cubos pero muchos flujos.
207 ** Valor **true**: agrupa el procesamiento de flujos del mismo cubo en un solo //thread//. Esto conduce a un procesamiento paralelo de los cubos en detrimento de los flujos, recomendado cuando hay muchos cubos diferentes y pocos flujos utilizando los mismos cubos. Este parámetro solo se tiene en cuenta cuando el parámetro **TP_PRIORITYPOOL **es //**true**//.
208
209 == //Threads //utilizados para ejecutar flujos interactivos ==
210
211 Modifica el número de subprocesos (//threads)// utilizados para la ejecución interactiva de flujos (Studio, dashboard, móvil, etc.).
212
213 Propriedades disponibles:
214
215 * //Nombre//: **MAX_TP_PLAYSIZE**
216 //Valor//: entero > 0 (por defecto : 16)
217 //Descripción//: Número máximo de subprocesos para procesar tareas de sincronización.
218 * //Nombre//: **TP_PLAY_PRIORITY**
219 //Valor//: chaine ("flow" ou "none") (por defecto: flow)
220 //Descripción//: Mode de priorité des tâches.
221 ** Valor //**flow **//:Procese la sincronización de la secuencia lo antes posible después de que se haya generado el cubo para esa secuencia.
222 ** Valor //**none **//: el flujo se sincronizará cuando haya espacio en la cola de subprocesos. Este parámetro solo se tiene en cuenta cuando el parámetro **TP_PRIORITYPOOL **se establece en //**true**//.
223 * //Nombre//: **TP_PLAY_GROUPFLOWBYCUBE**
224 //Valor//: booleano (por defecto : //false//)
225 //Descripción//: Cambia el modo de procesamiento de trabajos en espera.
226 ** Valor **false**: las tareas de procesamiento de flujo se distribuyen entre todos los subprocesos disponibles independientemente del cubo utilizado. Esto conduce a un procesamiento paralelo de los flujos en detrimento de los cubos, recomendado cuando hay pocos cubos pero muchos flujos.
227 ** Valor **true**: agrupa el procesamiento de flujos del mismo cubo en un solo //thread//. Esto conduce a un procesamiento paralelo de los cubos en detrimento de los flujos, recomendado cuando hay muchos cubos diferentes y pocos flujos utilizando los mismos cubos. Este parámetro solo se tiene en cuenta cuando el parámetro **TP_PRIORITYPOOL **es //**true**//.
228
229 == Límites de tiempo para eliminar cubos en la memoria ==
230
231 Cambia la forma en que el Administrador de cubos elimina los cubos no utilizados en la memoria.
232
233 La siguiente configuración cambia la forma en que se eliminan los cubos que no se han utilizado durante algún tiempo, incluso si la sesión todavía está activa.
234
235 Propriedades disponibles:
236
237 * //Nombre//: **CUBE_TIMEOUT_INTERACTIVE**
238 //Valor//: minutos> 0 (por defecto: 10 minutos)
239 //Descripción//:Duración del período de inactividad de un cubo cargado en modo interactivo (navegación del cubo en el servidor)
240 * //Nombre//: **CUBE_TIMEOUT_SYNC**
241 //Valor//: minutos> 0 (por defecto: 4 minutos)
242 //Descripción//: Duración del período de inactividad de un cubo cargado en modo programado (generación de un flujo programado)
243 * //Nombre//: **CUBE_TIMEOUT_PERIOD**
244 //Valor//: minutos> 0 (por defecto: 2 minutos)
245 //Descripción//: El intervalo para comprobar la actividad del cubo debe ser al menos **CUBE_TIMEOUT_SYNC / 2**
246
247 == Rendimiento de los cubos de datos ==
248
249 Estos ajustes afectarán el procesamiento interactivo de cubos de datos (aplanamiento en cubos de resultados durante la visualización). Esta configuración no afecta la generación de cubos de datos.
250
251 Propriedades disponibles:
252
253 * //Nombre//: **CUBEPART_MAXSIZEMB**
254 //Valor//: megabytes > 0 (por defecto: 100 MB)
255 //Descripción//: Tamaño de un cubo compartido en megabytes. Una parte del cubo es una parte del cubo de datos que se puede procesar (aplanar) en paralelo o distribuir a otros servidores DigDash Enterprise en modo de clúster (consulte el capítulo "Uso de varios servidores en modo de clúster" en este documento).
256 * //Nombre//: **TP_MCUBESIZE**
257 //Valor//: threads > 0 (por defecto: 64 threads)
258 //Descripción//: Tamaño de la cola de subprocesos utilizada para el procesamiento paralelo de recursos compartidos de cubo. Los cubos grandes (por ejemplo, varios millones / billones de líneas) son procesados ​​en paralelo por el servidor y / o por otros servidores (en modo cluster). Este parámetro es el número de unidades de procesamiento en paralelo (subprocesos) en una máquina. Cada parte del cubo ocupa una unidad de la cola mientras se procesa, si la cola está llena, las unidades adicionales se ponen en espera.
259 * //Nombre//: **MCUBE_ROWS_PER_THREAD**
260 //Valor//: lignes > 0 (por defecto: 100000)
261 //Descripción//: Este es el límite del número de filas de un cubo de datos más allá del cual el servidor DigDash Enterprise activará el procesamiento paralelo de las partes del cubo (si hay más de una parte para este cubo). Por debajo de este límite, el procesamiento del cubo no es paralelo sino secuencial.
262
263 == Otros parámetros de rendimiento ==
264
265 Los siguientes parámetros se utilizan para analizar u optimizar el rendimiento del sistema.
266
267 Propriedades disponibles:
268
269 * //Nombre//: **LOW_MEMORY_THRESHOLD**
270 //Valor//: porcentaje> 0 (por defecto: 10%)
271 //Descripción//: Este es el umbral como porcentaje de memoria libre restante por debajo del cual el sistema emitirá una alerta de memoria baja. Esta alerta está visible en la página de estado del servidor durante 24 horas. También se registra en la base de datos DDAudit si se inicia el servicio de auditoría del sistema.
272 Por último, también se activa un evento DigDash cuando se alcanza el umbral: SYSCHECK_LOWMEM. Un ejemplo del uso de este evento se da en el documento de implementación del módulo DDAudit.
273 * //Nombre//: **TP_PRIORITYPOOL**
274 //Valor//: booleano (por defecto: //true//)
275 //Descripción//: Utiliza un grupo de subprocesos de actualización administrados por prioridad para actualizaciones de cubos y flujos. Ver los parámetros **TP_PLAY_GROUPFLOWBYCUBE, TP_SYNC_GROUPFLOWBYCUBE, TP_PLAY_GROUPFLOWBYCUBE, TP_SYNC_GROUPFLOWBYCUBE**
276
277 = Servicio de mantenimiento automático =
278
279 DigDash Enterprise proporciona un servicio de mantenimiento que consta de:
280
281 * Un limpiador de archivos (también llamado //Files GC//) que limpia todos los archivos no utilizados: archivos históricos antiguos, cubos y otros archivos dependientes de los flujos.
282 * Una generacion automatica de una copia de seguridad de la configuración
283
284 == Limpiador de archivos ==
285
286 El limpiador limpia los archivos no usados por las carteras de roles y de usuarios.
287
288 El limpiador analiza los índices de todos los usuarios, así como el disco, para encontrar archivos que ya no están vinculados a los índices. Los archivos identificados se eliminan. Los archivos eliminados son: archivos de cubos (.dcg), archivos js de cubos (cube_data_id.js), modelos (cube_dm_id.js) y flujos(cube_view_id_js).
289
290 Esta operación tiene la ventaja de liberar espacio en disco y potencialmente acelerar las búsquedas de archivos js, que pueden llegar a ser importantes en grandes volúmenes (número de cubos personales * número histórico> 100.000)
291
292 Dependiendo de la antigüedad del servidor y del tamaño de los archivos en cuestión (número de actualizaciones realizadas, etc.), la operación puede llevar mucho tiempo cuando se ejecuta por primera vez (en algunas implementaciones con muchos usuarios y muchos cubos, de una a dos horas).
293
294 Luego, si la limpieza se realiza de forma periódica, el tiempo de ejecución será menor. Este tiempo depende en gran medida del rendimiento del sistema de archivos y de la máquina, lo que dificulta la estimación.
295
296 == Copia de seguridad automatizada ==
297
298 Se realiza una copia de seguridad automática antes de limpiar los archivos. El archivo generado se copia en el directorio de configuración: **<digdash.appdata>/Enterprise Server/<dominio>/backups/<fecha del día>.zip**
299
300 Por defecto, el mantenemiento occure cada dia a la medianoche.
301
302 (% class="box errormessage" %)
303 (((
304 Importante: De forma predeterminada, el servicio de mantenimiento solo se inicia si no hay ninguna sesión de usuario activa en este momento. Además, durante su funcionamiento ningún usuario puede conectarse a DigDash Enterprise. Tenga cuidado de programarlo bien para que no interfiera con el uso normal de DigDash Enterprise por parte de los usuarios ni del programador. Dependiendo del caso, recomendamos programar el servicio de mantenimiento por la noche, y en diferentes franjas horarias de las franjas horarias del planificador.
305 )))
306
307 == Activación, desactivación y / o limpieza en el arranque ==
308
309 Este párrafo describe cómo activar y programar el servicio de mantenimiento.
310
311 La activación del limpiador de archivos se puede realizar de dos formas:
312
313 === 1- //Desde la página del estado del servidor//: ===
314
315 La página **Estado del servidor** se puede consultar desde la página de inicio de DigDash Enterprise, haciendo clic sucesivamente en los botones **Configuración** y **Estado del servidor**.
316
317 En la seccion //**Estado del limpiador de archivos**//, haga clic en la flecha verde al lado de **Limpiador de archivos iniciados** para iniciar el limpiador:
318
319 [[image:1625477392222-591.png]]
320 La próxima limpieza se realizará a medianoche. Para iniciar el limpiador de archivos de inmediato, haga clic en el icono[[image:1599031692012-960.png]].
321
322 === 2- //Desde el archivo digdash.properties// : ===
323
324 Archivo modificado: **digdash.properties**
325
326 Consulte el capítulo [[Externalización de parámetros en un archivo //digdash.properties//>>||anchor="HExternalizaciF3ndeparE1metrosenunarchivodigdash.properties"]] para realizar esta manipulación.
327
328 Propriedades disponibles:
329
330 * //Nombre//: **ddenterpriseapi.startCleaner**
331 //Valor//: booleano (por defecto: //false//)
332 //Descripción//:
333 ** **//true //**: limpieza automática de archivos programada.
334 //Nota: el tiempo de limpieza se define en **system.xml**, mediante el parámetro **FILESGC_SCHEDXML**.
335 El tiempo de limpieza predeterminado (si no se especifica ninguno en system.xml, FILESGC_SCHEDXML) es diario a las 0:00//
336 ** **//false //**(por defecto) : limpieza automática de archivos desactivada
337 * //Nombre//: **ddenterpriseapi.cleanOnStart**
338 //Valor//: booleano (por defecto: false)
339 //Descripción//:
340 ** **//true //**: limpia los archivos no utilizados cuando se inicia el servidor (archivos de historial, cubos, archivos de resultados, ...)
341 ** **//false //**(por defecto) : no limpia los archivos no utilizados cuando se inicia el servidor
342 * //Nombre//: **ddenterpriseapi.autoBackup**
343 //Valor//: booleano (por defecto: false)
344 //Descripción//:
345 ** ***. //true// : activa la copia de seguridad automática programada**
346 ** **//false//** (por defecto) : no activa la copia de seguridad automática programada
347
348 (% class="box warningmessage" %)
349 (((
350 En el archivo **digdash.properties**, todos los parámetros tienen como prefijo el nombre de la aplicación en cuestión.
351 Aquí, por defecto, es ddenterpriseapi (ddenterpriseapi.war).
352 Si ha cambiado el nombre de esta aplicación, por ejemplo en **ddapi_dev.war**, los parámetros se deben convertir en **ddapi_dev.startCleaner**, **ddapi_dev.cleanOnStart**, ...
353 )))
354
355 == Programación y opciones de mantenimiento automático ==
356
357 Archivo modificado: **system.xml**.
358
359 Propriedades disponibles:
360
361 * //Nombre//: **FILESGC_SCHEDXML**
362 //Valor//: frase XML (codificada) (por defecto : ninguna)
363 //Descripción//: Este parámetro contiene una frase codificada en XML que describe la frecuencia de programación.
364
365 Ejemplo:
366
367 {{code language="xml" cssClass="notranslate"}}
368 <Property key="FILESGC_SCHEDXML"
369 value="&lt;Schedule frequency=&quot;daily&quot;
370 fromDay=&quot;11&quot; fromHour=&quot;0&quot;
371 fromMinute=&quot;0&quot; fromMonth=&quot;7&quot;
372 fromYear=&quot;2011&quot; periods=&quot;1&quot;
373 time=&quot;0:0&quot;/&gt;"></Property>
374 {{/code}}
375
376 {{info}}
377 Los atributos interesantes son:
378
379 * **frequency** (**hourly**, **daily** o **monthly**),
380 * **periods** (número de horas, días o meses entre dos operaciones de limpieza)
381 * **time** (horario de la operación de limpieza para las frecuencias //daily// y //monthly//)
382 * Este ejemplo significa que la operación de limpieza se pasara todos los dias(frequency="daily" y periods="1") a la medianoche (time="0:0")
383 {{/info}}
384
385 * //Nombre//: **FILESGC_SESSIONSCHECK**
386 //Valor//: true/false (booleano) (por defecto: ninguna, vale //false//)
387 //Descripción//: Este parámetro indica si el limpiador de archivos debe comprobar si hay sesiones activas antes de iniciar (//true//) o si se inicia independientemente del estado de las sesiones activas (//false//). En el último caso, todas las sesiones se desconectarán instantáneamente.
388
389 Ejemplo:
390
391 {{code language="xml" cssClass="notranslate"}}
392 <Property key="FILESGC_SESSIONSCHECK" value="false"></Property>
393 {{/code}}
394
395 * //Nombre//: **USEAUTOBACKUP**
396 //Valor//: true/false (booleano) (por defecto: ninguna, vale //false//)
397 //Descripción//: Esta configuración especifica si el serivio de mantenimiento también realiza una copia de seguridad completa de la configuración antes de ejecutar la limpieza de archivos.
398
399 = Uso de varios servidores en modo "Cluster" =
400
401 Para gestionar un mayor volumen de datos (mil millones de líneas), es posible utilizar varios servidores en modo "Cluster". Cada servidor se convierte en un nodo informático del clúster.
402 Este último incluye un servidor maestro y servidores esclavos.
403
404 El servidor maestro se encarga de administrar modelos, documentos, roles, usuarios, sesiones y generar cubos y flujos (actualización). Idéntico a un servidor de Digdash Enterprise en el modo estándar de una sola máquina.
405 Los servidores esclavos adicionales solo se utilizan para ayudar en el aplanamiento interactivo de grandes cubos de datos, al mostrar flujos, filtrar, etc.
406
407 Hay dos arquitecturas de agrupación en clústeres en DigDash Enterprise:
408
409 * Agrupación interna: descrita en este capítulo
410 * Clúster de Apache Ignite: [[Módulo de clúster de Apache Ignite>>doc:Digdash.deployment.configuration.advanced_system_guide.Server_cluster_mode.ignite_cluster_guide.WebHome]]
411
412 == Instalar DigDash Enterprise en modo "Cluster" ==
413
414 Requisito: varias máquinas conectadas entre sí por la red
415
416 === Servidor maestro (en la máquina más potente del clúster) ===
417
418 1. Instalación estándar de DigDash Enterprise (consulte la [[Guía de instalación de Windows>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||target="_blank"]] o el [[Guía de instalación de Linux>>doc:Digdash.deployment.installation.install_guide_linux.WebHome||target="_blank"]]).
419 1. Iniciar el servidor normalmente con **start_servers.bat**
420
421 === Servidor esclavo (en cada una de las otras máquinas del clúster) ===
422
423 1. Instalación estándar de DigDash Enterprise (consulte la [[Guía de instalación de Windows>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||target="_blank"]] o el [[Guía de instalación de Linux>>doc:Digdash.deployment.installation.install_guide_linux.WebHome||target="_blank"]]).La diferencia es que un servidor esclavo no necesita una licencia para servir como unidad de computación para el clúster, ni un directorio LDAP, ni la aplicación digdash_dasboard cuya el war se puede eliminar de Tomcat.
424 1. Iniciar solo el módulo Tomcat, con **start_tomcat.bat** o **apache_tomcat/bin/startup.sh**
425
426 == Configurar el clúster ==
427
428 Procedimiento para repetir en cada servidor del clúster
429
430 1. Con un navegador, conéctese a la página de inicio de DigDash Enterprise (ejemplo: http:~/~/<servidor>:8080)
431 1. Haga clic en **Configuración**, y luego en **Parámetros servidor**
432 1. Inicie sesión como administrador de DigDash Enterprise (admin / admin de forma predeterminada) para mostrar la página de configuración del servidor
433 1. En el menu a la izquierda, haga clic en **Configuración del clúster**
434 1. Ingrese los diferentes campos en función de cada máquina del servidor (ver explicaciones a continuación)
435
436 === Sección Rendimiento del sistema ===
437
438 [[image:1625491286175-483.png]]
439
440 La sección **Rendimiento del sistema** define las capacidades de la máquina actual en el clúster. Los parámetros **Número de CPU**, **Puntuación de CPU** y **Memoria asignada** permiten distribuir la carga de cálculo de la mejor manera posible.
441
442 1. **Número de CPU**: el número de procesadores * número de núcleos en cada procesador. Potencialmente multiplicado por un factor si los procesadores se benefician de la tecnología Hyper-Threading. Predeterminado -1, se basa en los datos devueltos por el sistema operativo
443 1. **Puntuación CPU**: es una puntuación entre 1 y 10 que permite poner el rendimiento de un nodo del clúster en relación con los demás (caso de un clúster heterogéneo). Por defecto, -1 da una calificación promedio (5).
444 1. **Memoria asignada**: la fracción de la memoria máxima permitida cuando se usa el servidor como unidad de cálculo. Este valor es menor o igual que la memoria asignada al servidor Tomcat. El valor predeterminado -1 permite el uso de  toda la memoria.
445
446 === Sección Clústeres autorizados ===
447
448 === ===
449
450 [[image:1625491296920-557.png]]
451
452 La sección **Clústeres autorizados** le permite especificar si la máquina actual se puede utilizar como esclava de uno o más clústeres y, de ser así, cuáles. De hecho, una máquina se puede utilizar para varios clústeres de DigDash Enterprise. Esta sección restringe este uso como esclavo a solo ciertos grupos (lista de selección),
453
454 También es en esta sección que definimos la **Contraseña **del servidor actual en el clúster seleccionado. Sin una contraseña, el servidor no puede ser esclavo en este clúster.
455
456 Para agregar un clúster autorizado para usar este servidor esclavo:
457
458 1. **Nombre**: nombre del clúster (arbitrario)
459 1. **Dirección IP del servidor maestro**: dirección IP del servidor maestro del clúster autorizado para usar este servidor como esclavo (por ejemplo: http:~/~/192.168.1.1)
460 1. **Contraseña**: contraseña de esclavo en el contexto del clúster seleccionado
461 1. Haga clic en el botón **Añadir **para agregar este clúster a la lista de clústeres autorizados
462
463 (% class="box infomessage" %)
464 (((
465 Nota : Puede editar o eliminar clústeres autorizados seleccionándolos en la lista de selección y luego haciendo clic en los botones **Cambiar **o **Eliminar**.
466 )))
467
468 === Sección Definición del clúster ===
469
470 === ===
471
472 Para completar** solo en el servidor maestro del clúster**
473
474 [[image:1625491325352-651.png]]
475
476 La sección//** **//**Definición de clúster** //solo se aplica al servidor maestro del clúster//. Aquí es donde creamos un clúster enumerando los servidores esclavos del clúster, así como el maestro en sí (en la lista de selección). El servidor maestro es implícitamente el servidor a través del cual se conectó a esta página.
477
478 Para agregar una máquina esclava al clúster:
479
480 1. **Nombre**: nombre de la máquina esclava (arbitrario)
481 1. **URL del servidor**: URL del servidor esclavo (por ejemplo: http:~/~/192.168.1.123:8080)
482 1. **Dominio**: dominio de DigDash Enterprise (por defecto ddenterpriseapi)
483 1. **Contraseña**: contraseña del esclavo como la escribió anteriormente al configurar la máquina esclava (sección **Clústeres autorizados**, campo **Contraseña**)
484 1. Haga clic en el botón **Añadir **para agregar esta máquina a su clúster.
485
486 (% class="box infomessage" %)
487 (((
488 Nota : Puede editar o eliminar las maquinas del clúster seleccionándolas en la lista de selección y luego haciendo clic en los botones **Cambiar **o **Eliminar**.
489 )))
490
491 === Utilisation de plusieurs maîtres dans un cluster ===
492
493 Algunas implementaciones requieren el uso de varios servidores maestros dentro de un solo "clúster". Por ejemplo, en el caso de un balanceador de carga HTTP que envía sesiones de usuario a uno o otro servidor maestro. Este modo es compatible con DigDash mediante la definición de varios clústeres idénticos (uno por servidor maestra). La lista de los servidores (sección de definición de clúster) debe ser estrictamente idéntica para todas las definiciones de clúster. Por eso es posible cambiar el orden de los servidores en esta lista.
494
495 Ejemplo: Queremos definir un clúster que consta de dos servidores A y B. Cada una de las dos máquinas es maestra y esclava de la otra.
496
497 Debemos definir no uno, sino dos clústerse A y B:
498
499 En la definición del cluster A :
500
501 1. Servidor actual : Servidor A (maestro de este clúster)
502 1. Servidor B (esclavo de este clúster)
503
504 En la definición del cluster B :
505
506 1. Servidor A (esclavo de este clúster)
507 1. Servidor actual: Servidor B (maestro de este clúster)
508
509 Vemos que en el clúster B, el maestro (B) no es el primer servidor de la lista. Lo importante aquí es que la lista de los servidores A, el servidor B es de hecho el mismo en ambos clústeres (independientemente de su función específica dentro de su respectivo clúster).
510
511 == Configuración avanzada específica del clúster ==
512
513 Archivo modificado: **system.xml**
514
515 Ejemplo de sintaxis XML:
516
517 {{code language="xml" cssClass="notranslate"}}
518 <Property key="CLUSTER_TIMEOUT" value="45000"></Property>
519 {{/code}}
520
521 Propriedades disponibles:
522
523 * //Nombre//: **CUBE_UPLOAD_MODE**
524 //Valor//: entero: 0, 1 ou 2 (por defecto: 1)
525 //Descripción//: Especifica si los recursos compartidos del cubo deben descargarse del servidor maestro a los servidores esclavos cuando un usuario interactúa con el cubo (1), cuando el servidor maestro genera el cubo (2) o nunca (0);
526 Ver también el próximo capítulo : "//Uso del clúste//r".
527 * //Nombre//: **CLUSTER_TIMEOUT**
528 //Valor//: entero: (milisegundos, por defecto: 30000)
529 //Descripción//: Especifica el tiempo de espera para todas las solicitudes dentro del clúster (entre el maestro y los esclavos), con la excepción de la solicitud para verificar la disponibilidad de un esclavo (ver más abajo)
530 * //Nombre//: **CLUSTER_CHECK_TIMEOUT**
531 //Valor//: entero: (milisegundos, por defecto: 5000)
532 //Descripción//: Especifica el tiempo de espera para la solicitud de verificación de disponibilidad del esclavo. Este tiempo de espera es más corto para evitar bloquear el maestro durante demasiado tiempo en caso de que un esclavo se desconecte de la red.
533
534 == Uso del clúster ==
535
536 En una implementación de clúster simple, no hay nada más que hacer que lo que se ha escrito anteriormente.
537
538 Aun así, existen algunos detalles interesantes que pueden ayudar a mejorar el rendimiento de un clúster.
539
540 El clúster se utiliza según el tamaño del cubo de datos. Por debajo de cierto umbral, según el cubo, el servidor maestro y los esclavos, es posible que no se utilice el clúster. Por otro lado, si el tamaño de uno o más cubos de datos se vuelve grande, por ejemplo más allá de varios cientos de millones de líneas, estos se cortarán en varias partes y su cálculo (aplanamiento) se distribuirá en paralelo en todos los procesadores. disponible en el clúster para disminuir el tiempo de respuesta general. Y esto por cada aplanamiento de un cubo grande por parte de un usuario del tablero, móvil, etc.
541
542 Cabe señalar que la generación de cubos es responsabilidad del servidor maestro. Los esclavos intervienen solo durante el aplanamiento interactivo de cubos ya generados (ej: visualización de un flujo, filtrado, taladrado ...)
543
544 Las piezas del cubo se envían a los esclavos a pedido (si aún no las tienen). Esto puede provocar una ralentización del sistema en un primer aplanamiento solicitado por un usuario, en particular si el ancho de banda de la red es bajo (<1 gigabit).
545
546 Sin embargo, existen diferentes formas de evitar esta congestión de la red. Aquí hay algunas sugerencias:
547
548 Una primera forma es tener la carpeta de cubos (subcarpeta de Application Data / Enterprise Server / ddenterpriseapi por defecto) en un disco de red accesible para todos los servidores del clúster. Por ejemplo, a través de un enlace simbólico (Linux, NFS). Este vínculo debe establecerse para todos los servidores del clúster. El principio es que el servidor maestro generará los cubos en esta carpeta de red, y cuando un usuario interactúa con el sistema, el maestro y los esclavos tendrán una vista común de los cubos. Dado que los cubos del disco se leen solo una vez en el ciclo de vida de un cubo (cubo en memoria), el impacto de la carpeta de red en el rendimiento es insignificante.
549
550 Otra forma es utilizar una herramienta de terceros para la sincronización automática de carpetas entre varios servidores, que podrá copiar toda la carpeta de cubos del servidor, después de su generación, a los servidores esclavos. El principio es que el servidor maestro generará los cubos en su carpeta local, luego la herramienta de sincronización copiará esta carpeta a todos los servidores esclavos. Todo ello fuera de los periodos de actividad del servidor. El maestro y los esclavos tendrán una vista idéntica de los cubos.
551
552 = Otras configuraciones avanzadas =
553
554 == Cambiar la ruta de los archivos de datos ==
555
556 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>**##.
557
558 Por ejemplo, en Windows, este archivo es:
559 ##C:\Users\<usuario>\AppData\Roaming\Enterprise Server\ddenterpriseapi##
560
561 Es importante modificar este archivo para garantizar la accesibilidad (derechos en lectura, escritura, ejecución) y para supervisar el espacio de almacenamiento. 
562 Esta modificación es también interesante para razones de organización, de //scripting//, etc.
563
564 Para mas detalles, consulte la [[Guía de instalación de Windows>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||target="_blank"]] o el [[Guía de instalación de Linux>>doc:Digdash.deployment.installation.install_guide_linux.WebHome||target="_blank"]].
565
566 == Configuración de LDAP (adswrapper): puerto y directorio de datos ==
567
568 Archivo modificado: **digdash.properties**
569
570 Consulte el capítulo [[Externalización de parámetros en un archivo //digdash.properties//>>||anchor="HExternalizaciF3ndeparE1metrosenunarchivodigdash.properties"]] para realizar esta manipulación.
571
572 El parámetro **<nombre del archivo war >.ads.ldap.port **(valor predeterminado: **11389**) define el puerto de red utilizado por el servidor LDAP integrado en DigDash Enterprise.
573 Este valor debe cambiarse si ya lo está utilizando otro proceso en la máquina u otra instancia LDAP (de otro dominio DigDash en la misma máquina, por ejemplo).
574
575 Ejemplo: si la aplicación se llama adswrapper (adswrapper.war):
576
577 * {{code language="text" cssClass="notranslate"}}adswrapper.ads.ldap.port = 11590{{/code}}
578
579 Para cambiar la ubicación para escribir datos en el directorio LDAP, consulte la [[Guía de instalación de Windows>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||target="_blank"]] o el [[Guía de instalación de Linux>>doc:Digdash.deployment.installation.install_guide_linux.WebHome||target="_blank"]].
580
581 == {{id name="param_adv_dashboard"/}}Configuración avanzada del editor y de la consultación de cuadros de mandos ==
582
583 Archivo modificado: **digdash.properties**
584
585 Consulte el capítulo [[Externalización de parámetros en un archivo //digdash.properties//>>||anchor="HExternalizaciF3ndeparE1metrosenunarchivodigdash.properties"]] para realizar esta manipulación.
586
587 Propriedades disponibles:
588
589 * //Nombre//: **SERVERURL**
590 //Valor//: URL del servidor DigDash Enteprise
591 //Descripción//: URL del servidor al que se debe conectar en prioridad el cuadro de mando.
592 * //Nombre//: **DOMAIN**
593 //Valor//: Nombre del dominio DigDash Enterprise
594 //Descripción//: Nombre del dominio al que debe conectarse en prioridad el cuadro de mando.
595 * //Nombre//: **FORCESERVERURL**
596 //Valor//: booleano (por defecto: false)
597 //Descripción//: Se utiliza con el parámetro **SERVERURL**. Fuerza el servidor al que se conecta el tablero. El usuario no puede elegir otro servidor.
598 * //Nombre//: **FORCEDOMAIN**
599 //Valor//: booleano (por defecto: false)
600 //Descripción//: Usado con el parámetro **DOMAIN**. Fuerza el dominio al que se conecta el panel. El usuario no puede elegir otro dominio.
601 * //Nombre//: **GRIDSIZEEDITOR**
602 //Valor//: entero (por defecto: 10)
603 //Descripción//: Tamaño en píxeles de la cuadrícula magnética del editor de cuadros de mando.
604 * //Nombre//: **THEME**
605 //Valor//: Nombre del tema (por defecto: vacío)
606 //Descripción//: Nombre del tema predeterminado utilizado para usuarios que no tienen un tema específico especificado.
607
608 * //Nombre//: **urlLogout**
609 //Valor//: URL
610 //Descripción //: Especifica una URL de salida a la que se redirige al usuario después de cerrar la sesión del cuadro de mando. Consulte el párrafo [[Redirección al desconectarse del cuadro de mando>>||anchor="HRedirecciF3naldesconectarsedelcuadrodemando"]].
611 * //Nombre//: **CANCHANGEPASSWORD**
612 //Valor//: booleano (por defecto: false)
613 //Descripción//: Permite la activación de un enlace "Contraseña perdida" en la página de inicio de sesión del cuadro de mando. Este enlace envía un código de restablecimiento por correo electrónico al usuario. Ver párrafo [[Activación de la función de restablecimiento de contraseña>>||anchor="HActivaciF3ndelafunciF3nderestablecimientodecontraseF1a"]]
614
615 Ejemplo de contenido parcial del archivo **digdash.properties** :
616
617 {{code language="properties" cssClass="notranslate"}}
618 digdash_dashboard.SERVERURL=http://localhost:8080
619 digdash_dashboard.FORCESERVERURL=true
620 digdash_dashboard.DOMAIN=ddenterpriseapi
621 digdash_dashboard.FORCEDOMAIN=true
622 digdash_dashboard.GRIDSIZEEDITOR=15
623 digdash_dashboard.THEME=Flat
624 digdash_dashboard.urlLogout=disconnected.html
625 digdash_dashboard.CANCHANGEPASSWORD=true
626 {{/code}}
627
628
629 === Redirección al desconectarse del cuadro de mando ===
630
631 Archivo modificado: **digdash.properties**
632
633 Puede especificar una URL que se mostrará en el navegador cuando el usuario cierre sesión en el panel.
634
635 Cambie el valor del parámetro **urlLogout **como en el siguiente ejemplo. De forma predeterminada, el valor está vacío, lo que significa un regreso a la página de autenticación del panel.
636 Se permiten URL relativas, desde la URL index.html de la aplicación digdash_dashboard:
637
638 {{code language="properties" cssClass="notranslate"}}
639 digdash_dashboard.urlLogout=disconnected.html
640 {{/code}}
641
642
643 === Activación de la función de restablecimiento de contraseña ===
644
645 Archivo modificado: **digdash.properties**
646
647 Puede activar la función de restablecimiento de la contraseña perdida.
648 Esta función muestra un enlace "**Contraseña olvidada**" en la página de inicio de sesión del cuadro de mando que envía al usuario un correo electrónico que contiene un código de restablecimiento de contraseña.
649 Luego, el usuario es redirigido a una interfaz de reinicio para ingresar este código y una nueva contraseña.
650
651 Prerrequisito en el servidor DigDash :
652
653 * La funcionalidad también debe activarse a través de **Configuración de servidores** / **Parámetros adicionales... **/ **Varios **/ **Habilitar el restablecimiento de contraseña**
654 * Se debe configurar un servidor de correo electrónico válido en la página **Configuración de servidores** / **Correo electrónico y SMS...** / **Servidor de correo**
655 * Los usuarios deben tener una dirección de correo electrónico válida en el campo LDAP **digdashMail**
656
657 La función en el lado del tablero se activa pasando la variable **CANCHANGEPASSWORD **al valor **true **(ver capítulo [[Configuración avanzada del editor y de la consultación de cuadros de mandos>>||anchor="HConfiguraciF3navanzadadeleditorydelaconsultaciF3ndecuadrosdemandos"]])
658
659 {{code language="properties" cssClass="notranslate"}}
660 digdash_dashboard.CANCHANGEPASSWORD=true
661 {{/code}}
662
663
664 __Opcional: personalización del correo electrónico del código de restablecimiento__
665
666 El asunto y el cuerpo del correo electrónico con el código de restablecimiento se pueden personalizar de la siguiente manera:
667
668 1. Inicie el Web Studio
669 1. Abre el gestor de traduccionnes: **Gestor de diccionarios**
670 [[image:1625482832542-178.png]]
671 1. Haga clic derecho en la categoria **Global** y haga clic en **Agregar...**
672 [[image:1625482938077-196.png]]
673 Nombre de la clave : **LostPasswordMailSubject**
674 [[image:1625482988798-118.png]]
675 1. Saisir le sujet de l’émail dans les langues qui vous intéressent.
676 [[image:1625483067814-837.png]]
677 1. De nuevo, Haga clic derecho en la categoria **Global** y haga clic en **Agregar...**
678 1. Nombre de la clave : **LostPasswordMailText**
679 1. Ingrese el cuerpo del correo electrónico en los idiomas que le interese. Tenga en cuenta que el cuerpo del correo electrónico debe contener al menos la palabra clave **${code}**, que será reemplazada por el código de restablecimiento. Otra palabra clave disponible para sustitución es** ${user}**.
680 [[image:1625483225715-271.png]]
681
682 (% class="box warningmessage" %)
683 (((
684 No recomendamos dar demasiada información en este correo electrónico. Por eso, en el mensaje predeterminado solo indicamos el código de reinicio.
685 )))
686
687 __Configuración avanzada específica de la función de restablecimiento de contraseña__
688
689 Archivo modificado: **system.xml**
690
691 Ejemplo de sintaxis XML:
692
693 {{code language="xml" cssClass="notranslate"}}
694 <Property key="PROP_RESET_PASS_HASH" value="dfrj65433lkloss!00"></Property>
695 {{/code}}
696
697 Propriedades disponibles:
698
699 * //Nombre//: **PROP_RESET_PASS_HASH**
700 //Valor//: cadena de caracteres no vacía (por defecto: aléatoire)
701 //Description// : Especifica el código que se utilizará para generar el código de restablecimiento de contraseña. De forma predeterminada, esta cadena es aleatoria y se genera cuando se inicia el servidor. Puede especificar una cadena de caracteres que será utilizada por el algoritmo de generación de código de restablecimiento. Esto puede resultar útil si tiene varios servidores (equilibrio de carga HTTP) y si un código generado en un servidor se puede utilizar en otro.
702 * //Nombre//: **PROP_RESET_PASS_VALIDITY**
703 //Valor//: entero positivo (por defecto: 1)
704 //Description// : Especifica el período mínimo de validez del código en incrementos de 10 minutos. Un valor de 1 da al código una validez entre 10 y 20 minutos, un valor de 2 entre 20 y 30 minutos, etc. La validez es importante para minimizar el riesgo de robo de códigos a posteriori.
705 * //Nombre//: **PROP_RESET_PASS_LENGTH**
706 //Valor//: entero positivo (por defecto: 10)
707 //Description// : Especifica la longitud del código de reinicio. Un valor demasiado bajo está sujeto a intentos de ataques de fuerza bruta. Un valor demasiado grande está sujeto a errores de entrada del usuario.
708
709 == Configuración de seguridad interna ==
710
711 Es posible configurar los mecanismos de protección integrados en DigDash. Puede consultar la manera de configurarlos en la página [[Configuración de seguridad avanzada>>doc:Digdash.deployment.security.advanced_security_settings.WebHome]].
712
713 == {{id name="externalisation"/}}{{id name="externalisation"/}}Externalización de parámetros en un archivo //digdash.properties// ==
714
715 Todos los parámetros de la aplicación (archivos .war) de DigDash Enterprise son personalizables en un solo archivo de texto en formato [[**properties**>>https://en.wikipedia.org/wiki/.properties]].
716
717 (% class="box infomessage" %)
718 (((
719 Esto permite preconfigurar la configuración de la aplicación web incluso antes del primer inicio.
720 Aún más importante, permite simplificar la actualización de las aplicaciones web de DigDash Enterprise (sin perder la configuración).
721 )))
722
723 El archivo **digdash.properties** se entrega a la raíz del **directorio de instalación**.
724 Todos los parámetros están presentes pero desactivados.
725 Para activarlos, elimine el carácter **#** al principio de la línea.
726 Los parámetros siempre van **prefijados del nombre de la aplicación en cuestión **(por ejemplo: ddenterpriseapi para los parámetros de la aplicación ddenterpriseapi.war).
727
728 (% class="box infomessage" %)
729 (((
730 Ejemplo: si busca el parámetro **authMethod** del servidor (**ddenterpriseapi.war**) se encontrara como **ddenterpriseapi.authMethod.**
731 )))
732
733
734 (% class="box errormessage" %)
735 (((
736 Importante : Utilice el carácter de barra "/" o doble el carácter de barra invertida "\" en el archivo digdash.properties.
737 Ejemplo: ddenterpriseapi.//AppDataPath=C:/path/to/digdash_data
738 o//
739 ddenterpriseapi.//AppDataPath=C:~\~\path~\~\to~\~\digdash_data//
740 )))
741
742 Para que el archivo **digdash.properties** se tenga en cuenta con certeza, se debe especificar su ubicación al iniciar el servidor (Tomcat).
743
744 * En Windows con el servidor Tomcat previsto, no es necesaria ninguna intervención: el archivo setenv.bat ya está configurado para apuntar al archivo en la raíz de la instalación
745 * En Linux con el servidor Tomcat previsto, copie el archivo **digdash.properties** en la carpeta **/etc/digdash**
746 * Con su propio servidor Tomcat, deberá editar el archivo **setenv.bat** o **setenv.sh** para especificar la ubicación de su archivo **digdash.properties**.
747
748 Consulte la [[Guía de instalación de Windows>>doc:Digdash.deployment.installation.install_guide_windows.WebHome||target="_blank"]] o la [[Guía de instalación de Linux>>doc:Digdash.deployment.installation.install_guide_linux.WebHome||target="_blank"]]
749
750 === Prioridad entre los niveles de configuración ===
751
752 Los parámetros se leen en el siguiente orden (tan pronto como se encuentra un valor, se ignoran los siguientes niveles):
753
754 1. Parámetro en el comando de inicio del servidor Tomcat({{code language="text" cssClass="notranslate"}}-D<context>.<Parameter>=<value>{{/code}})
755 1. Archivo .properties especificado en la línea de comandos del servidor Tomcat ({{code language="text" cssClass="notranslate"}}-D<context>.properties.path=/the/path/to/<context>.properties{{/code}})
756 1. Archivo .properties encontrado en la carpeta de trabajo del servidor Tomcat ({{code language="text" cssClass="notranslate"}}<tomcat workdir>/<context>.properties{{/code}})
757 1. Parámetro global en la línea de comandos del servidor Tomcat ({{code language="text" cssClass="notranslate"}}-D<Parameter>=<value>{{/code}})
758 1. Archivo web.xml para cada aplicación({{code language="text" cssClass="notranslate"}}<context>/WEB-INF/web.xml{{/code}})
759
760 == Especificar los parámetros de registro (//logging//) log4j.properties ==
761
762 Los parámetros de registro (o de //logging//) se definen en un archivo **log4j.properties** disponible en cada aplicación web implementada.
763
764 Varias opciones en la línea de comando de Tomcat han sido agregadas para permitir especificar archivos de configuración de registro (o de //logging//) externalizados:
765
766 {{code language="properties" cssClass="notranslate"}}
767 -Dddenterpriseapi.ddlog4j.properties.path="/path/to/log4j.properties"
768 -Ddigdash_dashboard.ddlog4j.properties.path="/path/to/log4j.properties"
769 -Dadswrapper.ddlog4j.properties.path="/path/to/log4j.properties"
770 {{/code}}
771
772 También puede especificar la ubicación del archivo de registro (global) sin necesidad de especificar un archivo log4j.properties:
773
774 {{code language="properties" cssClass="notranslate"}}
775 -Dlog4j.appender.R.File="/home/ddapi.log"
776 {{/code}}
777
778 == Configuración del Desktop Studio ==
779
780 El Desktop Studio de DigDash Enterprise también tiene algunos parámetros opcionales especificados en el archivo **digdash.properties.**
781
782 Consulte el capítulo [[Externalización de parámetros en un archivo //digdash.properties//>>||anchor="HExternalizaciF3ndeparE1metrosenunarchivodigdash.properties"]] para realizar esta manipulación.
783
784 Propriedades disponibles:
785
786 * //Nombre//: **adminconsole.ddserver**
787 //Valor//: URL del servidor DigDash Enterprise (por defecto: vacío)
788 //Descripción//: Especifica la URL del servidor al que se conectará Studio. Si no se especifica, Studio utilizará el servidor de URL del archivo JNLP.
789 * //Nombre//: **domain**
790 //Valor//: Nombre de dominio DigDash Enterprise
791 //Descripción//: Especifica el nombre del dominio de DigDash Enterprise al que se conectará Studio. Si no se especifica, Studio utilizará el dominio especificado en la página de inicio de DigDash Enterprise..
792 * //Nombre//: **forceServerDomain**
793 //Valor//: booleano (por defecto: //false//)
794 //Descripción//:Indica al Studio que la URL del servidor y el dominio son editables (//false//) o no (//true//) a través del botón **Avanzado **en la ventana de inicio de sesión de Studio. Si este parámetro está habilitado, le recomendamos que especifique los parámetros de **ddserver **y **domain**.
795 * //Nombre//: **dashboard**
796 //Valor//: Nombre de la aplicación del cuadro de mando
797 //Descripción//: Le permite especificar el nombre de la aplicación del cuadro de mando. Si no se especifica, Studio utilizará el nombre de la aplicación especificado en la página de inicio de DigDash Enterprise, por ejemplo, "digdash_dashboard".
798 * //Nombre//: **authMode**
799 //Valor//: Modo de autenticación del Studio (por defecto: « default ») : //default//, //NTUser//, //NTUserOrLDAP//, o "//NTUserOrLDAP,loginForm//"
800 //Descripción//: Modo de autenticación específico de Studio. El servidor de DigDash Enterprise debe reflejar un modo de autenticación compatible (variable **authMethod **en la configuración del servidor): consulte la documentación para conocer los complementos relacionados con la autenticación y SSO. Los valores posibles son : « default », « NTUser », « NTUserOrLDAP » et « NTUserOrLDAP,loginForm ».
801 * //Nombre//: **sslNoPathCheck**
802 //Valor//: booleano (por defecto: //false//)
803 //Descripción//: Se utiliza como parte de una conexión HTTPS. Indica a Studio que no verifique la ruta de certificación del certificado de seguridad. Se utiliza para probar una configuración SSL con un certificado autofirmado.// Esta configuración no se recomienda en producción.//
804 * //Nombre//: **sslNoHostNameCheck**
805 //Valor//: booleano (por defecto: //false//)
806 //Descripción//: Se utiliza como parte de una conexión HTTPS. Indica a Studio que no verifique el nombre de dominio de Internet. Se utiliza para probar una configuración SSL con un certificado autofirmado.// Esta configuración no se recomienda en producción.//
807
808 * //Nom// : **maxHeapSize**
809 //Valor//: Cantidad de memoria (por defecto: dependiendo de la JVM de la estación de trabajo cliente)
810 //Descripción//: Especifica la cantidad de memoria del nodo cliente asignada a Studio. La sintaxis es {{code language="text" cssClass="notranslate"}}<cantidad><unidad>{{/code}}, donde la unidad es una letra "m" (megabytes) o "g" (gigabytes). Ejemplo: {{code language="text" cssClass="notranslate"}}maxHeapSize = 2048m{{/code}}
811
812 == Directorios de datos DigDash Enterprise ==
813
814 DigDash Enterprise almacena datos en diferentes carpetas. Este capítulo resume estos archivos.
815
816 === Datos de configuración ===
817
818 //Ubicación (por defecto)// : Directorio « Application Data » del usuario que inicia Tomcat(Windows), o carpeta del usuario (linux).
819
820 //Contenido//: Subcarpetas que contienen modelos de datos, cuadros de mando, carteras de flujo, formatos, fórmulas, scripts, estilos, cadenas de conexión, etc. :
821
822 * **config **: datos de configuración comunes, datos de configuración de roles, copias de seguridad y carpetas web personalizadas
823 * **datasources **: archivos de servidor de documentos predeterminados
824 * **server : **datos de configuración del usuario: cartera, modelo y paneles de datos personales, y servidor de documentos personalizado
825
826 //Modificación//: **digdash.properties**, ver la parte [[Cambiar la ruta de los archivos de datos>>doc:||anchor="HCambiarlarutadelosarchivosdedatos"]]**.**
827
828 (% class="box infomessage" %)
829 (((
830 Nota: El volumen de los datos generados puede ser significativo en particular debido a las subcartpetas **cubes** y **history**. Se recomienda que coloque esta carpeta en un disco que tenga una gran cuota de espacio.
831 )))
832
833 === Datos generados ===
834
835 //Ubicación//: Subcarpetas **cubes** y **history** del directorio de **datos de configuración**.
836
837 //Contenido//: Cubos, historial de flujos :
838
839 * **cubes **: subcarpeta de los cubos generados (uno por modelo de datos)..
840 * **history **: historial de todos los flujos, archivos javascript generados (modelo de datos, vistas de flujo).
841
842 //Modificación//: Imposible directamente. Debe cambiar la ubicación de la carpeta principal (**Datos de configuración**) o crear vínculos.
843
844 (% class="box errormessage" %)
845 (((
846 Importante : El volumen de datos generados puede ser significativo. Se recomienda que coloque la carpeta principal (**Datos de configuración**) en un disco con una gran cuota de espacio.
847 )))
848
849 (% class="box infomessage" %)
850 (((
851 Nota : Las carpetas **cubes** y **history** se pueden eliminar para su limpieza (servidor Tomcat apagado). El planificador los volverá a crear y los datos los volverá a actualizar o enviará un evento de actualización.
852 )))
853
854 === Datos LDAP ===
855
856 //Ubicación (por defecto)// : carpeta **ldapdigdash** en el directorio de trabajo de Tomcat (« workdir »).
857
858 //Contenido//: Archivos de la partición LDAP que contienen definiciones de los usuarios, de los roles y de los derechos DigDash
859
860 //Modificación//: **digdash.properties, **ver la parte [[Configuración de LDAP (adswrapper): puerto y directorio de datos>>doc:||anchor="HConfiguraciF3ndeLDAP28adswrapper29:puertoydirectoriodedatos"]].
861
862 === Base de datos DDAudit ===
863
864 //Ubicación (por defecto) //: directorio de trabajo de Tomcat (« workdir »).
865
866 //Contenido//: Archivo de base de datos (H2) que contiene las tablas de datosDDAudit.
867
868 //Modificación//: **digdash.properties** (Ver también [[Despliegue del modulo de Audit>>doc:Digdash.deployment.configuration.ddaudit_module_install.WebHome]])
869
870 {{code language="properties" cssClass="notranslate"}}
871 ddenterpriseapi.audit.db.url=jdbc:h2:DDAudit_${server.DomainName};AUTO_SERVER=TRUE
872 {{/code}}
873
874 === Archivos de registo (//log//) ===
875
876 //Ubicación (por defecto)// : Archivo de registro (//log//) de los módulos de DigDash Enterprise (ddenterpriseapi, digdash_dashboard, studio, adswrapper).
877 El nombre es **ddenterpriseapi.log** por defecto.
878
879 //Contenido//: registro applicativo
880
881 //Modificación//: log4j.properties (todas las webapps)
882
883 (% class="box infomessage" %)
884 (((
885 Nota : La edición del archivo **log4j.properties** también le permite cambiar el formato de registro.
886 )))