Código fuente wiki de Guide de mise à jour
Última modificación por jhurst el 2022/04/28 16:42
Mostrar los últimos autores
author | version | line-number | content |
---|---|---|---|
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. |