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 ...................................................................................................................... 2
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 Actualización Modo Online ................................................................................ 14
3.5 Archivos Resultantes ......................................................................................... 15
4. Listado de comandos...................................................................................................... 15

1. Introducción

Cliente  Heinsohn Business Technology Página 2 de 16

 Manual de Actualización del sistema Heinsohn Nómina

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 16

 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: Asdf1234$%

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 16

 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 16

 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 16

 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 16

 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 16

 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 16

 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 12: Ejecución de actualización.

• Nos confirmará si deseamos continuar con el proceso. Escribimos 1 y enter.

Figura 13: Confirmación de proceso de actualización.

• Elegimos la versión siguiente a ejecutar, en este ejemplo seleccionaremos

NominaGH_HBT_V5.01.001.zip. Escribimos 2 y enter.
• Nota: Si se encuentra en la versión previa a la Ultima 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 15: Selección de versión a ejecutar. o El

Cliente  Heinsohn Business Technology Página 10 de 16

 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 4 para actualizar todo o según
corresponda.

Figura 16: Selección de elementos a actualizar.

• Nos solicitará la conexión a la Base de datos la cual ingresamos de la siguiente manera:

Figura 17: Configuración de conexión a Base de datos.

o En URL, nos dirigimos a la ruta donde se encuentra el archivo del datasource del aplicativo
(Ejemplo: /nomina/jboss-6.1.0.Final/server/default/deploy y abrimos con un editor de texto el
archivo NominaWEB-ds.xml) y copiar la url que se encuentra dentro del parámetro
<connection-url> </connection-url>. (Ver Listado de comandos)

Cliente  Heinsohn Business Technology Página 11 de 16

 Manual de Actualización del sistema Heinsohn Nómina

Figura 18: URL de conexión a Base de datos.

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 19: 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 20: Listado de conexiones configuradas y versión actual de las mismas.

• Nos confirmará si deseamos actualizar con las conexiones creadas. Escribimos S.

Cliente  Heinsohn Business Technology Página 12 de 16

 Manual de Actualización del sistema Heinsohn Nómina

Figura 21: 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 22: 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 23: Advertencias previas a instalación de versión.

• 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.

Cliente  Heinsohn Business Technology Página 13 de 16

 Manual de Actualización del sistema Heinsohn Nómina

Figura 24: 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 25: Advertencia para ejecución de siguiente versión.

3.4 Actualización Modo Online

Cuando el proceso es en modo Online no es necesario descargar los paquetes de cada versión ya que él se
conecta y los descarga automáticamente por lo que se debe tener conexión con el sFTP por el puerto 22
desde el servidor de aplicaciones (Ver Requisitos Previos), se debe indicar Modo Online como se muestra a
continuación y seguir el paso a paso de ejecución, configuración e instalación (Ver Ejecución de actualización).

Cliente  Heinsohn Business Technology Página 14 de 16

 Manual de Actualización del sistema Heinsohn Nómina

Figura 26: Actualización Modo Online.

3.5 Archivos Resultantes

El ejecutable 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 correos, el usuario 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 o su contenido generado en la ruta
/nomina/actualizador de manera manual a la siguiente cuenta, primernivelhn@heinsohn.com.co:

Figura 27: 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

Cliente  Heinsohn Business Technology Página 15 de 16

 Manual de Actualización del sistema Heinsohn Nómina

Descomprimir archivo tar.gz tar -xzvf jdk8.tar.gz

Definir variable de entorno JAVA_HOME
Definir variable de entorno PATH
Ver ruta de variable JAVA_HOME
Ejecución de actualización
Ver proceso de ejecución del jboss
Ruta por defecto de jboss
Edición Datasource
Figura 28: Tabla con comandos implementados en el proceso de actualización.
export JAVA_HOME="/ruta/de/jdk1.8.0"
export PATH=$JAVA_HOME/bin:$PATH
echo $JAVA_HOME
source HeinsohnHCM_Update.sh ó
. HeinsohnHCM_Update.sh (con un punto al
inicio)
ps aux | grep java
/nomina/jboss-6.1.0.Final
nano NominaWEB-ds.xml ó
vi NominaWEB-ds.xml

Cliente  Heinsohn Business Technology Página 16 de 16