Código fuente wiki de Guide d'installation Windows
Última modificación por jhurst el 2021/11/15 09:22
Mostrar los últimos autores
author | version | line-number | content |
---|---|---|---|
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). |