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

56

**[[image:image3.png]]**

57

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.

62

63

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

64

65

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.

66

67

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.

68

69

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

70

71

* IP_DEL_SERVIDOR:8080/libertya.html

72

73

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

78

79

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

80

81

* C:\Libertya (Windows)

82

* /opt/Libertya (Linux)

83

84

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

85

86

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

87

88

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

89

90

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

91

92

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.

93

94

Descargar el instalador desde:

95

96

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

97

98

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

99

100

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

101

102

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

103

104

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

105

106

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.

107

108

Para Windows descargar el instalador desde:

109

110

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

111

112

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

117

118

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

119

120

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.

121

122

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

123

124

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.

129

130

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

131

132

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

133

134

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

135

136

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

137

138

export JAVA_HOME=/opt/OpenJDK8U-jdk_x64_linux_hotspot_8u372b07

139

export OXP_HOME=/opt/Libertya/ClienteLBY

140

export PATH=:$PATH

141

142

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

143

144

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

145

146

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:

147

148

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

149

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

150

151

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

152

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

153

154

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

155

156

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

157

158

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

159

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

160

161

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

162

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

163

164

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

165

166

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

167

168

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

169

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

170

171

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

172

173

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

174

175

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:

176

177

|=Ubicación ejecutables |=PATH

178

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

179

180

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

181

182

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

183

184

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

185

186

En resumen, los accesos directos deben apuntar:

187

188

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

189

* Linux: **LYStart.bat**

190

191

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.

192

193

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

194

195

[[image:image11.png]]

196

197

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

198

199

[[image:image12.png]]

200

201

En esta ventana es necesario realizar los siguientes pasos:

202

203

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

204

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.

205

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.

206

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

207

208

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

209

210

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

211

212

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.

213

214

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

215

216

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

217

218

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

219

220

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

221

222

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

223

224

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

225

226

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.

227

228

[[image:image13.png]]

229

230

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:

237

https://compania.grupohasar.com/descargas/

238

239

Buscar el modelo, en este caso **SMH/PT 250 F**

240

[[image:image14.png]]

241

Luego descargar el comprimido de herramientas para desarrolladores:

242

[[image:image15.png]]

243

244

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

245

246

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

247

248

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

249

250

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

251

252

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

253

254

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.

255

256

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

257

258

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"/}} ==

263

264

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…

265

266

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

267

268

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

269

270

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

271

272

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

273

274

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

**ipconfig**

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

279

280

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

281

282

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

**Ifconfig**

Luego anotar el mismo dato indicado anteriormente.

287

288

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

289

290

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

291

292

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

300

301

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

302

303

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

304

305

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

310

311

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

312

313

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

314

315

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

320

321

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

322

323

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

324

325

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.

326

327

[[image:image20.png]]

328

329

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

330

331

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

332

333

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

334

335

* ☐ Libertya Start

336

- [ ] Verificación de las Variables de entorno (**JAVA_HOME**, **OXP_HOME** y **PATH**)

337

- [ ] En caso de incorporar acceso directo en el escritorio, debe apuntar a **LYStart.sh** / **LYStart.bat**

338

- [ ] Correcta ejecución de **LYStart**

339

- [ ] Test de aplicación Libertya de OK

340

* ☐ Acceso remoto al equipo

341

- [ ] Aplicaciones de acceso remoto desinstaladas (Teamviewer, AnyDesk, etc.)

342

- [ ] VNC Funcional

343

* ☐ Relevamiento de datos completo

344

- [ ] Dirección IP del equipo, mediante **ipconfig** (windows) / **ifconfig** (linux)

345

- [ ] Versión Java 8 AdoptOpenJDK, mediante la ejecución de **java -version**

346

- [ ] Versión openssl, mediante la ejecución de **openssl version**

347

- [ ] Versión wget, mediante la ejecución de **wget –version**

348

- [ ] Puesto de caja. Solo en puestos que utilicen caja diaria (por ejemplo cajas, puestos de atención al cliente, etc).

349

- [ ] Nombre descriptivo del puesto (Caja, Administración, Gerencia, etc.)

350

351

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