AHORA Install 5 - Instalación

TABLA DE CONTENIDOS

• Módulos
• Instalación
  • AhoraInstall.msi
• Bienvenida
• Contrato de Licencia
• Selección de Componentes
• Configuración de Base de Datos
  • Base de datos de demo
• AHORA eFactura Servicio
• AHORA Servicio
• AHORA API
• Estructura de Directorios
• Desplegar Informes
• AHORA TPV
• AHORA 5
• Listo para la instalación
• Instalando Módulos

Módulos

El proceso de instalación de AHORA 5 se presenta a través de un Asistente que le guiará paso a paso y en el que destacan los siguientes componentes: 

IMPORTANTE:

El botón AHORA Install que aparece en la parte inferior derecha del Asistente de Instalación no es más que un acceso directo a la versión de AHORA Install residente en el equipo.

Es importante desinstalar siempre la versión de AHORA Install antes de proceder a la ejecución de una nueva versión del Asistente de Instalación. En caso de no hacerlo, al pulsar dicho botón se estará lanzando la copia del propio equipo y no la nueva versión contenida en la descarga, versión que sí contiene todas las modificaciones y mejoras publicadas.

El propio asistente detecta la versión de AHORA Install y propone desinstalarlo. Consulta este artículo para ampliar información

IMPORTANTE:

Inicialmente el fichero de instalación no requiere permisos de administración en el equipo sobre el que se instala. No obstante, durante el paso de instalación posterior a la petición de datos, se llevarán a cabo determinadas acciones que requieren permisos de administración (crear carpetas, instalar servicios, etc.). Es probable que Windows solicite la petición explícita de los permisos de administración a través de una ventana del sistema.

Bienvenida

Tras ejecutar Ahora Install se accede a la pantalla de presentación. 

Desde "aquí" es posible acceder a la Guía de Instalación. En ella también se encuentra la plataforma de difusión documental de AHORA.

Contrato de Licencia

El siguiente paso de la instalación es la aceptación del Contrato de Licencia, donde se especifican las condiciones generales de uso del Software de AHORA.

Selección de Componentes

En esta pantalla se seleccionan todos los productos AHORA que se desea instalar en el equipo donde se está ejecutando el instalador. 

La selección se subdivide en:

• Componentes de Servidor 
• Componentes de Cliente.

Los componentes de Servidor son imprescindibles para el buen funcionamiento de los segundos. Por esta razón, es recomendable su instalación en equipos que puedan asumir una elevada carga de trabajo y consumos de recursos contantes y estables. Además, esto permitirá accesos por red a recursos compartidos como listados de impresión o imágenes desde cualquier equipo con instalaciones de productos de cliente.

Desde la propia pantalla, haciendo clic en el icono de ayuda, es posible obtener información ampliada de las funciones y requisitos de cada uno de los módulos. Acción que facilita el conocimiento de los mismas y suprime la necesidad de consultar recursos externos.

Los productos incluidos son:

Servidor:

• Base de Datos: permite la instalación de una base de datos vacía. Requiere la instalación previa de un servidor SQL Server (SQL Express 2016 o superior), y el conocimiento de un usuario y contraseña con permisos de administrador (sa).
• AHORA eFactura Servicio: instala el Servicio eFactura con el que se comunica el mantenimiento de la eFactura incluido en el ERP. 
• AHORA Servicio: instala el servicio de impresión utilizado como cola de impresión desde los diferentes productos de AHORA (ERP, TPV). 
• AHORA API: instala la API de comunicación utilizada para interactuar con la base de datos introducida por el usuario. Es un requisito indispensable para el correcto funcionamiento de AHORA TPV.
• Estructura de Directorios: crea el árbol de directorios necesarios para trabajar con listados, imágenes, iconos, backups, actualizaciones e importaciones desde los diferentes productos de AHORA.
• Desplegar Informes Crystal: despliega los informes de Crystal Reports estándar de AHORA ERP y módulos de AHORA siempre y cuando la ruta de listados (PATHLISTADOS) esté debidamente configurada en la base de datos. El despliegue remplaza los informes estándar y respeta cualquier configuración de carpetas y ficheros personalizados que  pudiera existir.

