Instalación AdoptOpenJDK 8 y acceso a Libertya mediante LYStart Instalacion Puesto de trabajo 2026

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.

16

17

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.

18

19

Desde un navegador web, acceder a:

20

21

*. https://adoptium.net/es/temurin/releases/?version=8

[[image:image1.png]]

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

26

27

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

28

29

== Instalación de AdoptOpenJDK 8 en Windows {{id name="instalación-de-adoptopenjdk-8-en-windows" /}}==

30

31

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

[[image:image2.png]]

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**

36

37

== Instalación de AdoptOpenJDK 8 en Linux {{id name="instalación-de-adoptopenjdk-8-en-linux" /}}==

38

39

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

mv ~/Descargas/OpenJDK8U-jdk_x64_linux_hotspot_8u252b09.tar.gz /opt

44

cd /opt

45

gunzip OpenJDK8U-jdk_x64_linux_hotspot_8u252b09.tar.gz

46

tar -xvf OpenJDK8U-jdk_x64_linux_hotspot_8u252b09.tar

47

48

49

Esto dejará la versión de Java lista para ser utilizada en **/opt/jdk8u252-b09**.

50

51

== Configuración de seguridad {{id name="configuración-de-seguridad" /}}==

52

53

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//**.

54

55

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//**.\\**[[image:image3.png]]**\\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.

[[image:image4.png]]

Para concluir presionar **//Aceptar//** en la venta de Listas de excepciones de sitios y en el Panel de Control de Java.

60

61

= Libertya Start {{id name="libertya-start" /}}=

62

63

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.

64

65

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.

66

67

Para obtener este archivo, desde un navegador web acceder a:

68

69

*. IP_DEL_SERVIDOR:8080/libertya.html

70

71

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

[[image:image5.png]]

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

76

77

Una vez descargado el archivo, moverlo a su ubicación definitiva, por ejemplo:

78

79

*. C:\Libertya (Windows)\\

80

*. /opt/Libertya (Linux)

81

82

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

83

84

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

85

86

= Aplicativo wget {{id name="aplicativo-wget" /}}=

87

88

A fin de utilizar Libertya Start se requiere contar con wget instalado.

89

90

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.

91

92

Descargar el instalador desde:

93

94

*. https://sourceforge.net/projects/gnuwin32/files/wget/1.11.4-1/wget-1.11.4-1-setup.exe

95

96

Una vez descargado, instalarlo en la ruta **C:\wget**

97

98

**[[image:image6.png]]**

99

100

Finalizada la instalación, el ejecutable **wget.exe** quedará ubicado en **C:\wget\bin\**

101

102

= OpenSSL {{id name="openssl" /}}=

103

104

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.

105

106

Para Windows descargar el instalador desde:

107

108

*. http://downloads.sourceforge.net/gnuwin32/openssl-0.9.8h-1-setup.exe

109

110

Ejecutar el instalador, indicando como directorio destino **C:\openssl**

[[image:image7.png]]

Finalizada la instalación, el ejecutable **openssl.exe** quedará ubicado en **C:\openssl\bin\**

115

116

= Variables de entorno {{id name="variables-de-entorno" /}}=

117

118

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.

119

120

== Gestion de variables de entorno bajo Windows {{id name="gestion-de-variables-de-entorno-bajo-windows" /}}==

121

122

Para **Windows**, se debe acceder al **Panel de control** y luego hacer clic en **Configuracion Avanzada del Sistema**.

[[image:image8.png]]

Se abrirá la ventana **Propiedades del sistema**. Hacer click en **Variables de entorno**. Esto abrirá la ventana correspondiente.

127

128

|=[[image:image9.png]] |=→ |=[[image:image10.png]]

129

130

Bajo el apartado **Variables del sistema**, se deberán definir o modificar allí las variables de entorno que correspondan.

131

132

== Gestion de variables de entorno bajo Linux {{id name="gestion-de-variables-de-entorno-bajo-linux" /}}==

133

134

Bajo Linux se pueden especificar por ejemplo en el archivo **/etc/profile**. Por ejemplo:

135

136

export JAVA_HOME=/opt/OpenJDK8U-jdk_x64_linux_hotspot_8u372b07\\export OXP_HOME=/opt/Libertya/ClienteLBY\\export PATH=:~$PATH

137

138

== Variables de entorno a configurar {{id name="variables-de-entorno-a-configurar" /}}==

139

140

=== **OXP_HOME** {{id name="oxp_home" /}}===

141

142

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:

143

144

|=Ubicación de archivo LYStart.bat (Windows) |=OXP_HOME

145

|C:\Libertya |C:\Libertya\ClienteLBY

146

147

|=Ubicación de archivo LYStart.sh (Linux) |=OXP_HOME

148

|/opt/Libertya |/opt/Libertya/ClienteLBY

149

150

=== **JAVA_HOME** {{id name="java_home" /}}===

151

152

Esta variable debe apuntar al directorio base de **Java**, dependiendo la ubicación de instalación. Ejemplos:

153

154

|=Ubicación base de Java (Windows) |=JAVA_HOME

155

|C:\Java\OpenJDK8U_8u372b07 |C:\Java\OpenJDK8U_8u372b07

156

157

|=Ubicación base de Java (Linux) |=JAVA_HOME

158

|/opt/OpenJDK8U-jdk_x64_8u372b07 |/opt/OpenJDK8U-jdk_x64_8u372b07

159

160

=== **OPENSSL_HOME** {{id name="openssl_home" /}}===

161

162

Esta variable debe apuntar al directorio donde se encuentran los binarios de openssl (carpeta bin).

