Última modificación por jhurst el 2021/09/09 15:26
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"}}
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"}}
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"}}
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"}}
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"}}
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"}}
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"}}
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"}}
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"}}
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:.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 [[image:1625491296920-557.png]]
450
451 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),
452
453 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.
454
455 Para agregar un clúster autorizado para usar este servidor esclavo:
456
457 1. **Nombre**: nombre del clúster (arbitrario)
458 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)
459 1. **Contraseña**: contraseña de esclavo en el contexto del clúster seleccionado
460 1. Haga clic en el botón **Añadir **para agregar este clúster a la lista de clústeres autorizados
461
462 (% class="box infomessage" %)
463 (((
464 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**.
465 )))
466
467 === Sección Definición del clúster
468 ===
469
470 Para completar** solo en el servidor maestro del clúster**
471
472 [[image:1625491325352-651.png]]
473
474 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.
475
476 Para agregar una máquina esclava al clúster:
477
478 1. **Nombre**: nombre de la máquina esclava (arbitrario)
479 1. **URL del servidor**: URL del servidor esclavo (por ejemplo: http:~/~/192.168.1.123:8080)
480 1. **Dominio**: dominio de DigDash Enterprise (por defecto ddenterpriseapi)
481 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**)
482 1. Haga clic en el botón **Añadir **para agregar esta máquina a su clúster.
483
484 (% class="box infomessage" %)
485 (((
486 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**.
487 )))
488
489 === Utilisation de plusieurs maîtres dans un cluster ===
490
491 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.
492
493 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.
494
495 Debemos definir no uno, sino dos clústerse A y B:
496
497 En la definición del cluster A :
498
499 1. Servidor actual : Servidor A (maestro de este clúster)
500 1. Servidor B (esclavo de este clúster)
501
502 En la definición del cluster B :
503
504 1. Servidor A (esclavo de este clúster)
505 1. Servidor actual: Servidor B (maestro de este clúster)
506
507 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).
508
509 == Configuración avanzada específica del clúster ==
510
511 Archivo modificado: **system.xml**
512
513 Ejemplo de sintaxis XML:
514
515 {{code language="xml"}}
516 <Property key="CLUSTER_TIMEOUT" value="45000"></Property>
517 {{/code}}
518
519 Propriedades disponibles:
520
521 * //Nombre//: **CUBE_UPLOAD_MODE**
522 //Valor//: entero: 0, 1 ou 2 (por defecto: 1)
523 //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);
524 Ver también el próximo capítulo : "//Uso del clúste//r".
525 * //Nombre//: **CLUSTER_TIMEOUT**
526 //Valor//: entero: (milisegundos, por defecto: 30000)
527 //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)
528 * //Nombre//: **CLUSTER_CHECK_TIMEOUT**
529 //Valor//: entero: (milisegundos, por defecto: 5000)
530 //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.
531
532 == Uso del clúster ==
533
534 En una implementación de clúster simple, no hay nada más que hacer que lo que se ha escrito anteriormente.
535
536 Aun así, existen algunos detalles interesantes que pueden ayudar a mejorar el rendimiento de un clúster.
537
538 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.
539
540 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 ...)
541
542 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).
543
544 Sin embargo, existen diferentes formas de evitar esta congestión de la red. Aquí hay algunas sugerencias:
545
546 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.
547
548 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.
549
550 = Otras configuraciones avanzadas =
551
552 == Cambiar la ruta de los archivos de datos ==
553
554 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>**##.
555
556 Por ejemplo, en Windows, este archivo es:
557 ##C:\Users\<usuario>\AppData\Roaming\Enterprise Server\ddenterpriseapi##
558
559 Es importante modificar este archivo para garantizar la accesibilidad (derechos en lectura, escritura, ejecución) y para supervisar el espacio de almacenamiento. 
560 Esta modificación es también interesante para razones de organización, de //scripting//, etc.
561
562 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"]].
563
564 == Configuración de LDAP (adswrapper): puerto y directorio de datos ==
565
566 Archivo modificado: **digdash.properties**
567
568 Consulte el capítulo [[Externalización de parámetros en un archivo //digdash.properties//>>||anchor="HExternalizaciF3ndeparE1metrosenunarchivodigdash.properties"]] para realizar esta manipulación.
569
570 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.
571 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).
572
573 Ejemplo: si la aplicación se llama adswrapper (adswrapper.war):
574
575 * {{code language="text"}}adswrapper.ads.ldap.port = 11590{{/code}}
576
577 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"]].
578
579 == {{id name="param_adv_dashboard"/}}Configuración avanzada del editor y de la consultación de cuadros de mandos ==
580
581 Archivo modificado: **digdash.properties**
582
583 Consulte el capítulo [[Externalización de parámetros en un archivo //digdash.properties//>>||anchor="HExternalizaciF3ndeparE1metrosenunarchivodigdash.properties"]] para realizar esta manipulación.
584
585 Propriedades disponibles:
586
587 * //Nombre//: **SERVERURL**
588 //Valor//: URL del servidor DigDash Enteprise
589 //Descripción//: URL del servidor al que se debe conectar en prioridad el cuadro de mando.
590 * //Nombre//: **DOMAIN**
591 //Valor//: Nombre del dominio DigDash Enterprise
592 //Descripción//: Nombre del dominio al que debe conectarse en prioridad el cuadro de mando.
593 * //Nombre//: **FORCESERVERURL**
594 //Valor//: booleano (por defecto: false)
595 //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.
596 * //Nombre//: **FORCEDOMAIN**
597 //Valor//: booleano (por defecto: false)
598 //Descripción//: Usado con el parámetro **DOMAIN**. Fuerza el dominio al que se conecta el panel. El usuario no puede elegir otro dominio.
599 * //Nombre//: **GRIDSIZEEDITOR**
600 //Valor//: entero (por defecto: 10)
601 //Descripción//: Tamaño en píxeles de la cuadrícula magnética del editor de cuadros de mando.
602 * //Nombre//: **THEME**
603 //Valor//: Nombre del tema (por defecto: vacío)
604 //Descripción//: Nombre del tema predeterminado utilizado para usuarios que no tienen un tema específico especificado.
605
606 * //Nombre//: **urlLogout**
607 //Valor//: URL
608 //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"]].
609 * //Nombre//: **CANCHANGEPASSWORD**
610 //Valor//: booleano (por defecto: false)
611 //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"]]
612
613 Ejemplo de contenido parcial del archivo **digdash.properties** :
614
615 {{code language="properties"}}
616 digdash_dashboard.SERVERURL=http://localhost:8080
617 digdash_dashboard.FORCESERVERURL=true
618 digdash_dashboard.DOMAIN=ddenterpriseapi
619 digdash_dashboard.FORCEDOMAIN=true
620 digdash_dashboard.GRIDSIZEEDITOR=15
621 digdash_dashboard.THEME=Flat
622 digdash_dashboard.urlLogout=disconnected.html
623 digdash_dashboard.CANCHANGEPASSWORD=true
624 {{/code}}
625
626
627 === Redirección al desconectarse del cuadro de mando ===
628
629 Archivo modificado: **digdash.properties**
630
631 Puede especificar una URL que se mostrará en el navegador cuando el usuario cierre sesión en el panel.
632
633 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.
634 Se permiten URL relativas, desde la URL index.html de la aplicación digdash_dashboard:
635
636 {{code language="properties"}}
637 digdash_dashboard.urlLogout=disconnected.html
638 {{/code}}
639
640
641 === Activación de la función de restablecimiento de contraseña ===
642
643 Archivo modificado: **digdash.properties**
644
645 Puede activar la función de restablecimiento de la contraseña perdida.
646 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.
647 Luego, el usuario es redirigido a una interfaz de reinicio para ingresar este código y una nueva contraseña.
648
649 Prerrequisito en el servidor DigDash :
650
651 * La funcionalidad también debe activarse a través de **Configuración de servidores** / **Parámetros adicionales... **/ **Varios **/ **Habilitar el restablecimiento de contraseña**
652 * 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**
653 * Los usuarios deben tener una dirección de correo electrónico válida en el campo LDAP **digdashMail**
654
655 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"]])
656
657 {{code language="properties"}}
658 digdash_dashboard.CANCHANGEPASSWORD=true
659 {{/code}}
660
661
662 __Opcional: personalización del correo electrónico del código de restablecimiento__
663
664 El asunto y el cuerpo del correo electrónico con el código de restablecimiento se pueden personalizar de la siguiente manera:
665
666 1. Inicie el Web Studio
667 1. Abre el gestor de traduccionnes: **Gestor de diccionarios**
668 [[image:1625482832542-178.png]]
669 1. Haga clic derecho en la categoria **Global** y haga clic en **Agregar...**
670 [[image:1625482938077-196.png]]
671 Nombre de la clave : **LostPasswordMailSubject**
672 [[image:1625482988798-118.png]]
673 1. Saisir le sujet de l’émail dans les langues qui vous intéressent.
674 [[image:1625483067814-837.png]]
675 1. De nuevo, Haga clic derecho en la categoria **Global** y haga clic en **Agregar...**
676 1. Nombre de la clave : **LostPasswordMailText**
677 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}**.
678 [[image:1625483225715-271.png]]
679
680 (% class="box warningmessage" %)
681 (((
682 No recomendamos dar demasiada información en este correo electrónico. Por eso, en el mensaje predeterminado solo indicamos el código de reinicio.
683 )))
684
685 __Configuración avanzada específica de la función de restablecimiento de contraseña__
686
687 Archivo modificado: **system.xml**
688
689 Ejemplo de sintaxis XML:
690
691 {{code language="xml"}}
692 <Property key="PROP_RESET_PASS_HASH" value="dfrj65433lkloss!00"></Property>
693 {{/code}}
694
695 Propriedades disponibles:
696
697 * //Nombre//: **PROP_RESET_PASS_HASH**
698 //Valor//: cadena de caracteres no vacía (por defecto: aléatoire)
699 //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.
700 * //Nombre//: **PROP_RESET_PASS_VALIDITY**
701 //Valor//: entero positivo (por defecto: 1)
702 //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.
703 * //Nombre//: **PROP_RESET_PASS_LENGTH**
704 //Valor//: entero positivo (por defecto: 10)
705 //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.
706
707 == Configuración de seguridad interna ==
708
709 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]].
710
711 == {{id name="externalisation"/}}{{id name="externalisation"/}}Externalización de parámetros en un archivo //digdash.properties// ==
712
713 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]].
714
715 (% class="box infomessage" %)
716 (((
717 Esto permite preconfigurar la configuración de la aplicación web incluso antes del primer inicio.
718 Aún más importante, permite simplificar la actualización de las aplicaciones web de DigDash Enterprise (sin perder la configuración).
719 )))
720
721 El archivo **digdash.properties** se entrega a la raíz del **directorio de instalación**.
722 Todos los parámetros están presentes pero desactivados.
723 Para activarlos, elimine el carácter **#** al principio de la línea.
724 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).
725
726 (% class="box infomessage" %)
727 (((
728 Ejemplo: si busca el parámetro **authMethod** del servidor (**ddenterpriseapi.war**) se encontrara como **ddenterpriseapi.authMethod.**
729 )))
730
731
732 (% class="box errormessage" %)
733 (((
734 Importante : Utilice el carácter de barra "/" o doble el carácter de barra invertida "\" en el archivo digdash.properties.
735 Ejemplo: ddenterpriseapi.//AppDataPath=C:/path/to/digdash_data
736 o//
737 ddenterpriseapi.//AppDataPath=C:~\~\path~\~\to~\~\digdash_data//
738 )))
739
740 Para que el archivo **digdash.properties** se tenga en cuenta con certeza, se debe especificar su ubicación al iniciar el servidor (Tomcat).
741
742 * 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
743 * En Linux con el servidor Tomcat previsto, copie el archivo **digdash.properties** en la carpeta **/etc/digdash**
744 * Con su propio servidor Tomcat, deberá editar el archivo **setenv.bat** o **setenv.sh** para especificar la ubicación de su archivo **digdash.properties**.
745
746 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"]]
747
748 === Prioridad entre los niveles de configuración ===
749
750 Los parámetros se leen en el siguiente orden (tan pronto como se encuentra un valor, se ignoran los siguientes niveles):
751
752 1. Parámetro en el comando de inicio del servidor Tomcat({{code language="text"}}-D<context>.<Parameter>=<value>{{/code}})
753 1. Archivo .properties especificado en la línea de comandos del servidor Tomcat ({{code language="text"}}-D<context>.properties.path=/the/path/to/<context>.properties{{/code}})
754 1. Archivo .properties encontrado en la carpeta de trabajo del servidor Tomcat ({{code language="text"}}<tomcat workdir>/<context>.properties{{/code}})
755 1. Parámetro global en la línea de comandos del servidor Tomcat ({{code language="text"}}-D<Parameter>=<value>{{/code}})
756 1. Archivo web.xml para cada aplicación({{code language="text"}}<context>/WEB-INF/web.xml{{/code}})
757
758 == Especificar los parámetros de registro (//logging//) log4j.properties ==
759
760 Los parámetros de registro (o de //logging//) se definen en un archivo **log4j.properties** disponible en cada aplicación web implementada.
761
762 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:
763
764 {{code language="properties"}}
765 -Dddenterpriseapi.ddlog4j.properties.path="/path/to/log4j.properties"
766 -Ddigdash_dashboard.ddlog4j.properties.path="/path/to/log4j.properties"
767 -Dadswrapper.ddlog4j.properties.path="/path/to/log4j.properties"
768 {{/code}}
769
770 También puede especificar la ubicación del archivo de registro (global) sin necesidad de especificar un archivo log4j.properties:
771
772 {{code language="properties"}}
773 -Dlog4j.appender.R.File="/home/ddapi.log"
774 {{/code}}
775
776 == Configuración del Desktop Studio ==
777
778 El Desktop Studio de DigDash Enterprise también tiene algunos parámetros opcionales especificados en el archivo **digdash.properties.**
779
780 Consulte el capítulo [[Externalización de parámetros en un archivo //digdash.properties//>>||anchor="HExternalizaciF3ndeparE1metrosenunarchivodigdash.properties"]] para realizar esta manipulación.
781
782 Propriedades disponibles:
783
784 * //Nombre//: **adminconsole.ddserver**
785 //Valor//: URL del servidor DigDash Enterprise (por defecto: vacío)
786 //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.
787 * //Nombre//: **domain**
788 //Valor//: Nombre de dominio DigDash Enterprise
789 //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..
790 * //Nombre//: **forceServerDomain**
791 //Valor//: booleano (por defecto: //false//)
792 //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**.
793 * //Nombre//: **dashboard**
794 //Valor//: Nombre de la aplicación del cuadro de mando
795 //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".
796 * //Nombre//: **authMode**
797 //Valor//: Modo de autenticación del Studio (por defecto: « default ») : //default//, //NTUser//, //NTUserOrLDAP//, o "//NTUserOrLDAP,loginForm//"
798 //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 ».
799 * //Nombre//: **sslNoPathCheck**
800 //Valor//: booleano (por defecto: //false//)
801 //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.//
802 * //Nombre//: **sslNoHostNameCheck**
803 //Valor//: booleano (por defecto: //false//)
804 //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.//
805
806 * //Nom// : **maxHeapSize**
807 //Valor//: Cantidad de memoria (por defecto: dependiendo de la JVM de la estación de trabajo cliente)
808 //Descripción//: Especifica la cantidad de memoria del nodo cliente asignada a Studio. La sintaxis es {{code language="text"}}<cantidad><unidad>{{/code}}, donde la unidad es una letra "m" (megabytes) o "g" (gigabytes). Ejemplo: {{code language="text"}}maxHeapSize = 2048m{{/code}}
809
810 == Directorios de datos DigDash Enterprise ==
811
812 DigDash Enterprise almacena datos en diferentes carpetas. Este capítulo resume estos archivos.
813
814 === Datos de configuración ===
815
816 //Ubicación (por defecto)// : Directorio « Application Data » del usuario que inicia Tomcat(Windows), o carpeta del usuario (linux).
817
818 //Contenido//: Subcarpetas que contienen modelos de datos, cuadros de mando, carteras de flujo, formatos, fórmulas, scripts, estilos, cadenas de conexión, etc. :
819
820 * **config **: datos de configuración comunes, datos de configuración de roles, copias de seguridad y carpetas web personalizadas
821 * **datasources **: archivos de servidor de documentos predeterminados
822 * **server : **datos de configuración del usuario: cartera, modelo y paneles de datos personales, y servidor de documentos personalizado
823
824 //Modificación//: **digdash.properties**, ver la parte [[Cambiar la ruta de los archivos de datos>>doc:||anchor="HCambiarlarutadelosarchivosdedatos"]]**.**
825
826 (% class="box infomessage" %)
827 (((
828 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.
829 )))
830
831 === Datos generados ===
832
833 //Ubicación//: Subcarpetas **cubes** y **history** del directorio de **datos de configuración**.
834
835 //Contenido//: Cubos, historial de flujos :
836
837 * **cubes **: subcarpeta de los cubos generados (uno por modelo de datos)..
838 * **history **: historial de todos los flujos, archivos javascript generados (modelo de datos, vistas de flujo).
839
840 //Modificación//: Imposible directamente. Debe cambiar la ubicación de la carpeta principal (**Datos de configuración**) o crear vínculos.
841
842 (% class="box errormessage" %)
843 (((
844 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.
845 )))
846
847 (% class="box infomessage" %)
848 (((
849 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.
850 )))
851
852 === Datos LDAP ===
853
854 //Ubicación (por defecto)// : carpeta **ldapdigdash** en el directorio de trabajo de Tomcat (« workdir »).
855
856 //Contenido//: Archivos de la partición LDAP que contienen definiciones de los usuarios, de los roles y de los derechos DigDash
857
858 //Modificación//: **digdash.properties, **ver la parte [[Configuración de LDAP (adswrapper): puerto y directorio de datos>>doc:||anchor="HConfiguraciF3ndeLDAP28adswrapper29:puertoydirectoriodedatos"]].
859
860 === Base de datos DDAudit ===
861
862 //Ubicación (por defecto) //: directorio de trabajo de Tomcat (« workdir »).
863
864 //Contenido//: Archivo de base de datos (H2) que contiene las tablas de datosDDAudit.
865
866 //Modificación//: **digdash.properties** (Ver también [[Despliegue del modulo de Audit>>doc:Digdash.deployment.configuration.ddaudit_module_install.WebHome]])
867
868 {{code language="properties"}}
869 ddenterpriseapi.audit.db.url=jdbc:h2:DDAudit_${server.DomainName};AUTO_SERVER=TRUE
870 {{/code}}
871
872 === Archivos de registo (//log//) ===
873
874 //Ubicación (por defecto)// : Archivo de registro (//log//) de los módulos de DigDash Enterprise (ddenterpriseapi, digdash_dashboard, studio, adswrapper).
875 El nombre es **ddenterpriseapi.log** por defecto.
876
877 //Contenido//: registro applicativo
878
879 //Modificación//: log4j.properties (todas las webapps)
880
881 (% class="box infomessage" %)
882 (((
883 Nota : La edición del archivo **log4j.properties** también le permite cambiar el formato de registro.
884 )))