Instalación AdoptOpenJDK 8 y acceso a Libertya mediante LYStart Instalacion Puesto de trabajo 2026
Libertya ERP
AdoptOpenJDK 8 y acceso a Libertya mediante LYStart
Indice
- Libertya ERP
- Indice
- Introducción
- Java
- Libertya Start
- Aplicativo wget
- OpenSSL
- Variables de entorno
- Iniciando LY
- Acceso remoto
- Configuración para uso de impresoras fiscales Hasar 2G
- Relevamiento de información en puestos de trabajo
- Verificación final del puesto
Introducción
El presente documento abarca los pasos necesarios para la puesta en marcha u optimización de un puesto de trabajo con Libertya ERP.
Java
Para la correcta ejecución de Libertya, es necesario contar con Java 8. Para ésto, se debe descargar la versión adecuada según el sistema operativo que se esté utilizando.
Previo a la instalación de OpenJDK 8, se recomienda eliminar otras versiones de Java a fin de evitar potenciales conflictos, incluyendo la desinstalación de Oracle Java 8 si es que se encuentra instalada en el equipo.
Desde un navegador web, acceder a:
Se deberá indicar el Sistema Operativo (Windows / Linux) y la Arquitectura (x86 para 32bits / x64 para 64bits). En Tipo de paquete dejar especificado JDK, y en Versión 8-LTS.
En los siguientes apartados se detalla la instalación para Windows y Linux. Para equipos con Windows, descargar la versión instalable dado que es más sencillo. Simplemente es necesario seguir el paso a paso hasta completar la instalación. Cómo directorio destino base especificar C:\Java, quedando así el path completo en por ejemplo C:\Java\OpenJDK8U_8u372b07 (dependiendo la versión descargada). Para Linux, descargar el archivo .gz y descomprimirlo en /opt, quedando el path completo por ejemplo en /opt/OpenJDK8U_8u328b07 (nuevamente, dependiendo la versión descargada).
Instalación de AdoptOpenJDK 8 en Windows
Para Windows, ejecutar el instalador descargado y seguir paso a paso, seleccionando las primeras tres opciones (Añadir al PATH, Asociar .jar y Establecer la variable JAVA_HOME).
Como destino de instalación, especificar C:\Java\jdk-VERSION\ (donde VERSION corresponde al número de versión de Java que se está instalando), evitando utilizar espacios. Ej: C:\Java\jdk-8.0.302.8-hotspot
Instalación de AdoptOpenJDK 8 en Linux
Una vez descargado el archivo, el mismo debe descomprimirse y extraerse. En este ejemplo suponemos que la descarga del archivo OpenJDK8U-jdk_x64_linux_hotspot_8u252b09.tar.gz se efectuó en ~/Descargas y que ubicaremos los binarios de la JVM en /opt.
cd /opt
gunzip OpenJDK8U-jdk_x64_linux_hotspot_8u252b09.tar.gz
tar -xvf OpenJDK8U-jdk_x64_linux_hotspot_8u252b09.tar
Esto dejará la versión de Java lista para ser utilizada en /opt/jdk8u252-b09.
Configuración de seguridad
Para que Libertya pueda ejecutarse es necesario configurar la IP y puerto del servidor de Libertya en la Lista de excepciones de sitios de la pestaña Seguridad en el Panel de Control de Java.
Para ello, en Windows se debe acceder desde Panel de Control - Java, en Linux ejecutando desde consola el comando ControlPanel y presionar en la pestaña Seguridad.
Luego presionar Editar lista de sitios - Agregar e ingresar la URL completa (incluyendo el puerto) del servidor de Libertya: http://<ip-servidor>:8080. Finalmente presionar Enter para agregar y presionar Continuar en la advertencia de seguridad que se muestra.
Para concluir presionar Aceptar en la venta de Listas de excepciones de sitios y en el Panel de Control de Java.
Libertya Start
Libertya Start es la manera recomendada de acceder al cliente de escritorio de Libertya garantizando que siempre se esté utilizando la versión de Libertya alojada en el servidor.
Ante cada inicio de Libertya, Libertya Start valida si existe una nueva versión de los binarios y en ese caso realiza la descarga de los archivos correspondientes previo al inicio de la aplicación.
Para obtener este archivo, desde un navegador web acceder a:
- IP_DEL_SERVIDOR:8080/libertya.html
En donde IP_DEL_SERVIDOR deberá reemplazarse por la IP del servidor dependiendo de la sucursal en la que se encuentre. Consultar con el soporte de Libertya el valor a especificar en este campo dependiendo la sucursal en la que se encuentre realizando la actividad.
Existen 2 versiones distintas de Libertya Start, una para equipos con sistema operativo Linux y otra para equipos con sistema operativo Windows. Dependiendo el sistema operativo utilizado, se descargará un archivo LYStart.bat (Windows) o un archivo LYStart.sh (Linux, en donde se deberán habilitar los permisos de ejecución).
Una vez descargado el archivo, moverlo a su ubicación definitiva, por ejemplo:
- C:\Libertya (Windows)
- /opt/Libertya (Linux)
IMPORTANTE: Previo a ejecutar Libertya Start se requerirá contar con la aplicación wget y definir además variables de entorno tal como se detalla a continuación en los siguientes apartados.
IMPORTANTE: Siempre inicie la aplicación mediante LYStart.sh (o LYStart.bat) a fin de garantizar que cualquier nueva versión de los binarios de Libertya alojados en el servidor sea descargada. En caso de generar un acceso directo en el escritorio, tanto en Windows como en Linux, el mismo debe apuntar a uno de estos archivos, dependiendo el sistema operativo.
Aplicativo wget
A fin de utilizar Libertya Start se requiere contar con wget instalado.
En sistemas operativos Linux ya se encuentra instalado por defecto con lo cual no se requiere realizar ninguna actividad adicional. En Windows se requiere su instalación.
Descargar el instalador desde:
Una vez descargado, instalarlo en la ruta C:\wget
Finalizada la instalación, el ejecutable wget.exe quedará ubicado en C:\wget\bin\
OpenSSL
Previo a la utilización de Libertya, se requiere instalar OpenSSL, el cual es un paquete de herramientas de administración y bibliotecas relacionadas con la criptografía. En Linux esta herramienta ya se encuentra instalada.
Para Windows descargar el instalador desde:
Ejecutar el instalador, indicando como directorio destino C:\openssl
Finalizada la instalación, el ejecutable openssl.exe quedará ubicado en C:\openssl\bin\
Variables de entorno
Es necesario gestionar las variables de entorno que se detallan a continuación. La forma de gestionar las variables de entorno dependerá del sistema operativo.
Gestion de variables de entorno bajo Windows
Para Windows, se debe acceder al Panel de control y luego hacer clic en Configuracion Avanzada del Sistema.
Se abrirá la ventana Propiedades del sistema. Hacer click en Variables de entorno. Esto abrirá la ventana correspondiente.
 | → |  |