163

164

|=Ubicación base de openssl (Windows) |=OPENSSL_HOME

165

|C:\openssl |C:\openssl\bin

166

167

=== **PATH** {{id name="path" /}}===

168

169

Esta variable de entorno probablemente ya exista y deba ser ampliada para que el entorno encuentre los aplicativos **java**, **wget**.y **openssl**.

170

171

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:

172

173

|=Ubicación ejecutables |=PATH

174

|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)…

175

176

**NOTA**: En Linux solo se requiere ampliar el PATH para Java, no así para openssl o wget.

177

178

= Iniciando LY {{id name="iniciando-ly" /}}=

179

180

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

181

182

En resumen, los accesos directos deben apuntar:

183

184

*. Windows: **LYStart.bat (no debe apuntar al archivo .exe)**\\

185

*. Linux: **LYStart.bat**

186

187

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.

188

189

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**:

190

191

[[image:image11.png]]

192

193

Se presentará una ventana de **Parámetros de conexión de Libertya**:

194

195

[[image:image12.png]]

196

197

En esta ventana es necesario realizar los siguientes pasos:

198

199

1. 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**.\\

200

1. 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.\\

201

1. 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.\\

202

1. 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.**

203

204

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

205

206

= Acceso remoto {{id name="acceso-remoto" /}}=

207

208

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.

209

210

== Instalación RustDesk {{id name="instalación-rustdesk" /}}==

211

212

La instalación de RustDesk está detallada en su propio documento.

213

214

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

215

216

Este problema normalmente se soluciona configurando el gateway corporativo directamente en los puestos de trabajo de la sucursal, de esta forma:

217

218

|=route -p add 10.100.85.240 mask 255.255.255.255 <IP-Gateway-Corporativo>

219

220

= Configuración para uso de impresoras fiscales Hasar 2G {{id name="configuración-para-uso-de-impresoras-fiscales-hasar-2g" /}}=

221

222

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.

223

224

[[image:image13.png]]

225

226

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/

233

234

Buscar el modelo, en este caso **SMH/PT 250 F**\\[[image:image14.png]]\\Luego descargar el comprimido de herramientas para desarrolladores:\\[[image:image15.png]]

235

236

Una vez descomprimido, en la carpeta HERRAMIENTAS van a estar las tres mencionadas.

237

238

== Configuracion de WSPOOLER {{id name="configuracion-de-wspooler" /}}==

239

240

Colocar la carpeta del spooler en la ubicación C:\Hasar

241

242

Luego generar un archivo .bat para ejecutar el spooler, debera tener un contenido similar al siguiente, dependiendo la configuración de la PC.

243

244

|=C:\Hasar\spooler\WINDOWS32\wspooler_v213.exe -p10 -k -o 3000 -l

245

246

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.

247

248

== Configuración de GETxxxAR {{id name="configuración-de-getxxxar" /}}==

249

250

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 {{id name="configuración-con-hfl_test" /}}==

255

256

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…

257

258

Se ejecuta desde un cmd de la siguiente manera (ejemplo para puerto serie 10):

259

260

|=C:\Hasar\HFL_TEST\hfl_test_CF.exe serial 10

261

262

= Relevamiento de información en puestos de trabajo {{id name="relevamiento-de-información-en-puestos-de-trabajo" /}}=

263

264

== Dirección IP {{id name="dirección-ip" /}}==

265

266

En equipos con sistema operativo **//Windows//**, abrir una consola DOS y ejecutar el comando

**ipconfig**

**[[image:image16.png]]**

271

272

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//**.

273

274

En sistemas operativos Linux ejecutar una **//terminal//** del sistema operativo y ejecutar:

**Ifconfig**

Luego anotar el mismo dato indicado anteriormente.

279

280

**Importante: en caso de que la IP esté asignada dinámicamente por DHCP, por favor aclararlo en la planilla de relevamiento.**

281

282

== Versión de JAVA {{id name="versión-de-java" /}}==

283

284

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:

**java -version**

**[[image:image17.png]]**

292

293

Anotar en la planilla la versión del software que aparece entre comillas doble, en el ejemplo **//1.8.0_232//**.

294

295

== Versión de OpenSSL {{id name="versión-de-openssl" /}}==

296

297

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**

[[image:image18.png]]

302

303

En la planilla, anotar la versión informada luego de la palabra “OpenSSL”, en el ejemplo **//1.1.1//**

304

305

== Versión de wget {{id name="versión-de-wget" /}}==

306

307

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**

[[image:image19.png]]

312

313

En la planilla, anotar la versión informada luego de la palabra “OpenSSL”, en el ejemplo **//1.19.4//**

314

315

== Sistema de facturación {{id name="sistema-de-facturación" /}}==

316

317

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.

318

319

[[image:image20.png]]

320

321

Dicha información permitirá identificar la tecnología de facturación utilizada en cada puesto.

322

323

= Verificación final del puesto {{id name="verificación-final-del-puesto" /}}=

324

325

Para dar como concluida la actividad de actualización y configuración del puesto de trabajo Libertya, se deben realizar las siguientes verificaciones:

326

327

*. ☐ 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\\

328

*. ☐ Acceso remoto al equipo\\- [ ] Aplicaciones de acceso remoto desinstaladas (Teamviewer, AnyDesk, etc.)\\- [ ] VNC Funcional\\

329

*. ☐ 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.)

330

331

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

Wiki source code of Instalación AdoptOpenJDK 8 y acceso a Libertya mediante LYStart Instalacion Puesto de trabajo 2026

Navigation