Manual de Instalación
Director
...
DIRECTOR - Manual de instalación 1.1.X
Índice |
---|
...
Painel | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||
|
...
|
Painel | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
...
- Iniciar sesión en el sistema operativo
- Ingresar a la carpeta {DIRECTORIO_INSTALACION}/director/bin
- Ejecutar uno de los archivos según el sistema operativo:
- stop-director.cmd (Windows)
- stop-director.sh (Linux)
...
11. Instalar Director como servicio
- Iniciar sesión en el sistema operativo
- Ingresar a la carpeta {DIRECTORIO_INSTALACION}/director/bin
- Ejecutar uno de los archivos según el sistema operativo:
- install-service.cmd (Windows)
- install-service.sh (Linux)
El servicio se creará con el nombre DirectorServer
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Director provee una consola web por la cual se pueden realizar distintas funciones, como ser:
...
Finalizada la inicialización del sistema y accediendo a la URL mencionada, se visualizará la pantalla de login:
Pantalla de Login
Âncora | ||||
---|---|---|---|---|
|
...
12.1 Primer Inicio de Sesión
Director concede por defecto una cuenta de acceso a la consola de administración que debe ser cambiada cuando se ingresa a la misma por primera vez.
El formulario de Login solicitará los datos de la cuenta por defecto:
...
Este usuario tendrá los permisos necesarios para poder gestionar los usuarios del sistema.
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
...
13. Configuración Inicial del Sistema
A continuación se detallan todas las propiedades y variables de configuración de Director.
...
Nota |
---|
Nota: Para conocer cómo modificar las propiedades, por favor dirigirse al documento "VTOL Core - Manual de usuario.pdf". |
Âncora | ||||
---|---|---|---|---|
|
...
14. Puertos
Se detallan a continuación los puertos con los que opera el sistema.
...
Nota |
---|
Nota: los puertos aquí señalados son valores por defecto y dependerán de la configuración finalmente elegida. |
Âncora | ||||
---|---|---|---|---|
|
...
15. Logeo del sistema
El sistema generará trazas de log en la siguiente carpeta:
...
- el server.log, guarda información específica de la aplicación DIRECTOR
- el catalina.log, guarda información específica del contenedor
- el localhost_access_log.log, guarda información específica de accesos de la aplicacion (todas las solicitudes como http)
- el host-manage.logr, guarda información específica de eventos de la aplicación “manager”
- el manager.log, guarda información específica de la aplicación “host_manager”
- stacktrace.log, guarda información específica de excepciones de la aplicación
...
15.1 Configuración
para configurar el server.log se debe modificar el file vtol-log4j.xml, el cual encontraremos en: {
DIRECTORIO_INSTALACION
}\tomcat\webapps\director\WEB-INF\classes\
...
Aviso |
---|
cuando se hace una re-instalación completa del sistema, la configuración de logeo se pierde, por lo tanto se recomienda realizar un backup previo a la instalación. |
...
16. Configuración adicional del sistema
...
16.1 Memoria
Para administrar la memoria del Director Server se debe crear un archivo setenv.bat (windows) o sentenv.sh (linux) en "[Instalación de Director Server]\tomcat\bin" con el siguiente contenido
...
Nota |
---|
Se debe configurar los parámetros mínimos y máximos de memoria según recomendación de NAPSE ya que depende de la cantidad total de aplicación monitoreadas, cantidad de usuarios de la aplicación, etc. Adicionalmente, los parámetros xms, xmx pueden variar según la JVM (Java Virtual Machine) utilizada. Para mayor referencia consultar la documentación del fabricante de la JVM utilizada. |
...
16.2 Soporte
...
16.2.1 Utilización de JConsole
JConsole es una utilidad de la JVM de Sun que permite monitorear el funcionamiento en real time de una aplicación Java, como ser la memoria utilizada, los thread, procesador, etc
...
- identificar el PID del proceso Director Server
- abrir un shell con privilegios de administrador
- ejecutar el comando jconsole PID, donde PID es el número de proceso identificado en el paso 1
...
16.2.2 Captura de Thread Dump y Memory dump
- Identificar el PID de la aplicación JAVA
- Abrir un SHELL con privilegios de administrador
- Ejecutar los siguientes comandos
...
5. compartir para su análisis
Âncora | ||||
---|---|---|---|---|
|
...
17. Anexo
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
...
17.1 Instalación de Git
En este anexo se mencionarán los pre-requisitos y la explicación de cómo instalar los softwares de control de versiones Git.
...
- Si el sistema operativo es Windows, se instalará Bonobo (apartado 15.1.1 Bonobo Git Server)
- Si el sistema operativo es Linux, se instalará GitLab (apartado 15.1.2 GitLab)
Âncora | ||||
---|---|---|---|---|
|
...
17.1.1 Bonobo Git Server
1617.1.1.1 Pre-requisitos
Los requisitos previos para instalar Bonobo Git Server son:
- Servicios de Internet Information Services (IIS) 8
- .NET Framework 4.6 ( para Windows 7 Service Pack 1; Windows 8; Windows 8.1; Windows Server 2008 R2 SP1; Windows Server 2008 Service Pack 2; Windows Server 2012; Windows Server 2012 R2; Windows Vista Service Pack 2). (Windows 11 puede ya tenerlo incluido)
- Windows 10 con ASP.NET habilitado
...
- Ingresar a la página de "Centro de Descargas" de Microsoft y buscar el componente "Microsoft .NET Framework 4.6 (instalador Web) para Windows Vista SP2, Windows 7 SP1, Windows 8, Windows 8.1, Windows Server 2008 SP2 Windows Server 2008 R2 SP1, Windows Server 2012 and Windows Server 2012 R2"
- Seleccionar el idioma y presionar el botón "Descargar"
- Un archivo ejecutable se descargará localmente, abrirlo y seguir las instrucciones del asistente gráfico de instalación
- Aguardar a que se instalen los componentes y cerrar el instalador
1617.1.1.2 Instalación de Bonobo Git Server
...
- Nombre de usuario: admin
- Contraseña: admin
Âncora | ||||
---|---|---|---|---|
|
...
17.1.2 GitLab
1617.1.2.1 Instalación de GitLab
...
- Se debe cargar un SCHEME cuando se selecciona el motor de base de datos Oracle
- La instalación se debe realizar sobre un directorio el cual el usuario que instalará posea permisos de lectura y escritura
- Para iniciar Director, el usuario debe tener permisos de:
- lectura sobre el directorio de instalación
- ejecución sobre los archivos con extensión SH
- escritura sobre el directorio tomcat
- Al crear un repositorio, se debe crear un archivo inicial para inicializar el repositorio
17.2 Agregar certificados a la Consola
Para agregar un certificado “.jks” a la consola de Director, se necesita guardar el “.jks” en la carpeta conf del tomcat donde se encuentra la instalación de Director Server${directorioInstalacionDirector}\tomcat\conf y configurar el mismo dentro del conf.xml que se encuentra en la sección:
Y en ese connector agregar también el tag ciphers y el sslEnabledProtocols donde se indica seguridad.
Quedando de la siguiente manera:
Bloco de código |
---|
<Connector protocol="org.apache.coyote.http11.Http11NioProtocol"
port="8490" maxThreads="200"
scheme="https" secure="true"
SSLEnabled="true" keystoreFile="conf/director.jks" keystorePass="nosotros"
clientAuth="false"
ciphers="TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,
TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA,
SSL_RSA_WITH_3DES_EDE_CBC_SHA"
sslProtocol="TLS"
sslEnabledProtocols="TLSv1.2"/>
|
18. Configurar Servidor SMPT
Para que Director pueda realizar el envío de mails, se deben realizar la siguientes configuraciones:
Abrir el archivo mail.groovy que se encuentra en el siguiente directorio:
Directorio |
---|
<directorio_instalación>\tomcat\conf |
En el archivo mail.groovy editar las siguientes propiedades:
...