|---|
Bajo el apartado Variables del sistema, se deberán definir o modificar allí las variables de entorno que correspondan.
Gestion de variables de entorno bajo Linux
Bajo Linux se pueden especificar por ejemplo en el archivo /etc/profile. Por ejemplo:
export JAVA_HOME=/opt/OpenJDK8U-jdk_x64_linux_hotspot_8u372b07
export OXP_HOME=/opt/Libertya/ClienteLBY
export PATH=:$PATH
Variables de entorno a configurar
OXP_HOME
Esta variable debe apuntar al directorio de Libertya, dependiendo la ubicación de Libertya Start, incorporando el directorio ClienteLBY al final de la ruta. Ejemplos:
| Ubicación de archivo LYStart.bat (Windows) | OXP_HOME |
|---|---|
| C:\Libertya | C:\Libertya\ClienteLBY |
| Ubicación de archivo LYStart.sh (Linux) | OXP_HOME |
|---|---|
| /opt/Libertya | /opt/Libertya/ClienteLBY |
JAVA_HOME
Esta variable debe apuntar al directorio base de Java, dependiendo la ubicación de instalación. Ejemplos:
| Ubicación base de Java (Windows) | JAVA_HOME |
|---|---|
| C:\Java\OpenJDK8U_8u372b07 | C:\Java\OpenJDK8U_8u372b07 |
| Ubicación base de Java (Linux) | JAVA_HOME |
|---|---|
| /opt/OpenJDK8U-jdk_x64_8u372b07 | /opt/OpenJDK8U-jdk_x64_8u372b07 |
OPENSSL_HOME
Esta variable debe apuntar al directorio donde se encuentran los binarios de openssl (carpeta bin).
| Ubicación base de openssl (Windows) | OPENSSL_HOME |
|---|---|
| C:\openssl | C:\openssl\bin |
PATH
Esta variable de entorno probablemente ya exista y deba ser ampliada para que el entorno encuentre los aplicativos java, wget.y openssl.
Si estos programas fueron instalados con un instalador, probablemente dicha variable de entorno ya haya sido ampliada. Se recomienda verificar la correcta configuración de dicha variable de entorno, considerando que el ejecutable de cada aplicación se encuentra en el subdirectorio bin. Ejemplos:
| Ubicación ejecutables | PATH |
|---|---|
| C:\openssl\bin C:\wget\bin C:\Java\jre1.8.0_202\bin | C:\openssl\bin;C:\wget\bin\;C:\Java\jre1.8.0_202\bin;…(resto de PATH)… |
NOTA: En Linux solo se requiere ampliar el PATH para Java, no así para openssl o wget.
Iniciando LY
IMPORTANTE: Siempre inicie la aplicación mediante LYStart.sh (o LYStart.bat) a fin de garantizar que cualquier nueva versión de los binarios de Libertya alojados en el servidor sea descargada. En caso de generar un acceso directo en el escritorio, tanto en Windows como en Linux, el mismo debe apuntar a uno de estos archivos, dependiendo el sistema operativo.
En resumen, los accesos directos deben apuntar:
- Windows: LYStart.bat (no debe apuntar al archivo .exe)
- Linux: LYStart.bat
Al ejecutar LYStart por primera vez, se creará un directorio ClienteLBY y se descargarán allí los archivos necesarios desde el servidor Libertya, los cuales se utilizarán en cada inicio de Libertya hasta que LYStart detecte una nueva versión, reemplazando en ese momento los actuales archivos por los nuevos.
A fin de iniciar Libertya desde el cliente de escritorio conectando al servidor Libertya, es necesario hacer click en el ícono que se encuentra a la derecha del campo Servidor, tal como se muestra en la siguiente imagen de la ventana Entrada al Sistema:
Se presentará una ventana de Parámetros de conexión de Libertya:
En esta ventana es necesario realizar los siguientes pasos:
- En el campo Servidor de Aplicación indicar la IP correspondiente al servidor de la sucursal donde se está operando. Consultar con el soporte de Libertya el valor a especificar en este campo dependiendo la sucursal en la que se encuentre realizando la actividad.
- Hacer click en el botón Test de Aplicación. Los gráficos de los botones [Test de Aplicacion] y [Test de Base de datos] mostrarán un tilde indicando que la conexión fue exitosa. En caso de no obtener un tilde en este punto, favor de contactar al soporte de Libertya.
- Hacer click en el botón ubicado en la parte inferior derecha para confirmar la configuración. Esto nos llevará nuevamente a la ventana de Entrada al sistema, en donde deberá acceder al sistema como normalmente lo hace, especificando su nombre de usuario y contraseña de Libertya.
- Cabe mencionar que esta actividad en la ventana Parametros de Conexion Libertya solo es necesario realizarla una única vez por usuario de Libertya en cada puesto de trabajo.
En caso de presentarse problemas al hacer click en Test de Aplicación (punto 2) o al intentar acceder al sistema (punto 3), validar que el usuario tenga los permisos correspondientes para gestionar conexiones remotas, y que el firewall / antivirus no esté impidiendo la correcta interacción entre el cliente Libertya y el servidor.
Acceso remoto
Por políticas de seguridad, las aplicaciones tales como AnyDesk, TeamViewer, NoMachine deberán ser desinstalados de los puestos de trabajo, optando por conectividad remota mediante RustDesk dentro de la VPN.
Instalación RustDesk
La instalación de RustDesk está detallada en su propio documento.
IMPORTANTE: En algunos puestos de trabajo se producen problemas de red al intentar utilizar RustDesk aun cuando el ping responde y el servicio está activo.
Este problema normalmente se soluciona configurando el gateway corporativo directamente en los puestos de trabajo de la sucursal, de esta forma:
| route -p add 10.100.85.240 mask 255.255.255.255 <IP-Gateway-Corporativo> |
|---|
Configuración para uso de impresoras fiscales Hasar 2G
Libertya se comunica con el impresor fiscal a través de un aplicativo de Hasar denominado Spooler, que habitualmente abren en los puestos de este tipo antes de iniciar el TPV.
Además del spooler se necesitan algunas otras herramientas para configurar el puesto, se listan todas:
- WSPOOLER
- GETxxxAR
- HFL_TEST
Estas herramientas se pueden obtener desde la página oficial de Hasar:
https://compania.grupohasar.com/descargas/
Buscar el modelo, en este caso SMH/PT 250 F
Luego descargar el comprimido de herramientas para desarrolladores:
Una vez descomprimido, en la carpeta HERRAMIENTAS van a estar las tres mencionadas.
Configuracion de WSPOOLER
Colocar la carpeta del spooler en la ubicación C:\Hasar
Luego generar un archivo .bat para ejecutar el spooler, debera tener un contenido similar al siguiente, dependiendo la configuración de la PC.
| C:\Hasar\spooler\WINDOWS32\wspooler_v213.exe -p10 -k -o 3000 -l |
|---|
el parámetro -p indica el puerto serie utilizado por la fiscal y el ejecutable wspooler_v213.exe es el que se acaba de descomprimir, indicando la ruta completa. El resto se mantiene igual siempre.
Configuración de GETxxxAR
Libertya utiliza la herramienta GETxxxAR para realizar las presentaciones de DDJJ. Esta debe colocarse en C:\Hasar quedando asi:
C:\Hasar\GETxxxAR
Configuración con HFL_TEST
Colocar HFL_TEST en C:\Hasar. Esta herramienta sirve para realizar configuraciones en la fiscal, como verificar fecha y hora, cambiar dirección IP, etc…
Se ejecuta desde un cmd de la siguiente manera (ejemplo para puerto serie 10):
| C:\Hasar\HFL_TEST\hfl_test_CF.exe serial 10 |
|---|
Relevamiento de información en puestos de trabajo
Dirección IP
En equipos con sistema operativo Windows, abrir una consola DOS y ejecutar el comando
ipconfig
Identificar la sección dirección IPv4 y anotar en la planilla el número que aparece a la derecha, conformado, en el ejemplo 192.168.1.82.
En sistemas operativos Linux ejecutar una terminal del sistema operativo y ejecutar:
Ifconfig
Luego anotar el mismo dato indicado anteriormente.
Importante: en caso de que la IP esté asignada dinámicamente por DHCP, por favor aclararlo en la planilla de relevamiento.
Versión de JAVA
Para obtener la versión de JAVA instalada en el puesto, tanto en una ventana de comandos DOS de Windows como en una terminal en Linux ejecutar el comando:
Anotar en la planilla la versión del software que aparece entre comillas doble, en el ejemplo 1.8.0_232.
Versión de OpenSSL
Al igual que en el caso anterior, para obtener la versión de OpenSSL instalada tanto en una ventana de comandos DOS de Windows como en una terminal en Linux ejecutar el comando:
openssl version
En la planilla, anotar la versión informada luego de la palabra “OpenSSL”, en el ejemplo 1.1.1
Versión de wget
Al igual que en el caso anterior, para obtener la versión de wget instalada tanto en una ventana de comandos DOS de Windows como en una terminal en Linux ejecutar el comando:
wget –version
En la planilla, anotar la versión informada luego de la palabra “OpenSSL”, en el ejemplo 1.19.4
Sistema de facturación
Para los puestos de Caja o de Atención al cliente se debe informar qué Terminal TPV utilizan al realizar la apertura de Caja diaria.
Dicha información permitirá identificar la tecnología de facturación utilizada en cada puesto.
Verificación final del puesto
Para dar como concluida la actividad de actualización y configuración del puesto de trabajo Libertya, se deben realizar las siguientes verificaciones:
- ☐ Libertya Start
- [ ] Verificación de las Variables de entorno (JAVA_HOME, OXP_HOME y PATH)
- [ ] En caso de incorporar acceso directo en el escritorio, debe apuntar a LYStart.sh / LYStart.bat
- [ ] Correcta ejecución de LYStart
- [ ] Test de aplicación Libertya de OK - ☐ Acceso remoto al equipo
- [ ] Aplicaciones de acceso remoto desinstaladas (Teamviewer, AnyDesk, etc.)
- [ ] VNC Funcional - ☐ Relevamiento de datos completo
- [ ] Dirección IP del equipo, mediante ipconfig (windows) / ifconfig (linux)
- [ ] Versión Java 8 AdoptOpenJDK, mediante la ejecución de java -version
- [ ] Versión openssl, mediante la ejecución de openssl version
- [ ] Versión wget, mediante la ejecución de wget –version
- [ ] Puesto de caja. Solo en puestos que utilicen caja diaria (por ejemplo cajas, puestos de atención al cliente, etc).
- [ ] Nombre descriptivo del puesto (Caja, Administración, Gerencia, etc.)
Importante: completar la planilla de relevamiento con los datos de relevamiento del puesto para enviar a Soporte Disytel o a Soporte Sucursales de RM Consulting.