Código fuente wiki de Guide de mise à jour

Última modificación por Aurelie Bertrand el 2024/07/09 15:25
Mostrar los últimos autores
1 {{ddtoc/}}
2
3 ----
4
5 Este documento explica los diferentes pasos a seguir para actualizar su implementación de DigDash Enterprise a una nueva versión.
6
7 (% class="box errormessage" %)
8 (((
9 **Cuidado : A(% dir="ltr" lang="es" %)ntes de cualquier actualizacion(%%), haga una copia de seguridad completa de la aplicacion des desde la pagina de inicio => Configuracion => Gestion de los respaldos (Backup management).**
10 )))
11
12 (% class="box warningmessage" %)
13 (((
14 **Importante : Migración de desarrollos específicos (todas las versiones)**
15 Este procedimiento no tiene en cuenta la migración de desarrollos específicos (modificación de logotipos, adición de JSP, ...) que puedan estar descritos en sus procedimientos internos.
16 Si se han realizado desarrollos específicos, realice una copia de seguridad de la aplicación anterior para poder recuperar y migrar todos estos desarrollos.
17 )))
18
19 Los archivos de instalación de DigDash Enterprise son nombrados a partir del formalismo siguiente: **digdash_enterprise_2021R1_numparche_64.zip**.
20
21 Después descomprimiéndolo, la carpeta se llamará **digdash_enterprise_2021R1_numpatch**.
22
23 En ese documento, para explicar el procedimiento, la carpeta de instalación de la versión más antigua se denominará **install_dd_OLD** y la carpeta de instalación de la versión más reciente **install_dd_NEW.**
24
25 El número de versión es visible desde la página « **Configuracion**/ **Estado del servidor** »
26
27 («Versión de DigDash Enterprise », arriba en la izquierda, en la parte « **Estado global** »).
28
29 [[image:1617124843612-239.png]]
30
31 También se puede encontrar el número de versión en el archivo ##version.txt## ubicado en la carpeta descomprimida.
32
33 __**Prerrequisitos:**__
34
35 * Servidor: Java 8 mínimo (Tomcat 8 mínimo si utiliza adswrapper.war)
36 * Desktop Studio: Java 8 mínimo
37
38 = Primer desplegó de una versión 2021R1 =
39
40 Esa parte concierna usted en el caso de un primer desplegó de la versión 2021R1
41
42 En el caso de un desplegó de un parche por la versión 2021R1, por favor siga las instrucciones dadas en el capítulo siguiente:
43
44 {{success}}
45 Esta versión simplifica los procesos de instalación, configuración y mantenimiento (instalación de un parche o intervención del soporte).
46 **Es interesante y muy recomendable comenzar la instalación desde cero para esta actualización.**
47 El nuevo sistema de configuración le ahorrará tiempo más tarde.
48 {{/success}}
49
50 El principio general es solo tener que modificar un archivo: ##**digdash.properties**##, que se conservará automáticamente durante una próxima actualización.
51 Este archivo se proporciona en el archivo de instalación y ya contiene todos los parámetros que se pueden personalizar durante la instalación.
52
53 Hay dos casos principales: uso del servidor Tomcat suministrado (Windows o Linux) o uso de su propio Tomcat.
54
55 == Usando el Tomcat proveedo ==
56
57 === Paso 1: Respaldo ===
58
59 Realice una copia de seguridad completa de su configuración: entradas LDAP (usuarios, roles, grupos de autorización), modelos de datos, cuadros de mando, etc.
60 Si habías agregado archivos a tu instalación (modificación de logotipos, imágenes, css, adición de JSP, ...) tendrás que transferirlos a la nueva instalación.
61
62 Consulte la documentación Copia de seguridad y restauración.
63
64 === Paso 2: Apagado del servidor ===
65
66 ==== Windows ====
67
68 Detenga el servidor DigDash usando: ##**<install_dd_OLD>/stop_tomcat.bat**##.
69
70 ==== Unix ====
71
72 Detenga el servidor DigDash usando: **##<install_dd_OLD>/apache-tomcat/bin/shutdown.sh ##** o detenga el servicio correspondiente.
73
74 === Paso 3: Extracción ===
75
76 * Descomprima ##**digdash_enterprise_2021R1_numparche_64.zip**## en la ubicación de su elección usando una herramienta como [[7Zip>>https://www.7-zip.org/]].
77 * Cambie el nombre de la carpeta que contiene la instalación. Lo ideal es un nombre sin versión, para no inducir a error el contenido de la instalación durante futuras actualizaciones.
78 * Verifique que su carpeta de instalación contenga el archivo** ##version.txt##**. Es él quien indicará con certeza la versión del producto (sin tener que iniciar el servidor).
79
80 === Paso 4: Configuración ===
81
82 (% class="box infomessage" %)
83 (((
84 Si está en Linux, copie el archivo ##**<install_dd_NEW>/digdash.properties**## en la carpeta ##**/etc/digdash**##.
85 El servidor lo encontrará automáticamente.
86 Asegúrese de que las carpetas y los archivos tengan los mismos derechos que el usuario que ejecuta el servicio Tomcat.
87 )))
88
89 * Edite el archivo ##**<install_dd_NEW>/digdash.properties**##.
90
91 (% class="box infomessage" %)
92 (((
93 Las líneas que comienzan con un solo carácter **# **son las que se van a modificar.
94 Al eliminar el carácter **# **al principio de la línea, activa el parámetro.
95 )))
96
97 (((
98 ==== Ubicación de los datos ====
99
100 (% class="box successmessage" %)
101 (((
102 Al configurar, preste especial atención a los parámetros**## digdash.appdata##** o **##<application>.AppDataPath##**.
103 Lo ideal es usar el parámetro global **##digdash.appdata##**: todas las aplicaciones usarán la misma carpeta raíz.
104 )))
105
106 Para especificar una ubicación común a todas las aplicaciones DigDash (ldap, servidor, estudio, ...) debe modificar el parámetro **##digdash.appdata##**:
107
108 {{code language="text" cssClass="notranslate"}}
109 #digdash.appdata=C:/appdata
110 {{/code}}
111 )))
112
113 (% class="wikigeneratedid" id="H" %)
114 Después de la modificación:
115
116 {{code language="text" cssClass="notranslate"}}
117 digdash.appdata=C:/appdata
118 {{/code}}
119
120 (% class="box warningmessage" %)
121 (((
122 Tenga cuidado de usar solo barras inclinadas "/" o dos barras invertidas "~\~\".
123 )))
124
125 ==== LDAP ====
126
127 Preste atención a la carpeta de datos del directorio LDAP. Esta es la carpeta ##**ldapdigdash**## (si no la ha cambiado) :
128
129 * Si utiliza el parámetro global**## digdash.appdata##**, deberá mover su antigua carpeta ##**ldapdigdash**## a la carpeta especificada en este parámetro.
130 * Si desea continuar colocando la carpeta **##ldapdigdash## **en una ubicación diferente, use el parámetro##** adswrapper.ads.instance.name.**##
131
132 (% class="box warningmessage" id="H" %)
133 (((
134 Todas las aplicaciones en la misma carpeta (mismo LDAP):
135
136 {{code language="text" cssClass="notranslate"}}
137 digdash.appdata=C:/appdata
138 {{/code}}
139 )))
140
141 (% class="box warningmessage" id="H" %)
142 (((
143 Para una carpeta LDAP separada:
144
145 {{code language="text" cssClass="notranslate"}}
146 adswrapper.ads.instance.name=D:/data/ldapdigdash
147 {{/code}}
148 )))
149
150 ==== Otros parámetros ====
151
152 * Todos los demás parámetros presentes en este archivo tienen como prefijo el nombre de la aplicación en cuestión:
153 ** {{code language="text" cssClass="notranslate"}}<nombre de la applicacion>.<nombre del parametro>=<valor>{{/code}}
154 * Por lo tanto, debe transferir todos los parámetros que modificó en los archivos ##**web.xml**## de su instalación anterior.
155 ** Por ejemplo, para modificar el método de autenticación (**##authMethod##**) en el Tablero (##**digdash_dashboard**.war##) debe modificar el parámetro##** digdash_dashboard.authMethod : **##
156 *** (((
157 ##{{code language="text" cssClass="notranslate"}}#digdash_dashboard.authMethod=default/NTUser/NTUserOrLDAP/NTUserOrLDAP,loginForm/Custom{{/code}}##
158 vuelve a ser :
159 ##{{code language="text" cssClass="notranslate"}}digdash_dashboard.authMethod=default/NTUser/NTUserOrLDAP/NTUserOrLDAP,loginForm/Custom{{/code}}##
160 )))
161
162 === Paso 5: Inicio del servidor ===
163
164 Una vez que haya transferido todas las configuraciones de su instalación anterior al archivo digdash.properties, inicie TOMCAT usando :
165
166 * en Windows : ##**<install_dd_NEW>/start_tomcat.bat**## y deje que Tomcat vuelva a implementar las nuevas aplicaciones.
167 * en Unix :##** <install_dd_OLD>/apache-tomcat/bin/startup.sh**##.
168
169 Para una instalación como servicio en Windows, use el script ##**<install_dd_NEW>/configure/servers_install_service.bat**## (preste atención al nombre del servicio si lo había modificado durante la instalación anterior, consulte la Guía de instalación de Windows para obtener más detalles) .
170
171 En Linux, consulte la Guía de instalación de Linux.
172 Más información sobre la instalación como servicio en la Guía de instalación de Windows.
173
174 === Paso 6: Restauracion ===
175
176 * Si ha configurado su nueva instalación para que apunte a su carpeta de datos anterior (consulte el Paso 5), la restauración no es necesaria.
177 * De lo contrario (nueva carpeta de datos) utilice la copia de seguridad del paso 1 para restaurar las entradas LDAP (usuarios, roles, grupos de permisos).
178
179 (% class="box infomessage" %)
180 (((
181 __**Importante**__: si ha realizado modificaciones en las carpetas ddenterpriseapi y digdash_dashboard en archivos de configuración (web.xml, ...), imágenes o archivos css, tendrá que aplazarlos.
182 )))
183
184 (% class="box warningmessage" %)
185 (((
186 __**Nota**__: Si viene de una versión 2017 R1 y si ha personalizado los estilos del tablero, consulte la documentación de Personalización para actualizar sus estilos CSS.
187 )))
188
189 === Paso 7: Limpiar la caché del navegador ===
190
191 * Eliminar la caché del navegador (accesos directos en la mayoría de los navegadores con el teclado: Ctrl + Shift + Supr)
192
193 == Usando su propio servidor Tomcat ==
194
195 * Si está utilizando su propio servidor Tomcat (Windows o Linux), el procedimiento a seguir es el mismo que para la implementación de un parche, por lo tanto, puede seguir el procedimiento del capítulo siguiente.
196 * Solo el paso 6: será necesario adaptar la recuperación de complementos.
197 ** Solo tendrá que copiar la carpeta de complementos donde más te convenga (es posible que ya la tenga en su máquina, pero puede que contenga actualizaciones).
198
199 = Desplego de un parche en una version 2021R1 =
200
201 Este párrafo se refiere a la actualización de una versión 2021 R1 a otra más reciente 2021 R1.
202
203 (% class="box infomessage" %)
204 (((
205 El siguiente procedimiento asume que su configuración sigue la recomendación de usar el archivo ##**digdash.properties**##. Si no lo hace, consulte el primer capítulo.
206 )))
207
208 (% class="box warningmessage" %)
209 (((
210 Si su instalación contiene desarrollos específicos, que se pueden encontrar en las carpetas de aplicaciones:
211 ##**<install_dd>/apache-tomcat/webapps/ddenterpriseapi**## o **##<install_dd>/apache-tomcat/webapps/digdash_dashboard##**
212 se perderán durante la actualización. Guárdelos antes de cualquier otra operación, para poder posponerlos después de la actualización.
213 )))
214
215 == Paso 1: Respaldo ==
216
217 * Realice una copia de seguridad completa de su configuración: entradas LDAP (usuarios, roles, grupos de autorización), modelos de datos, cuadros de mando, etc.
218 * No olvide las novedades específicas que se puedan encontrar en las aplicaciones (ver el recuadro amarillo anterior).
219
220 == Paso 2: Apagado del servidor ==
221
222 === Windows ===
223
224 Detenga el servidor DigDash usando: ##**<install_dd_OLD>/stop_tomcat.bat**##.
225
226 === Unix ===
227
228 Detenga el servidor DigDash usando: **##<install_dd_OLD>/apache-tomcat/bin/shutdown.sh ##** o detenga el servicio correspondiente.
229
230 == Paso 3: Borrar los applicaciones ==
231
232 Haga una copia de seguridad y luego elimine los archivos y carpetas de ##**<install_dd>/apache-tomcat/webapps**##:
233
234 |(((
235 Carpetas :
236
237 * adminconsole
238 * ddenterpriseapi
239 * digdash_dashboard
240 * studio
241 * adswrapper
242 )))|(((
243 Archivos :
244
245 * adminconsole.war
246 * ddenterpriseapi.war
247 * digdash_dashboard.war
248 * studio.war
249 * adswrapper.war
250 )))
251
252 (% class="box warningmessage" %)
253 (((
254 No elimine la carpeta **ROOT**.
255 )))
256
257 (% class="box warningmessage" %)
258 (((
259 No elimine la carpeta **ldapdigdash**.
260 )))
261
262 == Paso 4: Copiar las nuevas applicaciones ==
263
264 * (((
265 Descomprima la nueva versión del producto en una ubicación temporal.
266 )))
267 * (((
268 Navegue en esta carpeta temporal a la carpeta **##apache-tomcat/webapps.##**
269 )))
270 * (((
271 Copie los siguientes 5 archivos en la misma carpeta en su instalación:
272
273 * adminconsole.war
274 * ddenterpriseapi.war
275 * digdash_dashboard.war
276 * studio.war
277 * adswrapper.war
278 )))
279 * La carpeta **webapps** debe ahora contener **5 archivos .war **y la carpeta **ROOT**
280
281 == Paso 5: Archivo version.txt ==
282
283 * Copie el archivo ##**version.txt**## a su carpeta de instalación. Reemplazará al de la instalación anterior.
284
285 (% class="box infomessage" %)
286 (((
287 Este archivo se utiliza para conocer la versión del producto sin iniciar el servidor o si la página "Estado del servidor" no está disponible.
288 )))
289
290 == Paso 6: Add-ons ==
291
292 * Copie el contenido de la carpeta de **add-ons** en la misma ubicación en su instalación.
293 * Si ha modificado algunos archivos (importtools, backtuptools, ...) guárdelos antes de copiarlos.
294
295 == Paso 7: Inicio del servidor ==
296
297 Inicie TOMCAT usando :
298
299 * en Windows : ##**<install_dd_NEW>/start_tomcat.bat**## y deje que Tomcat vuelva a implementar las nuevas aplicaciones.
300 * en Unix : ##**<install_dd_OLD>/apache-tomcat/bin/startup.sh**##.
301
302 Si está en modo de servicio, reinícielo manualmente.
303
304 == Paso 8: Limpiar la caché del navegador ==
305
306 * Eliminar la caché del navegador (accesos directos en la mayoría de los navegadores con el teclado: Ctrl + Shift + Supr)
307
308
309 = Versión 2018 R2 o inferior hacia una version 2021 R1 =
310
311 Póngase en contacto con DigDash en contact@digdash.com.