-
PT
-
ES
Notas importantes
Licencia y Activación
- Es necesario disponer del código de activación de la licencia, para instalar el software. En caso de no contar con conexión a Internet, consultar la sección Requerimientos de conectividad con License Server.
Requerimientos del sistema
- El sistema valida los requerimientos de hardware y software. No se permite continuar si no se cumplen, ya que no es posible garantizar la integridad de la aplicación en un entorno no soportado.
Instalación en máquinas virtuales
- Al instalar en una máquina virtual, se solicita el nombre de la máquina física que actúa como ancla.
Restricciones de licencia
- Debido a restricciones por licencias GPL no todos los controladores se pueden distribuir con la plataforma. Concretamente, se ha dejado de distribuir el controlador JDBC de MySQL. Para poder trabajar con MySQL consultar la sección Instalación de controladores JDBC adicionales.
Configuración de SQL Server
- En SQL Server, el idioma de conexión del usuario propietario de las tablas de repositorio y datos debe ser inglés y no debe ser sysadmin.
Recomendaciones de software
- Es aconsejable el uso del JDK para disponer de las herramientas de tunning y evitar actualizaciones automáticas.
- Es necesario LibreOffice 5.1 para poder convertir documentos ODT a PDF mediante Office Bridge.
Instalación de Eclipse
- Para instalar Eclipse es necesario utilizar el empaquetado ZIP o TAR.GZ. No está soportada la instalación de Eclipse con instalador nativo ya que la carpeta dropins queda en los directorios de usuario y no como subcarpeta de Eclipse.
Interfaz gráfica
- Para la instalación es necesario disponer de interfaz gráfica. Si los servidores no tienen la interfaz gráfica, se puede instalar en modo consola e instalar los productos desde otro PC con interfaz gráfica.
Configuración regional
- Todos los servidores y PC en modo intra deben tener el mismo locale para asegurar que las fechas y horas se guardan correctamente en la DBMS.
Configuración del servidor de aplicaciones
- Para poder utilizar Tomcat o WebSphere como servidor de aplicaciones, durante la instalación se debe seleccionar la opción External Web Server y, posteriormente, mediante la consola del servidor de aplicaciones, instalar el paquete WAR de la subcarpeta web de la instalación de Platform.
Encriptación de comunicaciones
Es recomendable el uso del protocolo cifrado AES para encriptar las comunicaciones. En nuevas instalaciones se configura por defecto. En instalaciones existentes, se debe editar el fichero de propiedades com_unit4_karat_comm.properties con:
- http_encrypt=AES/ECB/NoPadding
- http_bits=128
Configuraciones en servidores Windows
- En algunos servidores Windows no queda compartida la carpeta work como karatwork y es necesario realizar el proceso manualmente.
- Si el servidor de aplicaciones accede al recurso karatwork de otro equipo, es necesario que el servicio esté configurado con un usuario con derechos de acceso.
Arquitectura
Durante la instalación de Platform se crean carpetas:
- bin. Scripts de inicio.
- client. Ficheros necesarios en cliente.
- conf. Ficheros de configuración.
- doc. Documentación.
- eclipse. Plugin para Eclipse.
- ext. Directorio en el que se ubican los JAR que se utilizan desde los scripts de cliente.
- images. Imágenes.
- installer. El instalador, script para desinstalación, etc.
- lib. Librerías JAR utilizadas por Platform.
- lib-obsolete. Contiene librerías de dependencias eliminadas en Platform.
- logs. Ficheros de traza.
- products. Directorio para los JAR de los productos.
- temp. Archivos temporales.
- translator. Ficheros de properties de los traductores.
- web. Paquete WAR para instalar en Tomcat.
- work. Carpeta creada de forma automática para guardar los ficheros de los directorios de usuario y de configuración.
Requerimientos
A continuación, se detallan los requerimientos mínimos necesarios para realizar una correcta instalación del producto, incluyendo los requisitos de hardware y softwaretanto para los puestos de trabajo cliente como para los distintos servidores.
También se especifican las resoluciones de pantalla mínima funcional, recomendada y óptima.
Instalación
El proceso de instalación del producto debe ser realizado por un técnico de Cegid SMB, SAU (implantador) o, si así se establece, por personal autorizado (distribuidor).
Este técnico debe tener conocimientos sólidos de todos los componentes tecnológicos implicados: cliente, base de datos, servidor de aplicaciones, etc.
Conectividad a License Server
El instalador de Platform se conecta a License Server para la activación del software. Si no se dispone de conexión a Internet, el instalador genera un fichero de petición de activación que se debe enviar a Cegid SMB, SAU por correo electrónico.
A continuación, se recibe un mensaje electrónico con las instrucciones para continuar la instalación. Si se dispone de una conexión restringida, es recomendable autorizar el acceso a la dirección ekonlic.ekon.es, en el puerto 80 para el protocolo HTTP.
Hardware
Consulta el documento en línea a infraestructuras.
Resolución de pantalla:
- Mínima funcional: 1024 x 768 píxeles y 24 bits.
- Óptima: 1152 x 864 píxeles y 32 bits.
Software
Cegid UI en el Escritorio
- Lector para RTF, XLS, ODT y ODS (por ejemplo, OpenOffice) si se van a generar listados a fichero en este formato. Versión mínima de OpenOffice 2.0 para visualizar listados con textos en Unicode.
- Lector para PDF, por ejemplo, Acrobat Reader, si se van a generar listados a fichero en este formato. Versión mínima de Acrobat Reader 6.0.
- Sistema operativo
- Linux
- Fedora
- openSUSE
- Red Hat
- SUSE
- Open WebStart (OpenJDK 17 LTS o OpenJDK 21 LTS con JavaFX)
- Mac OS
- Sierra 10.12
- High Sierra 10.13
- Mojave 10.14
- Catalina 10.15
- Big Sur 11
- Open WebStart (OpenJDK 17 LTS o OpenJDK 21 LTS con JavaFX)
- Windows
- Sistema versión mínima Windows 10 (No soportadas versiones Home de Windows)
- Open WebStart (OpenJDK 17 LTS o OpenJDK 21 LTS con JavaFX)
- Java Advanced Imaging 1.1.2_01 For JRE para poder generar ficheros multipágina tipo TIFF con el escáner.
- No está soportada la versión Home de Windows.
- Linux
Cegid en Movilidad
- iOS 12 o superiores
- Android 11.0 o superiores
Entorno de administración
Los entornos del cliente de Platform.
Entorno de desarrollo
Para desarrollar y depurar las clases de personalización en Java, el entorno admitido es el siguiente:
- Los entornos del cliente de Platform.
- Eclipse 2022-03 o superior
Cegid Studio y Graphical Editing Framework
Studio requiere GEF o Graphical Editing Framework; sin embargo, las versiones más recientes de Eclipse IDE for Java Developers incluyen una versión de este framework que no es compatible con Studio. Por lo tanto, es posible que la perspectiva de Studio no esté disponible tras una nueva instalación.
Para restablecer GEF en nuestro entorno y solucionar el problema, en el caso de que se disponga de IDE Eclipse 2023-12.
¿Con IDE Eclipse que GEF se ofrece?
Acceder a Install New Software. Ir al menú Help y seleccionar la opción Install New Software.
- En Workwith: https://download.eclipse.org/releases/2023-12/ y carga los elementos disponibles.
- Filtrar por GEF.
- En Modeling se ofrece GEF Classic Zest SDK de Versión 3.18. Este no sirve ya que es necesaria la versión 3.15.
Para instalar GEF Classic 3.15
- Acceder a Install New Software. Ir al menú Help y seleccionar la opción Install New Software.
- Agregar el Repositorio del GEF Classic
- En la ventana que aparece, hacer clic en el botón Add para agregar un nuevo repositorio de software.
- En el diálogo Add Repository, proporcionar la siguiente información:
- Name. Introducir un nombre descriptivo para el repositorio, como GEFLegacy
- Location. Ingresar la URL del repositorio: https://download.eclipse.org/tools/gef/classic/release/3.15.0.
- Hacer clic en el botón Add para agregar el repositorio a la lista.
- Seleccionar el Software a Instalar. En la lista de software disponible, buscar y marcar la casilla de GEF (Graphical Editing Framework) Classic.
- Hacer clic en el botón Next para continuar con la instalación. Eclipse calcula los requisitos y dependencias del software.
- Confirmar los detalles de la instalación y aceptar la Licencia.
- Esperar que se complete la instalación.
- Una vez completada, Eclipse solicita reiniciar el IDE para que los cambios tengan efecto.
Servidor
Es recomendable que todo el software de servidor esté en inglés.
Servidor de base de datos
Los requerimientos del software para el servidor de base de datos son los indicados por el fabricante en cada caso. Las bases de datos admitidas oficialmente son las siguientes:
- Microsoft SQL Server 2022
- Microsoft SQL Server 2019
- Microsoft SQL Server 2017
- Microsoft SQL Server 2016
- Microsoft SQL Server 2014
- Oracle 21
- Oracle 19c
- Oracle 18c
- Oracle 12c R1
- Oracle 11g R2
- MySQL 8.0.36 con controlador JDBC mysql-connector-java-8.0.33-bin.jar
- InterSystems Caché 2016.1
Servidor principal o Servidor de Business Navigator
- Java 32 bits no está permitido en sistemas operativos de 64 bits.
- Linux
- Red Hat 7.0 y SUSE 12
- Open JDK 17 LTS
- Oracle/Sun Java 1.8.0_201
- Windows
- Windows 2012 R2, Windows 2016 y Windows 2019
- Open JDK 17 LTS
Servidor de aplicaciones
Utiliza los mismos sistemas operativos que los servidores del servicio principal.
Proceso de instalación
Para iniciar la instalación, ejecute el siguiente fichero: java -jar karat-installer.jar.
Y para la instalación en modo consola, ejecute el siguiente fichero: java -jar karat-installer.jar -console.
Notas:
- Es necesario ejecutar la instalación como administrador.
- Puede instalar Platform en sistemas operativos sin consola gráfica, pero la instalación de productos se debe realizar en un PC con interfaz gráfica.
Instalación de controladores JDBC adicionales
Debido a restricciones por licencias GPL no todos los controladores se pueden distribuir con Platform.
Para poder añadir estos driversJDBC a Platform los pasos que se deben seguir son:
Opción 1
- Copiar JAR de driver JDBC necesario en carpeta karat/lib
- Reinstalar o actualizar instalación de la Platform
Opción 2
- Montar fichero karat_jdbc-11.1.0.0.zip con el JAR o JARS de driver JDBC necesarios
- Copiar fichero karat_jdbc-11.1.0.0.zip en misma carpeta donde este la distribución Platform (ficheros *.kiz).
- Realizar instalación o actualización de Platform.
Instalación del host físico para anclar una máquina virtual
Descomprimir karat_vm_host-11.1.0.0.zip y ejecutar setup.exe. Este proceso realiza la instalación de un servicio host para anclar máquinas virtuales. Tome nota del puerto utilizado por el servicio host.
A continuación, instalar Platform en una máquina virtual. Durante el proceso de instalación, al seleccionar tipo main server, el sistema le pide el servidor y puerto del servicio host instalado anteriormente (Physical host). Por ejemplo, myhost:5500. El resto de la instalación es convencional.
Para anclar manualmente un servidor principal en máquina virtual a un host físico, debe añadir la propiedad host_physical en servermain.properties del servidor principal. Ejemplo: host_physical=tcp://host:puerto.
Antes de la instalación
Verificar el cumplimiento de los requerimientos del hardware y del software.
Durante la instalación
Bienvenida
Mensaje de bienvenida.
Instancias
Actualización de una instancia existente o creación de una nueva.
Datos generales
La información para definir en este paso es la siguiente:
- Instancia. Nombre de la instancia de Platform. Se utiliza como valor por defecto en el nombre de directorio virtual del servidor de aplicaciones, como prefijo del servicio principal, etc. Para una segunda instalación de Platform en el mismo servidor, es necesario cambiar el nombre de la instancia.
- Puerto inicial para servicios. Una instalación completa necesita un máximo de tres puertos (servidor principal, servidor TCP en el servidor de aplicaciones y servidor TCP externo). El valor por defecto es 5500 y es necesario modificarlo si los puertos ya están en uso o se trata de una segunda instalación de Platform en el mismo equipo.
- Directorio de instalación. Directorio en el que se instala Platform.
Tipo de instalación
- Cliente. Instala Platform intra.
- Servidor de aplicaciones. Instala Platform intra, además instala karat Web Embedded, o genera fichero war para desplegar en un servidor de Servlets compatible.
- Servidor principal. Instala el servidor de aplicaciones y el servidor principal de Platform (configuraciones, licencias, procesos largos, etc.).
- Instalar Cegid Studio (plugins epara Eclipse). Copia el plugin para Eclipse en el subdirectorio Eclipse de la instalación, necesario para definir scripts y realizar traducciones de código (VB, VBS y UPL). También copia un archivo ZIP de la documentación en formato Javadoc y un archivo para facilitar la definición de las User Libraries en Eclipse.
Carpeta compartida
Definición de carpeta compartida en un directorio local o remoto para ubicar los ficheros disponibles para todos los usuarios de la configuración.
- Carpeta compartida. Ubicación de los ficheros donde se ubicarán compartidos para todos los usuarios de la configuración. Debe ser compatible con los clientes que tengan acceso.
- Carpeta compartida local. Ubicación local de la carpeta compartida tal como la visualiza el servidor principal.
- Usuario. Si el directorio está en Windows y el cliente es Linux, se requieren credenciales para acceder al directorio. Usuario de acceso.
- Contraseña. Si el directorio está en Windows y el cliente es Linux, se requieren credenciales para acceder al directorio. Contraseña de acceso.
Java Virtual Machine
En este paso puede seleccionar la versión de Java utilizada.
Servidor de aplicaciones
- Servidor de aplicaciones. Por defecto es karat Web Embedded. Para poder utilizar Apache Tomcat como servidor de aplicaciones, se debe seleccionar la opción Generic war to install on external server y, posteriormente mediante la consola del servidor de aplicaciones, instalar el paquete WAR de la subcarpeta web de la instalación de Platform.
- Carpeta virtual. Nombre del directorio virtual, por defecto, es el mismo nombre que la instancia.
Opciones de Eclipse
Si se marca la casilla Instalar Platform plugin en Eclipse, se dispone de la siguiente opción:
- Directorio Eclipse. Indica el directorio raíz de la instalación de Eclipse en la que se instala el plugin.
Avisos
Antes de iniciar la instalación de Platform, se realizan validaciones para ayudar a evitar incidencias en fases posteriores. Se verifica la memoria física, el espacio en disco disponible, la versión de Java, entre otros aspectos.
Si alguna de estas validaciones falla, se abre un formulario que indica la ubicación de las incidencias detectadas. Si todas las validaciones son correctas, no se abre esta ventana.
Resumen de las opciones de instalación
Muestra las opciones seleccionadas.
Proceso de instalación
Muestra las acciones realizadas durante la instalación.
Instalación finalizada
Muestra un mensaje que indica si el proceso ha finalizado correctamente o si se ha detectado algún error.
- Iniciar la instalación de productos. Al marcar esta casilla después de finalizar la instalación de Platform, se inicia el asistente de instalación de productos para los siguientes elementos:
- Instalación de licencias
- Creación configuraciones de Platform
- Instalación de KIZ de los productos
Después de la instalación
Nueva instalación
Si se ha ha instalado el servidor principal, es necesario instalar las licencias y definir las configuraciones necesarias desde el Control panel.
Actualización
Consultar el artículo de novedades correspondiente para conocer si se debe realizar alguna acción.
Verificación
Comprobar que es posible acceder para empezar a trabajar.
Licencias
Desde Platform las licencias funcionan mediante un código de activación, el su código de activación se descarga en la web de clientes.
La primera vez que se ejecuta el instalador de productos pide el código de activación. Para utilizar una máquina virtual como servidor principal primero se debe anclar la máquina virtual contra una máquina física. Una vez anclada, ya es posible utilizar tu código de activación.
El código de activación lleva implícito el número máximo de máquinas en clúster. Un único código de activación es suficiente para activar todos los servidores principales que forman el clúster. Sólo se debe activar el código una vez, en cualquier nodo del clúster. Si más adelante se añaden nodos al clúster, éstos se activan automáticamente.
También es posible activar la licencia desde el Panel de control.
Iniciar sesión de trabajo
Iniciar una sesión de trabajo con XRP UI
Utilizando un navegador, utiliza una URL del tipo https://servidor:puerto/site para conectar mediante HTTPS o si no se dispone de un certificado SSL, mediante una URL del tipo http://servidor:puerto/site.
Para conectar directamente con una configuración, añadir el nombre de la configuración al final de la URL, por ejemplo: https://servidor:puerto/site/configuration.
Iniciar una sesión de trabajo con HTML UI
Utilizando un navegador, utiliza una URL del tipo https://servidor:puerto/html para conectar mediante HTTPS o si no se dispone de un certificado SSL, mediante una URL del tipo http://servidor:puerto/html.
Iniciar una sesión de trabajo con UI
En instalaciones cliente, utilizar los accesos directos del menú de inicio o del directorio bin de la instalación de Platform.
Si la conexión se realiza mediante Java Web Start, utilizar una URL del tipo http://servidor:puerto/directorio_virtual/karat.jnlp o http://servidor:puerto/directorio_virtualpara conectar mediante HTTP.
Para conectar directamente con una configuración, puede añadir el nombre de la configuración al final de la URL, por ejemplo: https://servidor:puerto/html/configuration.
Iniciar una sesión de trabajo en la nueva Movilidad
Para acceder a la aplicación, simplemente es necesario crear un acceso directo en la pantalla de inicio del dispositivo. Esto se logra ingresando la URL proporcionada en el navegador web del móvil. Al hacerlo, se redirige a la pantalla de selección de configuración inicial. Seleccionada la configuración, se presenta la pantalla de autenticación, en la que se pueden ingresar las credenciales para acceder a todas las funcionalidades de la aplicación.
Se utiliza la misma URL para móvil y escritorio; el sistema detecta el tipo de dispositivo y redirige adecuadamente, por ejemplo, la URL debería ser del tipo https://servidor:puerto/site.
Iniciar una sesión de trabajo en Movilidad
Dispositivos con iOS
Para iniciar una sesión de trabajo en iPhone o iPad, utilizar el acceso directo del escritorio. Para instalar en Movilidad en el iPhone o iPad, se debe descargar la aplicación desde iTunes.
Para configurar la conexión con el servidor de Cegid, seleccionar Cegid en Ajustes e indicar la información siguiente:
- Credenciales
- Usuario. Usuario de plataforma en la configuración.
- Contraseña. Contraseña de plataforma.
- Servidor
- Nombre. Nombre o dirección del servidor de Platform.
- Puerto. Habitualmente, es el puerto 5580.
- Directorio virtual. Habitualmente, es karat.
- Configuración. Nombre de la configuración de Platform.
- Secure.Para la utilización de HTTPS.
Dispositivos con Android
Para iniciar una sesión de trabajo en Android, utilizar el accesodirecto del escritorio. Para instalar en Movilidad en Android, mediante el navegador de Internet, acceder a http://servidor:puerto/karat/ekon.apk y seguir los pasos de la instalación.
Si la aplicación no está configurada, al iniciar se muestra el formulario de configuración. Para modificar la configuración, seleccionar los ajustes de la aplicación.
- Credenciales
- Usuario. Usuario de plataforma en la configuración.
- Contraseña. Contraseña de plataforma.
- Servidor
- Nombre. Nombre o dirección del servidor de Platform.
- Puerto. Habitualmente, es el puerto 5580.
- Directorio virtual. Habitualmente, es karat.
- Configuración. Nombre de la configuración de Platform.
- Secure. Para la utilización de HTTPS.
Si antes, durante o después de la instalación tiene algún problema, revise el apéndice referente a listas de verificación o póngase en contacto con el departamento de Soporte de Cegid SMB, SAU:
- Llamando al número de teléfono 902 227 000.
- Enviando un mensaje de correo electrónico a la dirección gp_ekon-soporte@cegid.com.
- En la web (opción Web de clientes en la barra superior de la pantalla).
Proceso de desinstalación
El proceso de desinstalación está basado en Platform installer. Para iniciar la desinstalación, seleccione la opción Uninstall del grupo de programas de Platform.
También puede desinstalar ejecutando el script de inicio uninstall, en la subcarpeta installer de la instalación de Platform.
Durante la desinstalación
Los pasos del asistente de desinstalación son los siguientes:
1. Bienvenida
Visualización de mensaje de bienvenida.
Si se marca la casilla Full uninstall, se borra completamente todo el árbol de carpetas de la instalación de Platform. Si no se marca, no borra las siguientes subcarpetas: conf, ext, logs, translator, work.
2. Proceso de desinstalación
Antes de proceder a borrar los directorios de Platform, se solicita la confirmación y, al aceptar, se muestran las acciones realizadas durante la desinstalación. En caso contrario, se cancela la desinstalación.
Si se producen errores al intentar borrar carpetas y/o ficheros bloqueados, seleccionar la opción Ignorar y, después de la desinstalación, realizar una eliminación manual de éstos.
3. Desinstalación finalizada
Indica si el proceso ha finalizado correctamente. Si en el paso previo se han producido errores al intentar borrar carpetas y/o ficheros, se deben eliminar manualmente.
Listas de verificación
Para el servidor de base de datos
Para todos los tipos de base de datos
- El servidor de base de datos se ha instalado según las indicaciones del fabricante.
Microsoft SQL Server
- Verificación de la lista genérica.
- Verificación de que el protocolo TCP/IP está activado y definido el puerto.
MySQ
- Verificación de la lista genérica.
Oracle
- Verificación de la lista genérica.
InterSystems Caché
- Verificación de la lista genérica.
Para el cliente Platform
- Verificación de que se puede iniciar una sesión de trabajo.
Para el servidor de aplicaciones
- Verificación de que se puede iniciar una sesión de trabajo.
Para el servidor principal
- Verificación de que se pueden definir configuraciones.
- Verificación de que se puede iniciar una sesión de trabajo.