Cliente:

• AHORA TPV: instala el cliente TPV.
  
• AHORA 5: instala la versión 5 incluida del ERP. En caso de existir una versión previa, se procederá a su desinstalación de forma automática antes de instalar la nueva versión.

Configuración de Base de Datos

La pantalla de Configuración de Base de Datos tiene dos funciones bien diferenciadas.

Por un lado, es el primer paso de una instalación en la que se ha seleccionado Base de Datos. Controla y valida que el nombre de la base de datos introducida no exista en la instancia de SQL introducida. Dicho de otro modo, no se permite sobrescribir una base de datos existente. Este control funciona como medida de seguridad para evitar la pérdida de datos en bases de datos ya existentes.

Por otro lado, es la primera pantalla que se muestra en caso de no haber seleccionado la instalación de una nueva base de datos. Pero sí lo hará si la instalación de algún producto requiere una conexión a una base de datos existente.

En esta pantalla se deben rellenar los siguientes campos:

• Instancia SQL: nombre del servidor y su instancia si procede.
• Base de Datos: nombre de la base de datos.
• Usuario: sa o usuario administrador del servidor de Base de Datos.
• Contraseña: contraseña del usuario administrador del servidor de Base de Datos.

DATO:

El usuario por defecto del ERP 'ahora' debe existir como usuario de base de datos en el servidor de SQL. Este usuario se crea si no existe o se asocia a la base de datos en caso de existir.

Los datos de acceso de la Base de Datos son:

• Usuario: ahora
• Contraseña: la contraseña del usuario en caso de existir previamente creado, o  '-Instalador0000' si lo ha creado el instalador. Se establece esta contraseña ya que la directiva de SQL no permite generar el usuario sin contraseña al crearlo de forma automática.

Base de datos de demo

Desde la propia pantalla de Configuración de Base de Datos, accediendo a la misma tras marcar la opción "Base de Datos" de la pantalla de Selección de aplicaciones, se posibilita la creación de la base de datos con una carga de datos de demo.

De esta forma, la base de datos generada nace cumplimentada y preparada para trabajar en un entorno de demostración, conteniendo los siguientes elementos:

• Carga de todos los maestros (artículos, clientes, etc.)
• Compras
• Ventas
• Contabilidad
• Cartera
• Amortizaciones
• TPV

Adicionalmente, se incluyen una serie de informes preparados específicamente para el entorno de demos, con un logo de empresa ficticia, permitiendo una visualización estandarizada y realista de los mismos.

Después de haber finalizado con AHORA Install y con los datos de demo aplicados, será necesario indicar el CIF de la empresa y así obtener una licencia de demo de 30 días. Para ello crearemos la conexión e iniciaremos sesión en AHORA ERP.

Nada mas iniciar sesión, se activará el asistente de instalación, de AHORA ERP, seleccionaremos la opción AHORA Express y estableceremos un CIF para la empresa de Demos. En este punto, podemos seguir configurando el ERP a través del asistente o finaliza y acceder al ERP.

AHORA eFactura Servicio

El módulo AHORA eFactura Servicio permite reunir de forma sencilla aquellas facturas recientemente actualizadas, pero todavía no convertidas a un formato de eFactura. También permite realizar dichos procesos de conversión y envío, obedeciendo las preferencias establecidas para el cliente de la factura. Finalmente, es posible programar el envío automático de factura, según una frecuencia definida por el usuario, así como de otros objetos, configurados previamente. 

Desde AHORA Install se instala el servicio Windows necesario para la automatización de las tareas de creación y envío de facturas electrónicas. El cliente de uso manual esté incluido dentro de AHORA ERP, siendo imprescindible la comunicación entre AHORA API y AHORA eFactura para poder gestionar los envíos desde dicho manteimiento.

Desde la propia ventana de configuración se piden una serie de datos necesarios para su correcto funcionamiento:

