Instalación de Caja FARMAX OR - Guias de instalación
Guias de instalación
En este documento se muestra el procedimiento para lograr una correcta instalación del punto de venta FARMAX OR, así como sus dependencias y configuraciones.
Requisitos generales:
Requisitos de software.
➢ Sistema Operativo Windows 7 Professional con Service Pack1 a 32 bits.
➢ SQL Server Express SP2 2012 ENU 32 bits
➢ SQLSysClrTypes
➢ .NET Framework 4.5
➢ .NET Framework 4.6.1
➢ Certificados
➢ MSMQ activo
➢ InitFARMAX.ini
1.2 Requisitos de hardware
➢ Memoria RAM de 2 GB como mínimo.
➢ Disco duro 200GB
➢ Procesador Intel® Celeron® G540 con Intel HD Graphics (2,90 GHz, 3 MB de caché, 2
núcleos).
Preinstalación del Aplicativo
Tenemos que ya tener el ejecutable de la instalacion y el INI en la misma carpeta, se aconseja que esta carpeta se encuentre o sea puesta en raiz de C:\
Antes de empesar es necesario modificar el archivo “hosts” el cual se hubica en la siguiente ruta de carpetas: C:\Windows\system32\drivers\etc en el cual se debe de agregar lo siguiente:
10.0.1.111 FAHORROMEX126 10.0.1.53 FAHORROMEX221 172.25.5.17 FAHORROAVSC-APB
Y se agrega la ip del ServerStore de la sucursal y nombre de este, que dando por ejemplo de la siguiente manera:
En seguida corremos nuestro ejecutable de la instalacion
Nota: Antes de ejecutar es recomendable deshabilitar y/o desolidificar el antivirus
Instalación
Antes de instalar la caja, Farmacias debe proporcionar los datos de IP y puerto del servidor central FARMAX OR.
NOTAR que si se trabaja a partir de una imagen será necesario modificar tanto el nombre del equipo como la dirección IP de este.
Validar conectividad de la caja
Verificar que la caja tenga habilitadas las políticas de red requeridas para la operación ordinaria. Se recomienda usar la herramienta telnet para validar la conexión específica con el puerto indicado.
1 DB sucursal
2 Updater sucursal
3 Servidor central
4 Web Services centrales
5 Web app bultos y proveedores
6 Origis
7 Autorizador ACI RCS
IP o nombre del equipo Puerto
IP del servidor de sucursal 1433
IP del servidor de sucursal 8475
IP del servidor central <consultar> IP del servidor de WS centrales <consultar> IP del servidor de WS centrales <consultar> IP de servicio origis 443
IP del autorizador RCS 7000
Antes de proseguir con la instalación debemos asegurarnos de que el servicio Windows intaller se encuentre en tipo de inicio manual para esto entramos en servicios del Windows y nos mostrara la siguiente:
Prerequisitos
El instalador de la caja FARMAX OR es capaz de detectar si hacen falta componentes necesarios para su ejecución, e instalarlos dentro del mismo instalador, En caso de detectar prerrequisitos faltantes, la primera pantalla que mostrará el instalador permite instalar todo lo necesario. NOTAR que el servidor de base de datos SQL Server NO debe instalarse por separado.
Los prerrequisitos que son incluidos en el instalador incluyen:
- .Net Framework 4.5 y 4.6.1
- MS Sync Framework 2.1
- Drivers USB verifone
- Drivers para impresora BIXOLON y CognitiveTPG
- Drivers LoGO
- Drivers gemalto
- Drivers multipagos IUSA
- Microsoft Powershell 3.0
- Microsoft Visual C++ 2012 redistributable
- POS for .NET 1.12
Consideraciones al momento de generar imagen.
Para generar una imagen del equipo, considerar los anexos 2, 3 y 4 de este documento, con estos, hasta este punto ya es posible generar una imagen, pero se debe considerar que la imagen no se debe generar después de instalar SQL server, de ser así habría errores al momento de replicar la imagen en diferentes equipos por temas de información particular de equipo.
Como ejemplo, se anexa el proceso para la instalación del prerrequisito .Net Framework 4.6.1
Instalar Cilente FARMAX OR
NOTA: Antes de ejecutar el instalador del cliente, asegurarse que sea la primera vez que se instala esa caja, ya que no se permite instalar un equipo con el mismo nombre una segunda vez, en ese caso se obtendrá un mensaje de error en el instalador.
Además, deberá contar con un archivo llamado initFarmax.ini junto con el instalador en una misma carpeta, para que, al momento de ejecutar, el instalador tome dichas configuraciones del .ini, para mayor referencia, consultar el anexo 6 de este documento.
Consideraciones para ejecutar el instalador:
➢ Ejecutar como administrador.
➢ Si el equipo de cómputo no contiene el .NET Framework 4.6.1, el sistema procederá a realizar
la instalación del .NET, se presiona en siguiente.
➢ El instalador indicara que componentes hacen falta, en este caso el .NET Framework 4.5 y el Microsoft .NET Framework 4.6.1, se presiona en siguiente.
➢ El instalador descomprimirá los archivos necesarios, solo se tiene que esperar a que aparezca una ventana donde pedirá que se acepten los términos y condiciones.
➢ Se tiene que activar la casilla de términos y condiciones y presionar en instalar.
➢ Se espera hasta que finalice la instalación del .NET Framework 4.5.
➢ Cuando acabe la instalación se presiona en Finalizar.
➢ Lo mismo pasará con el Microsoft .NET Framework 4.6.1.
➢ Si el equipo ya contaba con los componentes necesarios instalados, no aparecerán las capturas mostradas anteriormente, solo aparecerá un aviso de instalación.
➢ Activar la casilla Términos y condiciones dar clic en siguiente.
➢ Se deja tal cual se muestra y se presiona en siguiente.
➢ Se ingresan los datos solicitados que para este ejemplo se usa el ID: 1726, el número de caja 25 y la contraseña apropiada, se presiona en siguiente.
o No. Sucursal.
o No. Caja.
o Contraseña. Debe coincidir con la contraseña para el mismo usuario que se
especificó en el instalador de la sucursal.
➢ Se ingresan los datos de los servicios, que para este ejemplo se usará el servicio central: bastet.smart.domain, el puerto: 8103 y el nombre de sucursal: FASUC0509QA, se presiona en siguiente.
o Servidor central.
o Puerto servidor central.
o Nombre de servidor de sucursal.
➢ Se prueba la conexión a base de datos local, presionando en el botón que muestra el texto “Test”.
➢ Se debe mostrar un mensaje con la leyenda conexión exitosa, se presiona en aceptar.
➢ Ya revisada la conexión se presiona en siguiente.
➢ Se ingresa la información de IUSA apropiada para la sucursal, después se presiona en siguiente.
o Identificador de la sucursal. o Usuario.
o Contraseña.
➢ En la configuración de accesos directos, se deja tal cual aparece y se presiona en siguiente.
➢ Cuando todo esté listo, solo será necesario presionar instalar.
➢ El instalador realizará diversas tareas, solo basta con esperar a la siguiente ventana de configuración.
➢ En la configuración de cajas se presiona en el botón de capturar DB info.
➢ Se ingresan los datos, para este documento se usa de ejemplo el usuario para la conexión a la DB de la sucursal.
o Usuario.
o Contraseña.
➢ Se tiene que probar la conexión, para evitar fallos, se presiona en probar conexión, debería aparecer un mensaje indicando “conexión exitosa”, se presiona en aceptar.
➢ Ya comprobado que todo está bien se presiona en aceptar.
➢ Por efectos de validación de la cadena de conexión del servidor, se presiona en Probar conexión, Se debe mostrar un mensaje indicando: “conexión exitosa”, se presiona en aceptar.
➢ Por efectos de validación de la cadena de conexión de la caja, se presiona en Probar conexión, Se debe mostrar un mensaje indicando: “conexión exitosa”, se presiona en aceptar.
➢ Se presiona en configurar caja y se debe esperar hasta que aparezca una ventana emergente.
➢ En la ventana emergente debe aparecer la leyenda: “Suscripción exitosa”, se presiona en aceptar.
➢ Se espera hasta que el instalador termine y se presiona en finalizar.
Anexo 1 Problemas comunes
➢ En caso de mostrar este mensaje de error al final de la instalación:
o Validar que el equipo esté en red
o Validar que se hayan instalado todos los prerrequisitos necesarios.
o Validar que la información capturada en instalador sea la correcta.
o Validar que tenga comunicación con el servidor de sucursal (depende de la sucursal) y central.
También validar que la información contenida en el archivo hosts sea correcta y completa como anteriormente se explicó, este archivo se encuentra en C:\Windows\system32\drivers\etc
Durante la instalación, se genera un archivo log en el directorio raíz del equipo llamado InstallFARMAXClient.log. Recupere y envíe este archivo al equipo de soporte cuando reporte un problema.
➢ Reinstalar caja reutilizando el número de caja. En caso de que se esté realizando una reinstalación y se reutilice el número de caja, después de iniciar sesión aparecerá el siguiente mensaje:
o Se debe contactar al administrador de base de datos para que actualice el “Machine Key” en la base de datos, para ello se deben seguir los siguientes pasos:
o En el equipo de cómputo el Machine Key se encuentra en el editor de registro: se presiona tecla Windows + R, y se escribe “regedit”, se presiona en aceptar.
o Se sigue la ruta: “Equipo\HKEY_LOCAL_MACHINE\SOFTWARE\FAhorro\FARMAX”, se da doble clic en “MachineKey” y se copia la información del valor.
o El administrador de base de datos debe realizar un “update” a la tabla “genCajasCat” en el campo “codigoCaja”, para lo cual necesita el MachineKey obtenido en pasos anteriores, el DBA deberá ejecutar lo siguiente, EN LA BASE DE DATOS DE LA SUCURSAL:
▪ Plantilla: update genCajasCat set codigoCaja ='<Machine Key>' where codigoSucursal = <ID sucursal> and numeroCaja = <numero caja>;
▪ Ejemplo: update genCajasCat set codigoCaja ='3dc25c1b-e70b-43c0-9dbe- f274783afff9' where codigoSucursal = 1726 and numeroCaja = 25;
Anexo 4. Certificados.
Se debe contar con los certificados mostrados en la tabla:
Nombre
soa_certificate.cer pos_client.pfx CACert.cer
Contraseña Vigencia Descripción
s04p0s cl13nt3p0s
5 años 5años
Certificado que contiene la llave pública del OSB. Archivo de exportación de llaves que contiene la llave Certificado que contiene la llave pública de la autoridad certificadora.
➢ Clic en inicio (Botón de Windows), buscar mmc y ejecutar el programa. ➢ Seccionar, Archivo -> Agregar o Quitar complemento.
➢ Seleccionar certificados, se da clic en el botón Agregar.
➢ Elegir la opción Cuneta de equipo y presionar el botón Siguiente.
➢ Seleccionar Equipo Local, clic en el botón Finalizar y posteriormente Aceptar.
➢ Importar los certificados:
o o o
Dar clic en Certificados clic derecho en Entidades de Certificación de Raíz de Confianza Todas las Tareas Importar Siguiente Buscar y cargar archivo CAcert.cer.
Dar clic en Certificados clic derecho en Personal Todas las Tareas Importar Siguiente Buscar y cargar archivo soa_certificate.cer (ingresar clave s04p0s).
Dar clic en Certificados clic derecho en Personal Todas las Tareas Importar Siguiente Buscar y cargar archivo pos_client.pfx (ingresar clave cl13nt3p0s).
➢ Validar que los Certificados se hayan instalado correctamente de la siguiente forma: o En apartado Entidades de Certificación raíz de confianza.
o En apartado Personal.
o ClicenGuardar.
Antes de acceder al Punto de venta y sobre todo en windows, debemos considerar lo siguiente Services, localisamos el el siguinte servicio:
En Ejecutar (Tacal de de Windos + la tacla R): escribimos services.msc y al darle enter nos aparecera La siquiente ventana:
Y localizamos el siguiente servicio:
Una vez localizado le daremos dobel Click para entrar a las propiedades de este servicio y nos dirigimos Al apartado que dice iniciar sesión:
Aquí copiaremos todo el nombre de la cuenta, para asignarla al grupo de Administradores. Para esto Realizamos lo siguieten:
Daremos click derecho sobre el icono de “Este equipo” o “Equipo” según la version de windos y enseguida Clickiamos en Administrar:
Una ve dentro de la ventana Administracion de Equipo, nos dirigimos a usuarios y grupos locales
Enseguida seleccionamos Grupos y del lado derecho seleccionamos Administradores
Donde daremos doble Click y agregaremos el usuario que ya traemos copiado, lo pegamos en En Escribe los nombres de objeto que quieres seleccionar luego damos click en Comprobar Nombres
Damos Click en aceptar.
Y se mostrara ya agregado en el grupo de administradores.
Des pues de hacer este proceso reiniciamos nuevamente el equipo para que aplique el cambio Desde inicio.
Configurar caja
Durante el proceso de instalación, se levanta la ventana de Configurar cajas. Esta pantalla realiza el provisionamiento de la caja creando las tablas, y configurá la caja en la sucursal para poder realizar la replicación de información de Base de Datos.
En un inicio, se carga la información del Id de caja y la cadena de conexión de la base de datos local con autenticación windows, es necesario capturar la información de conexión para la base de datos del servidor de sucursal dando clic en el botón capturar BD Info.
NOTA: La información que se visualiza de Id de caja y cadena de conexión de la caja no puede ser modificada.
Instalación de Miniprinter
Una vez termininado la instalacion del POSEvolutionClient se realizara la instalacion de la miniprinter (impresora de tikets) esta devera estar encendida y conectada.
1.- Copiar el nombre de la miniprinter.
Del la ventana de dispositivos e Impresora ubicar miniprinter y copiar el nombre
En seguida nos dirigimos a la siguiente ubicación de en C:\Program Files\FAhorro\FARMAX\POSY localizamos el archivo POSEvolution.exe.config
Una vez localizado lo editamos con bloc de notas.
Una vez abierto con bloc de notas, buscamos la siguiente línea que contenga value="POSPRINTER"/>
ste valor (POSPRINTER) será sustituido por el nombre de la actual miniprinter en el equipo, el cual ya copiamos, y arriba y sin borrar ninguna otra línea se agrega la siguiente:
<add key="IsOposPrinter" value="false"/> Quedando de la siguiente manera:
Nota: No se debe de borrar ninguna otra línea
Acceso al sistema y configuración de caja
Una vez finalizada la instalación, dar clic en el acceso directo de la aplicación, el personal para el primer acceso es un elemento de farmacia con cargo de Multifuncional.
Es importante mencionar que se debe ingresar con 8 dígitos es decir que al número de empleado se le agregarán 4 ceros al principio (por ejemplo, el empleado con numero 2498 se debe de introducir 00002498), la contraseña es proporcionado de manera confidencial al personal de Farmacia.
Configuración de la impresora desde el punto de venta
Desde el punto de venta, primeramente, se deberá aperturar caja, seleccionar en el menú la opción de configuración de dispositivos →configuración de impresora.
Ingresar las credenciales del responsable.
Dar clic en aceptar.
Nota: El usuario que se ingresa para realizar esta configuración, deberá contar con los permisos o rol de jefe de computo de backoffice.
Dentro del sistema punto de venta, se expande el menú de operaciones, se selecciona “Configuración de dispositivos” y en el submenú se da clic en la opción “Configuración de impresora”, luego se selecciona el nombre que le dimos a la miniprinter y le damos check a Impresora por default y en Imprimir ticket de prueba y configurar.
Se muestra la pantalla de configuración de impresora.
Dar clic en Aceptar a las dos ventanas que aparecerán.
Configuración del lector de barras desde el punto de venta
1. Desde el punto de venta, se deberá aperturar caja, seleccionar en el menú la opción de configuración de dispositivos→configuración de lector código de barras.
Ingresar las credenciales del responsable.
Dar clic en aceptar.
Nota: El usuario que se ingresa para realizar esta configuración, deberá contar con los permisos o rol de Jefe de Computo de BackOffice.
Se muestra la pantalla para la configuración del lector de códigos.
➢ En la parte izquierda se muestran los puertos disponibles para configurar. ➢ Dar clic en el puerto que corresponda al dispositivo a instalar.
➢ Del lado derecho se mostrará en que puerto está conectado.
➢ Se realiza la prueba de leer un código con el lector.
➢ Se presiona Configurar.
Nota. En caso de que no aparezca el puerto al que se encuentra conectado se debe de escanear el codigo de barras que aparece en la parte baja y despues el boton refrescar, hasta que aparezca el puerto COM3, una vez seleccionado clic en configurar y por ultimo escanear un producto de la sucursal y por ultimo configurar.
Como validación se realiza el escaneo ya sea desde un dispositivo móvil en donde se encuentre este condigo de barras.
Configuración Pinpad
Una vez conectada la pinpad al equipo en el puerto USB, hay que validar en que puerto USB se conectó, posteriormente revisar un archivo cfg ubicado en “C:\Program Files\FAhorro\FARMAX\POS”, de ser necesario cambiar la configuración en la línea COM=9 por el número de puerto COM donde se conectó la pinpad y finalmente guardar los cambios del archivo.
De igual forma se tiene que realizar la modificación del puerto en el archivo “AxFARMAXMediator.dll.config” ubicado en la ruta “C:\Program Files\FAhorro\FARMAX\POS”, de tal manera que los puertos tanto para archivo .cfg como para “AxFARMAXMediator.dll.config” sean los mismos.