Código fuente wiki de Guide d'installation Windows

Última modificación por jhurst el 2022/04/28 16:42
Mostrar los últimos autores
1 {{ddtoc/}}
2
3 ----
4
5
6 (% class="box infomessage" %)
7 (((
8 __Vocabulario__
9
10 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:
11
12 * **Servidor**: ddenterpriseapi.war
13 * **Cuadro de mandos:** digdash_dashboard.war
14 * **Web Studio:** studio.war
15 * **Página de inicio y Desktop Studio:** adminconsole.war
16
17 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.
18
19 Para desplegar varios dominios, siga [[este enlace>>path:/xwiki/wiki/howtos/view/howtos/server/Domain_management/]].
20 )))
21
22 (% class="wikigeneratedid" %)
23 La instalación de DigDash Enterprise en un sistema Windows se puede hacer de dos maneras:
24
25 * lanzamiento manual
26 * lanzamiento automático como servicio Windows
27
28 (% class="wikigeneratedid" %)
29 Esta página describe como instalar DigDash en un sistema Windows de las dos maneras.
30
31 (% class="wikigeneratedid" id="HIntroduction" %)
32 Para la instalación en Linux, siga el [[Guía de instalación Linux>>doc:Digdash.deployment.installation.install_guide_linux.WebHome]].
33
34 Para actualizar una instalación ya exístante, siga el [[Guía de actualización>>doc:Digdash.deployment.installation.upgrade_dde.WebHome]].
35
36
37 = Instalación =
38
39 * Descomprima los archivos contenidos en el archivo **digdash_enterprise_2021R1_numpatch_64.zip** hacia el directorio deseado en su ordenador.
40 * Cambia el nombre del directorio conteniendo la instalación
41 ** La manera ideal de hacerlo es de elegir un nombre sin versión dentro, para no equivocarse en el contenido de la instalación durante las próximas actualizaciones que vendrán.
42 * Compruebe que su carpeta de instalación contenga un archivo **version.txt**.
43 ** Es este archivo que indicara con certitud la versión del producto (sin deber encender el servidor).
44
45 La integralidad de los archivos del servidor DigDash Enterprise es ahora instalada en su ordenador.
46
47 = Parámetros Tomcat =
48
49 Algunos parámetros usuales como la asignación de memoria y los puertos necesarios están sujetos a cambios en la instalación.
50
51 Este parágrafo comenta como modificar tres de los parámetros los más importantes durante la instalación: la asignación de memoria a Tomcat, los puertos usados y el nombre de servicio Windows (en el caso de una instalación en sistema Windows como servicio).
52
53 Una lista más completa de los parámetros sistemas se puede encontrar en la página de la [[Configuración avanzada de parámetros del sistema>>doc:Digdash.deployment.configuration.advanced_system_guide.WebHome]].
54
55 == Memoria asignada a Tomcat ==
56
57 1. Abra el directorio **<DD Install>/configure** y modifique el archivo **setenv.bat**
58 1. Modifique los valores de las variables {{code language="text"}}JVMM{{/code}} y {{code language="text"}}JVMMX{{/code}} definidas al inicio del archivo.
59 1*. Por ejemplo: {{code language="text"}}set JVMMS=4096{{/code}} y {{code language="text"}}set JVMMX=4096{{/code}} para aumentar la memoria asignada a Tomcat a 4Go.
60
61 == Puertos de red Tomcat ==
62
63 Si uno de los puertos necesarios a Tomcat está ya usado para un otro proceso, Tomcat no podrá encenderse. Es necesario comprobar la disponibilidad de los puertos y, según la necesidad, configurar Tomcat en consecuencia.
64
65 De manera predeterminada, los tres siguientes puertos son configurados: 8005, 8080 y 8009. Para modificarlos:
66
67 1. Abra el directorio **<DD Install>/apache-tomcat/conf** y luego modificar el archivo **server.xml**
68 1. Busque y substituya los valores de los puertos **8005**,** 8080 **y **8009 **con números de puertos disponibles en el sistema.
69
70 == Nombre del servicio de Windows Tomcat ==
71
72 En algunos casos, es interesante de cambiar el nombre del servicio Windows que será creado durante la instalación como servicio (ver a continuación), por ejemplo si un servicio del mismo nombre existe ya.
73
74 1. Abra el directorio <**DD Install>/configure** y modifique el archivo **servers_install_service.bat**
75 1. Busque y modifique el valor de la variable {{code language="text"}}SERVICE_NAME{{/code}} al inicio del archivo.
76 1*. Por ejemplo: {{code language="text"}}set SERVICE_NAME=Tomcat_DEV{{/code}}
77
78 = Parámetros DigDash =
79
80 Antes del primer aranque del servidor, aconsejamos de asegurarse que algunos parámetros sean compatibles con su entorno.
81
82 == Ubicación del directorio de sus datos ==
83
84 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>**##.
85
86 Por ejemplo, en Windows, este archivo es:
87 ##C:\Users\<usuario>\AppData\Roaming\Enterprise Server\ddenterpriseapi##
88
89 Es importante modificar este archivo para garantizar la accesibilidad (derechos en lectura, escritura, ejecución) y para supervisar el espacio de almacenamiento. 
90 Esta modificación es también interesante para razones de organización, de //scripting//, etc.
91
92 Existe varias maneras de modificar esta ubicación.
93
94 === Directorio común a todos los dominios ===
95
96 Archivo modificado: {{code language="text"}}digdash.properties{{/code}}
97
98 Es la manera la más sencilla y la más eficaz. Todos los dominios de su instalación DigDash Enterprise aprovecharon de esta modificación (una única configuración para todos).
99 (La secunda manera es a reservar en caso de necesidad específica).
100
101 La variable {{code language="text"}}digdash.appdata{{/code}} permite especificar el único directorio de los datos.
102 En el archivo {{code language="text"}}<DDE Install>/digdash.properties{{/code}} quita el simbol # delante de la línea {{code language="text"}} #digdash.appdata=c:/data {{/code}} para descomentar la línea:
103
104 {{code language="text"}}
105 digdash.appdata=C:/appdata
106 {{/code}}
107
108 (% class="box warningmessage" %)
109 (((
110 Cuidado a usar solo //slash //"**/**", o dos// anti-slash// "**~\~\**".
111 )))
112
113 Si este directorio no existe, DigDash Enterprise lo crea. Los datos no se almacenan directamente en este directorio, pero en subdirectorios para cada uno de los dominios.
114
115 * {{code language="text"}}<digdash.appdata>/Enterprise Server/<dominio>{{/code}}
116 * {{code language="text"}}<digdash.appdata>/Enterprise Administrator{{/code}}
117 * {{code language="text"}}<digdash.appdata>/ldapdigdash{{/code}}
118
119 **Ventaja**: La configuración se hace al nivel del archivo **digdash.properties**, y pues no será borrada durante una actualización de DigDash Enterprise con el despliegue de nuevos archivos WAR.
120
121 **Inconveniente**: Esta configuración es global por el Tomcat de DigDash Enterprise, así que todos los dominios de DigDash de su servidor serán concernidos esta configuración.
122 Sin embargo, los datos de los diferentes dominios DigDash Enterprise desplegados en este Tomcat tienen sus subdirectorios propios, así que no hay riesgos de destrucción de datos.
123
124 === Directorio diferente para cada dominio ===
125
126 Archivo modificado: {{code language="text"}}digdash.properties{{/code}}
127
128 La variable {{code language="text"}}<dominio>.AppDataPath{{/code}}  definida en este archivo tiene el mismo comportamiento que la variable global descrita antes.
129 La diferencia es que esta configuración es específica por un dominio  DigDash Enterprise.
130
131 Para definir un directorio de los datos especifico a un dominio, modifica el parámetro  {{code language="text"}}AppDataPath{{/code}} prefijado por el nombre del dominio.
132
133 Si tiene un dominio {{code language="text"}}ddenterpriseapi_dev{{/code}}, la variable será a especificar así:
134
135 {{code language="text"}}
136 ddenterpriseapi_dev.AppDataPath=C:/appdata_dev
137 {{/code}}
138
139 **Ventajas**:
140
141 * Configuración especifica a un dominio
142 * Archivo externo de los WAR
143
144 **Inconveniente**: Esta configuración se debe reproducir para cada dominio.
145
146 = Arranque y apagado manual de DigDash Enterprise =
147
148 En el caso donde DigDash no está instalado como servicio Windows.
149
150 == Arranque de DigDash Enterprise ==
151
152 Abra el directorio de instalación de DigDash Enterprise, y luego haga un doble clic en el archivo **start_tomcat.bat**.
153
154 El primer arranque del servidor puede tardar unos minutos porque las aplicaciones web están desplegándose
155
156 == Apagado de DigDash Enterprise ==
157
158 Abra el directorio de instalación de DigDash Enterprise, y luego haga un doble clic en el archivo **stop_tomcat.bat**.
159
160 = Instalación como servicio Windows =
161
162 La instalación como servicio Windows se debe hacer con un usuario teniendo derechos de administración Windows en el servidor en cuestión.
163
164 (% class="box warningmessage" %)
165 (((
166 Asegúrese de haber comprobado y modificado los parámetros importantes explicados más arriba en esta página //**__antes__**// de instalar el servicio. 
167 Si se modifica parámetros después, deberá instalar de nuevo el servicio (con el script **servers_install_service.bat**)
168 )))
169
170 == Instalación ==
171
172 * Inicie una consola de comandos (o símbolos del sistema) con los derechos de administración: 
173 ** Abra el menú de inicio
174 ** Busque "**CMD**" o "**Símbolos del sistema**"
175 ** Haga un clic derecho sobre la consola de comandos y seleccione "Ejecutar como administrador"
176 * Ubíquese en el directorio **<DD Install>\configure** y después teclee el comando **servers_install_service.bat** en Windows 64 bits.
177 * El servicio «Tomcat 9» es instalado (o con el nombre personalizado elegido).
178 * El servicio es instalado en lanzamiento manual de manera predeterminada. Para cambiar este comportamiento, se necesita abrir el gestor de servicios Windows y cambiar las propiedades del nuevo servicio. También, en este mismo gestor, compruebe que el usuario ejecutando el servicio es bien configurado.
179
180 == Arranque ==
181
182 La aplicación **Servicios** permite gestionar todos los servicios instalados. 
183 En esta lista, haga un clic derecho en su servicio (//Tomcat 9// por defecto) y luego haga clic en **Iniciar**
184 Una vez el servidor encendido, la página de inicio será accesible (http:~/~/localhost:8080 por defecto).