• AHORA eFactura: es el nombre de la instalación del módulo. Al igual que con el resto de módulos incluidos en AHORA Install, es posible desplegar más de un módulo del mismo tipo en el mismo equipo, para identificar cada uno de ellos se usa el nombre indicado en este campo. Este nombre se utilizará tanto para crear la carpeta destino del despliegue, como para asignarle nombre al servicio de Windows asociado a la misma. 
• Como Automática: al marcar este campo se procederá a configurar el servicio instalado para el envío automático de los documentos. En caos de querer gestionarlos exclusivamente de forma manual desde el mantenimiento del ERP, debe dejarse sin marcar. 
• Frecuencia: establece, en segundos, la frecuencia con la que se ejecutará el envío automático de las facturas electrónicas. Este campo sólo parecerá disponible en caso de haber marcado la casilla "Automática".
• Empresa: el código de empresa sobre la que trabajará AHORA eFactura. En caso de disponer de varias empresas en la misma organización, utilizando este código se puede definir sobre la que queremos trabajar con AHORA eFactura. En caso de querer trabajar con todas, se mantendrá el valor por defecto a -1.
• Delegación: al igual que con el campo anterior, en este se define sobre qué delegación queremos trabajar con facturas electrónicas. En caso de querer trabajar con todas, se mantendrá el valor por defecto a -1.

IMPORTANTE:

Los códigos de empresa y delegación deben de coincidir con valores reales de la base de datos sobre la que se ha definido el despliegue. En caso de no existir se notificará un error con los valores posibles que sí pueden introducirse.

AHORA Servicio

AHORA Servicio es la evolución tecnológica y funcional del actual servicio de impresión de AHORA. Ésta agrupa toda la funcionalidad del mismo e implementa un abanico de nuevas opciones que permitirán un uso más profundo de cualquier tipo de tarea programada. 

Se instala como servicio Windows en el equipo donde se está llevando a cabo el proceso de despliegue utilizando AHORA Install. El nombre que adoptará dicho servicio dentro del catálogo de Windows es el único requisito para su instalación.

IMPORTANTE:

AHORA Servicio debe instalarse en un servidor junto al Módulo de Crystal Reports .NET 32 bits, o al Módulo de Crystal Reports .NET 64 bits, necesarios para la generación de los listados.

Este servicio gestiona la cola de impresión de los productos de AHORA, permitiendo tanto el envío de informes a impresoras como la generación de los mismos en formato PDF.

El servicio se instalará en el equipo con el nombre AHORA Servicio Nombre. Este 'Nombre' es el que se introduce en el campo de esta pantalla. Para gestionarlo (iniciar o detener), hay que acceder a la gestión de servicios de Windows. También existe un nodo en el visor de eventos de Windows para visualizar los mensajes que pudiera generar el propio servicio.

AHORA API

AHORA API es el punto de entrada y salida de información de la base de datos de AHORA ERP. La API supone el núcleo fuerte de todas las aplicaciones y módulos de AHORA.

Al igual que AHORA Servicio, ésta se instala en el equipo como servicio Windows bajo el nombre "AHORA API NombreAPI". El 'NombreAPI' es el dato introducido en esta pantalla de configuración.

La instalación se lleva a cabo en el equipo que está ejecutando AHORA install, quedando configurada para recibir peticiones en la URL autoconfigurada en este paso.

Los datos tratados son:

• AHORA API: define el nombre que va a tomar la API como servicio de Windows y nombre de la carpeta contenedora de las librerías del servicio.
• Servidor: es el nombre de la máquina donde se está instalando la API. No hay posibilidad de editarlo.
• Puerto: puerto libre de la máquina a partir del 8080. El instalador busca y propone el primer puerto libre a partir del rango mencionado.
• Activar Actualización: la versión 5.0 se actualiza utilizando la API. Con este check se establece la API como agente de actualización de forma que al entrar en el Asistente de Actualización se podrá utilizar para este fin. En caso de necesitar la API simplemente para consumo de la TPV o consumo de módulos externos, se puede dejar el campo sin activar.

A modo de ayuda se presenta la URL final de acceso a la API una vez instalada. Esta URL se puede abrir desde cualquier navegador para acceder al editor de Swagger (AA).

Estructura de Directorios

En este paso, se establece el directorio origen donde se creará la estructura de directorios de los diferentes productos de AHORA para gestionar y compartir todo tipo de ficheros.

IMPORTANTE:

