La actualización del producto puede contener procedimientos manuales anteriores y posteriores a la actualización ejecutada por la Consola de gestión de entornos. Antes de iniciar el proceso de actualización se recomienda ejecutar todas las tareas de actualización previa aplicable a su entorno.
=====================
ETAPAS ACTUALIZACIÓN PREVIA
=====================
-------------------------------------------------------
1. Versión del Progress OpenEdge
-------------------------------------------------------
Versiones Progress OpenEdge homologadas para el producto Datasul:
- Para clientes que utilizan Progress 10.2B deben aplicar el service pack 8 y el FIX 050 (10.2B.0850).
- Para clientes que utilizan Progress 11.6 deben aplicar el service pack 3 y FIX 15 (11.6.3.015).
Por lo tanto, los clientes que desean migrar al Progress 11 deben solicitar al equipo de la Central de servicios TOTVS (CST) la versión Progress 11.6.
Observación: A partir del Datasul 12.1.18 (previsto para Octubre/17), la expedición de los programas se realizará solamente en la versión OpenEdge 11.6.3, no habiendo expedición en 10.2B.
Si necesita de apoyo para actualización de su entorno, la Consultoría telefónica puede ayudarle (4003-0015, opción 2 Software, 3 Consultoría telefónica, 4 Datasul, 8 Tecnología, 3 Base de datos).
Más información disponible en la Comunidad D@-CAT y Portal de clientes.
-------------------------------------------------------
2. Habilitar secuencias 64Bits Progress
-------------------------------------------------------
Al crearse la base de datos con versión inferior al Progress 10.2B no se había habilitado una feature denominada “64 Bit Sequences”, siendo posible solamente la creación de secuencias 32bits.
Para atender la necesidad de definiciones de las secuencias del Datasul 12 debe habilitar esta feature para no generar error durante la creación de los objetos.
Con el siguiente comando puede verificarse si existe la feature habilitada en la base de datos, utilizando el PROENV del Progress:
proutil nome-banco -C describe
Para habilitar la feature debe ejecutar el siguiente comando en la base de datos, utilizando el PROENV del Progress:
proutil nome-banco -C enableseq64
Al ejecutar nuevamente la verificación debe aparecer la feature habilitada.
-------------------------------------------------------
3. Sustitución de las bases de datos en el sistema destino
-------------------------------------------------------
IMPORTANTE: La no utilización de todas las bases de datos sugeridos por los medios de comunicación de la instalación del producto puede causar resultados inesperados en el sistema. Solamente deje de utilizar alguna base de datos si fuera explícitamente recomendado por el soporte técnico del producto Datasul.
El Datasul 12 estará compuesto por las bases de datos actualizados, más las bases correspondientes a novas funcionalidades, puestas a disposición por los medios de comunicación de programas. Los siguientes archivos del sistema Datasul también deben verificarse para considerar las bases convertidas:
- Archivo .pf de conexión de las bases: verificar si las bases convertidas están consideradas en la conexión, así como bases específicas traídas en el proceso.
- Archivo progress-ds.xml en el JBoss: la base con datos “EMS2UNI” es necesaria para la ejecución del entorno Flex. Este archivo contiene los parámetros de conexión a esta base, que puede estar unificada a las bases de datos origen.
- Programa de alias, si se unifican sus bases.
Además de la modificación de estos archivos, verifique los registros de “Base de datos empresa” y “Relación Empresa vs. Usuarios”, dentro del sistema Datasul.
La Consola de gestión de entornos efectúa la conversión de un sistema en cada ejecución. Es recomendable finalizar la conversión de todos los productos origen antes de utilizar el producto Datasul 12 en producción.
-------------------------------------------------------
4. Base de datos Oracle
-------------------------------------------------------
Si no utiliza los owners estándar definidos por TOTVS, debe modificarse la propiedad “_for-owner” de los objetos de los Schemas-image.
-------------------------------------------------------
5. Base de datos SQL Server
-------------------------------------------------------
Si no utiliza el estándar de conexión DSN-less para base de datos SQL Server, debe modificarse para que la actualización se efectúe en el entorno.
Básicamente una conexión DSN-less (Data Source Name-less, o conexión sin fuente de datos) permite que la aplicación especifique todos los parámetros directamente en la línea de conexión a la base, sin necesidad de configurar una fuente de datos ODBC, sin embargo el driver ODBC aún es necesario para conexión y debe estar instalado en la máquina que realizará el acceso.
-------------------------------------------------------
6. Upgrade y Update Bases de historiales
-------------------------------------------------------
Clientes que utilizan bases de historiales y que desean efectuar el proceso de update para este conjunto de bases, deben utilizar una copia de seguridad de las bases de registro en el formato origen, junto con las bases de historiales conectados en la sesión, con los nombres lógicos de sus respectivas bases de movimiento. Esta configuración es semejante al atajo para consulta de datos de las bases de historiales.
Actualmente las bases de historiales homologadas para el producto TOTVS Datasul son:
- (EMS5) MOVFIN – Financiero (base multi)
- (EMS2) MOVADM – Administrativo (base multi)
- (EMS2) MOVRAC – Comisiones de representantes (base multi)
- (EMS2) MOVIND – Industrial (base mono)
- (EMS2) MOVDIS – Distribución (base mono)
- EMS2) MOVMNT – Mantenimiento industrial (base mono)
- (EMS2) MOVMFG – Piso de fábrica (base mono)
- (EMS2) MOVFIS – Fiscal (base mono)
===================
ETAPAS POST ACTUALIZACIÓN
===================
Al final del proceso de actualización se recomienda ejecutar todas las tareas de actualización posterior aplicables a su entorno.
Al final del proceso de actualización es posible borrar los siguientes directorios. Estos directorios son copias de seguridad de la versión anterior del producto.
Ubicación\Archivo
JBOSS_HOME\server\instance-8080\deploy\datasul-byyou-12.1.1X-SNAPSHOT.rej
JBOSS_HOME\server\instance-8080\deploy\datasul-sso-ear-12.1.1X-SNAPSHOT.rej
Verificar también los siguientes ítems:
-------------------------------------------------------
1. Parámetros del Jboss
-------------------------------------------------------
Con la liberación del nuevo Portal (Ventas, MLA y CRM) en el Datasul para que se muestre el menú, es necesario un ajuste en el parámetro -Xss del JBOSS.
El administrador del entorno debe ejecutar el siguiente procedimiento:
- Parar el Jboss.
- Editar el archivo ...\ServidorAplicacao\jboss-4.2.3.GA\bin\run.bat;
- Ubicar el parámetro -Xss.
- Modificar el parámetro existente a -Xss256k;
- Inicie el JBOSS.
-------------------------------------------------------
2. Verificación del Propath
-------------------------------------------------------
Es importante realizar una validación en el PROPATH definido para el Datasul, básicamente debe verificarse si todos los directorios definidos existen físicamente, no existiendo más deben retirarse del PROPATH, eso impacta mucho en el desempeño, pues al buscar el directorio espera el retorno del sistema operativo para informar que no existe y pase al próximo directorio.
-------------------------------------------------------
3. Versión del Java
-------------------------------------------------------
ALERTA: para efectuar la activación del JBOSS debe utilizarse VM Java expedida por la Oracle.
La versión mínima del JAVA para activar el servicio del JBOSS es la 1.7.0_80, motivo por el cual algunas implementaciones solamente funcionan con esta versión o superior, siempre y cuando se mantenga en la versión 1.7 del JAVA.
Si el servidor tiene sistema operativo de 64-bits puede utilizarse una versión JAVA 64bits, para utilizar los recursos disponibles del servidor.
Para las estaciones de trabajo puede utilizarse la versión 1.8 del JAVA
-------------------------------------------------------
4. Base de datos Oracle y SQL Server
-------------------------------------------------------
La Consola de gestión de entornos realiza la modificación de los parámetros de conexión para importar los deltas, sin embargo si utiliza base de datos Oracle o SQL Server debe realizarse el siguiente procedimiento después de la conversión.
Una vez finalizado el proceso, salir de la Consola e interrumpa las áreas de before-imagen con el Comando de interrupción del before-imagen siguiente:
proutil nombre-del-schemaholder –C truncate bi
Esto es necesario porque la consola utiliza -1 para conectarse al schema-holder, para realizar las modificaciones de diccionario. Generalmente se utiliza el parámetro -RO para conectarse al schema-holder, si no se hubiera hecho el truncate se mostrará el siguiente mensaje en cada acceso.
WARNING: Before image file of database is not truncated. (1552)
Al ejecutar el truncate del schema-holder este mensaje no se mostrará más, permitiendo solamente la conexión de modo lectura (-RO) para schema-holders (Oracle y SQL Server).
ALERTA: Si no utiliza los owners estándar definidos por TOTVS, debe modificarse la propiedad “_for-owner” de los objetos de los Schemas-image, para entornos con base de datos Oracle.
-------------------------------------------------------
5. Permisos usuarios Oracle
-------------------------------------------------------
Al configurarse algunos programas como TimeOut para el entorno que tiene base de datos Oracle, accede a las tablas de control (v$session) y dependiendo del nivel de permiso del usuario puede aparecer el mensaje "table or view does not exist".
Debido a eso se sugiere la creación de una ROLE, para que se atribuyan los permisos necesarios a todos los usuarios Oracle configurados para Datasul.
CREATE ROLE "DATASUL";
GRANT ALTER SYSTEM TO "DATASUL";
GRANT CREATE SEQUENCE TO "DATASUL";
GRANT CREATE SESSION TO "DATASUL";
GRANT CREATE TABLE TO "DATASUL";
GRANT SELECT ANY DICTIONARY TO "DATASUL";
GRANT SELECT ANY TABLE TO "DATASUL";
GRANT SELECT ANY SEQUENCE TO "DATASUL";
GRANT SELECT ON "SYS"."ARGUMENT$" TO "DATASUL";
GRANT SELECT ON "SYS"."COL$" TO "DATASUL";
GRANT SELECT ON "SYS"."COM$" TO "DATASUL";
GRANT SELECT ON "SYS"."CON$" TO "DATASUL";
GRANT SELECT ON "SYS"."DUAL" TO "DATASUL";
GRANT SELECT ON "SYS"."ICOL$" TO "DATASUL";
GRANT SELECT ON "SYS"."IND$" TO "DATASUL";
GRANT SELECT ON "SYS"."LINK$" TO "DATASUL";
GRANT SELECT ON "SYS"."OBJ$" TO "DATASUL";
GRANT SELECT ON "SYS"."PROCEDURE$" TO "DATASUL";
GRANT SELECT ON "SYS"."SEQ$" TO "DATASUL";
GRANT SELECT ON "SYS"."SYN$" TO "DATASUL";
GRANT SELECT ON "SYS"."TAB$" TO "DATASUL";
GRANT SELECT ON "SYS"."TS$" TO "DATASUL";
GRANT SELECT ON "SYS"."USER$" TO "DATASUL";
GRANT SELECT ON "SYS"."VIEW$" TO "DATASUL";
GRANT "CONNECT" TO "DATASUL";
GRANT "RESOURCE" TO "DATASUL";
Una vez realizada la creación debe conceder a los usuarios la ROLE creada, ejemplo:
GRANT DATASUL TO EMS2CAD;
IMPORTANTE: Es necesario atribuir los permisos a todos los usuarios configurados en el Datasul, básicamente todos los registrados en el programa bases por empresa (btb\btb962aa.r).
-------------------------------------------------------
6. Conexión Srcadger
-------------------------------------------------------
El cliente que utiliza el Gestión de planes debe identificar si en el archivo de configuración del JBOSS tiene la conexión de la base de datos SRCADGER, para evitar errores durante la utilización del Gestión de planes.
Este archivo de configuración se encuentra en el directorio de la instancia del JBOSS en ...\ServidorAplicacao\jboss-4.2.3.GA\server\instance-8x80\deploy\ y tiene el nombre de acuerdo con la base de datos del entorno.
Ejemplo:
- progress-ds.xml - base de datos Progress
- oracle-ds.xml - base de datos Oracle
- mssql-ds.xml - base de datos SQL Server
--> Contenido para base de datos Progress:
<local-tx-datasource>
<jndi-name>srcadger</jndi-name>
<connection-url>jdbc:datadirect:openedge://<SERVIDOR-BANCO>:<PORTA-SQL>;databaseName=srcadger</connection-url>
<driver-class>com.ddtek.jdbc.openedge.OpenEdgeDriver</driver-class>
<user-name>pub</user-name>
<password>pub</password>
<metadata>
<type-mapping>PostgreSQL 7.2</type-mapping>
</metadata>
<min-pool-size>1</min-pool-size>
<max-pool-size>30</max-pool-size>
</local-tx-datasource>
<local-tx-datasource>
<jndi-name>ErpDS</jndi-name>
<connection-url>jdbc:datadirect:openedge://<SERVIDOR-BANCO>:<PORTA-SQL>;databaseName=srcadger</connection-url>
<driver-class>com.ddtek.jdbc.openedge.OpenEdgeDriver</driver-class>
<user-name>pub</user-name>
<password>pub</password>
<metadata>
<type-mapping>PostgreSQL 7.2</type-mapping>
</metadata>
<min-pool-size>1</min-pool-size>
<max-pool-size>30</max-pool-size>
</local-tx-datasource>
- Sustituya el valor <SERVIDOR-BANCO> por el IP o nombre del servidor de la base de datos SRCADGER.
- Sustituya el valor <<PORTA-SQL> por el puerto SQL activado para la base de datos SRCADGER.
--> Contenido para base de datos Oracle:
<local-tx-datasource>
<jndi-name>srcadger</jndi-name>
<connection-url>jdbc:oracle:thin:@<SERVIDOR-ORACLE>:1521:<INSTANCIA-ORACLE></connection-url>
<driver-class>oracle.jdbc.driver.OracleDriver</driver-class>
<user-name>srcadger</user-name>
<password>srcadger</password>
<exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name>
<metadata>
<type-mapping>Oracle10g</type-mapping>
</metadata>
<min-pool-size>1</min-pool-size>
<max-pool-size>8</max-pool-size>
</local-tx-datasource>
<local-tx-datasource>
<jndi-name>ErpDS</jndi-name>
<connection-url>jdbc:oracle:thin:@ <SERVIDOR-ORACLE>:1521:<INSTANCIA-ORACLE></connection-url>
<driver-class>oracle.jdbc.driver.OracleDriver</driver-class>
<user-name>srcadger</user-name>
<password>srcadger</password>
<exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name>
<metadata>
<type-mapping>Oracle10g</type-mapping>
</metadata>
<min-pool-size>1</min-pool-size>
<max-pool-size>8</max-pool-size>
</local-tx-datasource>
- Sustituya el valor <SERVIDOR-ORACLE> por el IP o nombre del servidor en el que se instaló la instancia Oracle.
- Sustituya el valor <INSTANCIA-ORACLE> por el nombre de la instancia Oracle donde se creó SRCADGER.
--> Contenido para base de datos SQL Server:
<local-tx-datasource>
<jndi-name>srcadger</jndi-name>
<connection-url>jdbc:sqlserver://<SERVIDOR-SQLSERVER>;instanceName=<NOME-BANCO>;databaseName=srcadger</connection-url>
<driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driver-class>
<user-name>totvs</user-name>
<password>totvs</password>
<metadata>
<type-mapping>MS SQLSERVER2008</type-mapping>
</metadata>
<min-pool-size>1</min-pool-size>
<max-pool-size>8</max-pool-size>
</local-tx-datasource>
<local-tx-datasource>
<jndi-name>ErpDS</jndi-name>
<connection-url>jdbc:sqlserver://<SERVIDOR-SQLSERVER>;instanceName=<NOME-BANCO>;databaseName=srcadger</connection-url>
<driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driver-class>
<user-name>totvs</user-name>
<password>totvs</password>
<metadata>
<type-mapping>MS SQLSERVER2008</type-mapping>
</metadata>
<min-pool-size>1</min-pool-size>
<max-pool-size>8</max-pool-size>
</local-tx-datasource>
- Sustituya el valor <SERVIDOR-SQLSERVER> por el IP o nombre del servidor en el que se instaló el SQL Server.
- Substituya el valor <NOME-BANCO> por el nombre de la base de datos que se creó para el SRCADGER.