Heinsohn Nómina Manual Proceso de Actualización V2 Servidor App Linux Manual de Actualización del sistema Heinsohn Nómina Contenido 1. Introducción.................................................................................................................. 3 2. Requisitos Previos ........................................................................................................ 3 3. Actualización Heinsohn Nómina.................................................................................... 4 3.1 Descargar Ejecutable de actualización ....................................................................... 4 3.2 Configuraciones Previas a actualización ..................................................................... 7 3.3 Actualización ............................................................................................................ 10 3.3.1 Ejecución de actualización .................................................................................. 10 3.4 4. Archivos Resultantes ................................................................................................ 15 Listado de comandos.................................................................................................. 15 Cliente Heinsohn Business Technology Página 2 de 15 Manual de Actualización del sistema Heinsohn Nómina 1. Introducción El presente documento explica los pasos a seguir para realizar la actualización de versión de la aplicación Heinsohn Nómina con el ejecutable de actualización. Es importante tener presente que durante esta actividad la aplicación no estará disponible para su uso habitual en la web. 2. Requisitos Previos Antes de realizar el proceso de actualización, se deben tener en cuenta los siguientes prerrequisitos: Leer todo el manual antes de cualquier ejecución. El procedimiento de actualización se debe realizar solamente en el servidor de aplicaciones. Se debe tener conexión a Internet en el servidor y adicionalmente conexión al FQDN ( heinsohnsftp.brickftp.com ) por el puerto 22. Se debe tener instalada una versión Java 7 o posterior en el servidor. Se debe generar copia o Backup de la(s) Bases de datos implementadas para el sistema Heinsohn Nómina. Se recomienda crear un directorio para alojar el Wizard (genera numerosos archivos en el proceso) Al realizar la ejecución del Wizard, este debe ser ejecutado con privilegios de Administrador local del servidor. En caso de tener dudas con el proceso, debe ser reportado un caso o ticket a través de la Mesa de Servicio. Cliente Heinsohn Business Technology Página 3 de 15 Manual de Actualización del sistema Heinsohn Nómina 3. Actualización Heinsohn Nómina 3.1 Descargar Ejecutable de actualización Para descargar el Wizard de actualización debemos realizar el siguiente procedimiento: Debemos ingresar a la siguiente URL, del servicio SFTP de Heinsohn Nómina URL (Cualquier navegador): https://heinsohnsftp.brickftp.com URL (Desde FileZilla, WinSCP, etc): sftp://heinsohnsftp.brickftp.com Usuario: HeinsohnHCM Contraseña: 12H3ins0hn34$% Figura 1: Ingreso a SFTP mediante navegador Chrome Una vez dentro, ingresamos a la ruta /Versiones/Instaladores/Linux/Instalador y descargamos su contenido en el cual se encuentran los siguientes archivos: checkSumHCM.ctq HeinsohnHCM_Update.sh listVersiones.hcm InstallHCM.jar Cliente Heinsohn Business Technology Página 4 de 15 Manual de Actualización del sistema Heinsohn Nómina Figura 2: Descarga de ejecutable y archivos de actualización. Una vez descargado el ejecutable, en caso de que no se tenga instalado o se tenga una versión inferior a Java 7, procedemos a descargar java que se encuentra en la ruta /Versiones/Instaladores/Linux para poder realizar la ejecución de la actualización. Figura 3: Descarga de Java desde el SFTP. Cliente Heinsohn Business Technology Página 5 de 15 Manual de Actualización del sistema Heinsohn Nómina Nos conectamos al servidor de aplicaciones (en este caso con SO Linux) desde una herramienta de transferencia de archivos (ejemplo: FileZilla), para pasar al servidor el ejecutable y el java para la ejecución. Cabe recordar que, para tener un orden en el proceso se debe crear un directorio en la raíz del directorio principal del sistema Heinsohn Nómina (Ej: /nomina/actualizador, donde /nomina es el directorio raíz del sistema y /actualizador es el directorio creado para alojar el ejecutable de actualización). Figura 4: Creación de directorio para alojar archivos de actualización. Cliente Heinsohn Business Technology Página 6 de 15 Manual de Actualización del sistema Heinsohn Nómina Por último, transferimos los archivos descargados al directorio creado recientemente en el servidor de aplicaciones (/nomina/actualizador). Figura 5: Trasferencia de archivos al servidor de aplicaciones para actualización. 3.2 Configuraciones Previas a actualización Para realizar la ejecución del proceso de actualización, debemos tener en cuenta el siguiente procedimiento: Procedemos a realizar conexión mediante SSH al terminal del SO Linux. Podemos ingresar con la herramienta PuTTY Una vez abierto PuTTY, procedemos a ingresar la dirección IP del servidor. Dentro de la consola, nos solicitará el usuario y la contraseña (se debe ingresar con un usuario administrador). Cliente Heinsohn Business Technology Página 7 de 15 Manual de Actualización del sistema Heinsohn Nómina Figura 6: Ingreso al Shell de Linux mediante PuTTY. Nos ubicamos en el directorio raíz del sistema y nos dirigimos al directorio donde transferimos los archivos para la actualización (consultar: Listado de comandos). Figura 7: Listado de archivos para ejecución de actualización. Cliente Heinsohn Business Technology Página 8 de 15 Manual de Actualización del sistema Heinsohn Nómina Como podemos observar, el java que descargamos está comprimido y empaquetado por lo que debemos realizar la descompresión de este mismo como se muestra en la Figura 8. (consultar: Listado de comandos). Figura 8: Método de descompresión de un archivo tar.gz. Una vez se tenga descomprimido, listamos y observamos que ya se tiene el directorio donde se encuentra Java. Nos dirigimos al directorio /nomina/actualizador/jdk1.8.0 y ejecutamos el siguiente comando ( pwd ) para que nos muestre la ubicación actual (consultar: Listado de comandos): Figura 9: Directorio JAVA_HOME. Una vez se tenga copiada la ruta, procedemos a ejecutar los siguientes comandos para especificar el Java en las variables de entorno del sistema operativo (consultar: Listado de comandos). Figura 10: Definición de variables de entorno $JAVA_HOME. Cliente Heinsohn Business Technology Página 9 de 15 Manual de Actualización del sistema Heinsohn Nómina 3.3 Actualización 3.3.1 Ejecución de actualización Cuando se tengan definidas las variables del sistema y todos los archivos solicitados, procedemos a ejecutar el proceso de actualización. Para lo cual procedemos a ejecutar las siguientes instrucciones (consultar: Listado de comandos): Figura 11: Ejecución de actualización. Nos confirmará si deseamos continuar con el proceso. Escribimos 1 y enter. Figura 12: Confirmación de proceso de actualización. Nota: Si se encuentra en la versión previa a la última versión liberada por Heinsohn la siguiente imagen no aparecerá dado que el Wizard da por entendido que se actualizará a la última versión liberada por Heinsohn. Figura 13: Seleccionar la opción a actualizar – Generalmente Actualizar Todo. Cliente Heinsohn Business Technology Página 10 de 15 Manual de Actualización del sistema Heinsohn Nómina Elegimos que elementos deseamos quitar de la actualización, en este caso se deben actualizar todos los elementos. Escribimos N. Por el contrario, si se actualiza a la última versión seleccionamos 4para actualizar todo o según corresponda. Figura 14: Selección de elementos a actualizar. Nos solicitará la conexión a la Base de datos la cual ingresamos de la siguiente manera: Figura 15: Configuración de conexión a Base de datos. En URL, nos dirigimos a la ruta donde se encuentra el archivo del datasource del aplicativo (Por defecto: /nomina/jboss-6.1.0.Final/server/default/deploy y abrimos con el comando nano el archivo NominaWEB-ds.xml) y copiar la url que se encuentra dentro del parámetro <connection-url> </connection-url>. (Ver Listado de comandos) Figura 16: URL de conexión a Base de datos. Cliente Heinsohn Business Technology Página 11 de 15 Manual de Actualización del sistema Heinsohn Nómina o En Usuario, ingresamos el usuario de la Base de datos. o En Contraseña, la clave del usuario de Base de datos. Una vez ingresados los datos, deben quedar de la siguiente manera. También observamos que muestra la versión actual en la que se encuentra la Base de datos. Figura 17: Ejemplo de conexión a Base de datos. En caso de que tengan más compañías en bases de datos independiente, se debe adicionar cada una de las URLs por Base. Si se desea adicionar otra conexión, escribimos S, de lo contrario N. Figura 18: Listado de conexiones configuradas y versión actual de las mismas. Cliente Heinsohn Business Technology Página 12 de 15 Manual de Actualización del sistema Heinsohn Nómina Nos solicitará confirmar si deseamos actualizar con las conexiones creadas. Escribimos S. Figura 19: Confirmación de conexiones configuradas. Una vez confirmado, nos solicitará la ruta del servidor Jboss la cual debemos agregar (Ejemplo: /nomina/jboss-6.1.0.Final). Figura 20: Conexión a Servidor Jboss exitoso y versión actual del mismo. Ya ubicada la ruta del servidor de aplicaciones, nos mostrará la versión en que actualmente se encuentra el sistema Heinsohn Nómina, elementos a actualizar y requisitos previos (Cabe recordar que antes de ejecutar la actualización, debemos generar copia de las bases de datos que se implementen para el sistema, así como se menciona en los Prerrequisitos). Para proceder con la actualización de la siguiente versión. Escribimos la letra “S” y damos Enter para iniciar la actualización. Figura 21: Advertencias previas a instalación de versión. Cliente Heinsohn Business Technology Página 13 de 15 Manual de Actualización del sistema Heinsohn Nómina Una vez finalizado el proceso de actualización, nos genera el siguiente mensaje y nos confirma que el sistema Heinsohn Nómina se encuentra iniciando. Figura 22: Instalación de versión exitosa. Cabe recordar que el mensaje marcado indica que no se puede proceder a ejecutar la proxima versión, debido a que el proceso es local y se debe ejecutar nuevamente el wizard para la actualización. Figura 23: Advertencia para ejecución de siguiente versión. Cliente Heinsohn Business Technology Página 14 de 15 Manual de Actualización del sistema Heinsohn Nómina 3.4 Archivos Resultantes El Wizard de actualización se encarga de enviar un correo a Heinsohn notificando que el proceso de actualización fue ejecutado de manera exitosa, sin embargo, este procedimiento puede fallar por varias razones como: datos incorrectos en la configuración del servidor de correo, usuario o password incorrecto que se tiene en el aplicativo configurado para enviar notificaciones, etc. Respecto a lo indicado anteriormente si falla el proceso de envío de resultados, debemos enviar el directorio de log con su contenido generado en la ruta /nomina/actualizador de manera manual mediante un caso en la mesa de servicio. Figura 24: Archivos con resultados de actualización 4. Listado de comandos A continuación, se encuentra una lista con comandos Linux implementados para el proceso de actualización del sistema Heinsohn Nómina: Descripción Comando Dirigirse al directorio raíz del sistema cd / Dirigirse al directorio de actualización cd /nomina/actualizador Descomprimir archivo tar.gz tar -xzvf jdk8.tar.gz Definir variable de entorno JAVA_HOME export JAVA_HOME="/ruta/de/jdk1.8.0" Definir variable de entorno PATH export PATH=$JAVA_HOME/bin:$PATH Ver ruta de variable JAVA_HOME echo $JAVA_HOME Ejecución de actualización source HeinsohnHCM_Update.sh Ver proceso de ejecución del jboss ps aux | grep java Ruta por defecto de jboss /nomina/jboss-6.1.0.Final Edición Datasource nano NominaWEB-ds.xml Figura 25: Tabla con comandos implementados en el proceso de actualización. Cliente Heinsohn Business Technology Página 15 de 15