Es importante tener en cuenta que dicha ruta debe ser un recurso de red compartido y accesible en entornos de instalación con más de un puesto (Cliente - Servidor).

Por defecto, aparece propuesto este directorio, debemos cambiarlo y ubicar la instalación en un directorio compartido o donde tengamos ya realizada la instalación de los mismos para que el asistente añada los cambios necesarios. 

La estructura que se creará será la siguiente:

• RutaIntroducida\DB: directorio para la gestión documental.
• RutaIntroducida\LISTADOS: directorio de despliegue de los listados estándar utilizados por AHORA ERP.
• RutaIntroducida\IMAGENES: directorio para la gestión de imágenes.
• RutaIntroducida\ICONOS: directorio para la gestión de iconos.
• RutaIntroducida\BACKUP: directorio para las copias de seguridad.
• RutaIntroducida\IMPORTACION: directorio para la importación.
• RutaIntroducida\ACTUALIZACION: directorio para la actualización.

Una vez finalizado el proceso de creación de la estructura de carpetas, se actualiza automáticamente los parámetros de configuración en la base de datos establecida en la pantalla Configuración de Base de Datos.

Desplegar Informes

Despliega los informes de Crystal Reports y Devexpress estándar de AHORA ERP y módulos de AHORA siempre y cuando la ruta de listados (PATHLISTADOS) esté debidamente configurada en la base de datos. 

El despliegue remplaza los informes estándar y respeta cualquier configuración de carpetas y ficheros personalizados           que  pudiera existir.

AHORA TPV

En esta pantalla se introducen los parámetros necesarios para la instalación del producto AHORA TPV.

La instalación despliega todos los elementos necesarios para la ejecución del cliente de TPV. Ésta requiere los siguientes parámetros de configuración:

• Nombre: se utiliza para crear la carpeta de despliegue de la TPV y para generar un icono de acceso rápido en el escritorio.
• AHORA API: en aquellos casos en los que también se ha configurado AHORA API durante el mismo proceso de instalación, este campo se rellenará automáticamente. En cualquier otro caso, el usuario puede incluir la dirección de la API previamente instalada en algún servidor de forma que la instalación de AHORA TPV preconfigurará este dato de forma directa.

AHORA 5

La instalación de AHORA ERP 5, a partir de la versión 5.0.0.64, permite la configuración del cliente para conectar directamente por AHORA SSO. 

Existen dos modos básicos de instalación:

• Sólo el cliente: en este caso sólo instalará AHORA 5 en la ruta prestablecida de instalación, con el nombre de carpeta que se informe en la ventana siguiente.
• El cliente configurado para acceso Ahora SSO: en este caso, además de instalar AHORA 5, se procederá a configurar de forma automática la conexión estableciendo los valores necesarios para conectar con el servicio de autenticación SSO. Estos parámetros deben haber sido incluidos previamente en el ERP por un usuario administrador.

La diferencia básica, por tanto, será que se muestre en el desplegable de conexiones la conexión a la base de datos debidamente configurada, o que el propio usuario tenga que definir la conexión la primera vez que entre al ERP.

En caso de marcarse la opción Configurar acceso Ahora SSO y no tener ningún otro módulo que requiere informar de la base de datos destino, se pedirá los datos de conexión. En este caso, el usuario y password introducidos para conectar puede ser el propio empleado del ERP puesto que no se requieren permisos especiales de administrador, simplemente se necesitan permisos de consulta para recuperar los datos configurados del SSO.

Listo para la instalación

Esta pantalla resume los componentes seleccionados para su instalación. En caso de querer modificar algún dato, será posible volver a pantallas anteriores pulsando el botón 'Inicio'.

Instalando Módulos

Una vez finalizada la selección y la configuración de los diferentes productos, se procede a su instalación. La duración de la instalación variará en función de los módulos seleccionados y las características del equipo en el que se están instalando.

Las acciones realizadas por el instalador en este paso, sí requieren de permisos de administración sobre el equipo en el que se está ejecutando AHORA Install. En caso de que el usuario que ejecuta el instalador no sea administrador del equipo, Windows mostrará una ventana de petición de confirmación de permisos.