Conversin TOTVS | ECM

Gua de Conversin TOTVS | ECM

Conversin TOTVS | ECM

Copyright 2009 TOTVS S.A. Todos los derechos reservados. Ninguna parte de este documento puede ser copiada, reproducida, traducida o transmitida por cualquier medio electrnico o mecnico, en su totalidad o en parte, sin la previa autorizacin escrita de TOTVS S.A., que se reserva el derecho de hacer alteraciones sin aviso finiquito. TOTVS S.A no asume ninguna responsabilidad por las consecuencias de cualesquiera errores o inexactitudes que puedan aparecer en este documento. TOTVS S.A. Av. Santos Dumont, 831, Joinville, SC, Brasil, CP 89.222-900

Conversin TOTVS | ECM

Objetivo
El objetivo de este documento es la instruccin para quien desea convertir el WebDesk 2.04 para el TOTVS | ECM. En el ejemplo citado en el documento abajo la conversin es hecha de una base de datos Progress para una base de datos MySQL.

IMPORTANTE :
Hacer Backup de las bases del WebDesk 2.04.

Reparar Base Progress

Al copiar la base Progress para otro directorio, no es posible conectar a la base hasta que sea reparado. Para reparar la base es necesario ejecutar la siguiente lnea de comando en un script o en el prompt de comando: c:\<dir_inst_Progress>\bin\_dbutil prostrct repair <nome_do_banco> <arquivo.st>. Observe que el archivo de estructura (archivo.st) debe ser alterado para que la nomenclatura de las carpetas est coherente con la nueva localizacin de la base de datos.

Conecte bases WebDesk y WdkForms en modo Mono-usuario

Edite el archivo .pf y ponga el parmetro -1. IMPORTANTE : Certifquese de que los programas de conversin estn en el propath de la sesin Progress.

Ejecutar programa de conversin

Abrir un editor Progress conectado en las bases arriba citados y ejecutar el siguiente script: RUN config\convgui-300.w.

Conversin TOTVS | ECM

El programa de conversin deber ser ejecutado dos veces. En la primera vez es realizada la conversin del diccionario de datos (definiciones) y en la segunda vez la conversin de los datos (contenido de las tablas). IMPORTANTE: Al ejecutar el programa de conversin utilizar una licencia Progress que permita alterar la definicin del diccionario de datos.

Al ejecutar por la segunda vez debe ser informado el volumen default en el campo Directorio del Volumen Default. IMPORTANTE: El programa valida si el local informado para volumen default es vlido.

Conversin TOTVS | ECM

Pulse s y sern creados los directorios de publicacin automticamente. As que usted ejecutar nuevamente el script, l informar eventuales directorios inexistentes, necesarios para concluir la conversin. Pulse SI, ellos sern creados automticamente. Despus de este paso la conversin de los datos ser concluida, pudiendo cerrar la sesin Progress cuando terminar.

As que concluida la conversin del diccionario y de los datos, usted deber, a travs del prompt de comando, ejecutar el programa DBTools para corregir los tamaos de los campos (length). Sin embargo, antes de ejecutar el programa DBTools, usted debe verificar si existe configurada la variable de ambiente DLC, apuntando para el directorio de la instalacin del Progress, por ejemplo: c:\progress\openedge. Concluida la configuracin de la variable DLC,

Conversin TOTVS | ECM

usted deber aadir el directorio bin" del Progress al valor de la variable de ambiente PATH. Despus de concluidas las configuraciones debidas en las variables, usted deber en el prompt de comando acceder el directorio donde se encuentra la base del TOTVS | ECM, dentro de este directorio digite dbtool <nombre de la base>, como en el ejemplo abajo.

Elija la opcin 2 SQL Width scan w/Fin Option en la pantalla abajo. l ler todas las tablas y corregirlas.

Elija la conexin que ser hecha con la base la opcin deber ser la Singer User 0 si la base no estuviere en el aire.

Elija el porcentaje que la base podr ser aumentada en proporcin de que se tiene hoy 100 de 100%.

Conversin TOTVS | ECM

Cules tablas sern ledas Todas las tablas all.

Elija todas las reas Todas las reas all.

Nivel de log mostrado en pantalla de 0 hasta 3 3.

La pantalla abajo identifica el final del proceso e identifica cuantos errores han sido encontrados y cuantos errores han sido corregidos. Digite EXIT para salir del prompt de comando.

Conversin TOTVS | ECM

Migracin de los datos WebDesk 2.04 para el TOTVS | ECM

Despus de la base de datos Progress haber sido convertido del WebDesk 2.04 para el TOTVS | ECM, esta base an no estar lista para ser utilizado. Ser necesario crear una base vaca con la estructura de las tablas del TOTVS | ECM y copiar esta base intermediaria para la base de destino. ATENCIN: Mismo que la base de datos usada en el TOTVS | ECM sea Progress, haga los pasos de creacin de una base vaca, o sea, no use la base recin convertida. Verifique los prerrequisitos especficos para las bases Progress, descritas en el captulo abajo, antes de iniciar el servicio del TOTVS | ECM. Para eso, acceda el programa de servicios del Windows (services.msc) y empiece el service TOTVS ECM (byyouecm o jboss_webdesk en las versiones anteriores). Como esta carga puede demorar un rato, espere de trs a cinco minutos, abra el sistema de gerenciamiento de Base de Datos que usted eligi en la instalacin del TOTVS | ECM y verifique si las tablas fueron creadas. En caso positivo puede interrompir el servicio del TOTVS | ECM. Eventuales errores pueden ser consultados en el archivo de log del servidor de aplicacin del ECM. Con la base Progress recin convertida cargada, ejecute el programa openDbcopy. En este programa sern conectadas a las bases origen (Progress recin convertida) y a base de destino (aquella elegida en la media de instalacin del producto). l har la copia de los datos de la base origen para la base de destino. Este programa puede ser http://opendbcopy.sourceforge.net. obtenido en la direccin:

Despus de su instalacin, ser necesario registrar el driver JDBC del Progress en esta herramienta: - Copiar los archivos base.jar, openedge.jar y util.jar, del directorio lib" de la instalacin del TOTVS | ECM (<INSTALL_ECM>\server\default\lib) para el directorio lib de la instalacin del openDbcopy (Ej.: C:\Archivos de programas\openDBcopy\lib). - Alterar el archivo SQLDrivers.xml de las configuraciones en el openDbcopy, disponible en el directorio de configuraciones del usuario en el sistema operativo (Ej.: C:\Documents and Settings\administrator\.opendbcopy\conf), aadiendo las lneas abajo:

Conversin TOTVS | ECM

<driver name="OpenEdge Driver"> <class name="com.ddtek.jdbc.openedge.OpenEdgeDriver" /> <url value="jdbc:datadirect:openedge://SERVER:PORT;databaseName=DATABA SENAME" /> </driver> Para ms informaciones puede ser consultada la documentacin disponible en el sitio de la herramienta, tanto para la instalacin del software como para el registro de nuevos drivers Para utilizar el openDbcopy, ejecute el script start.bat, ubicado en la carpeta bin del directorio de instalacin del openDbcopy. Entre en Plugin/Select new Plugin/ Copy data from a source into a destination database.

Pulse dir () y defina un directorio donde sern generados los logs de errores. Pulse NEXT.

Conversin TOTVS | ECM

En la PESTAA Database Connection Sern definidos los parmetros de conexin de la base de origen (Progress) y de destino (en el caso MySQL). Recordando que la base de destino puede ser de cualquier tipo (Oracle, Microsoft SQL Server, etc...). Pulse el apply&Test de origen, si la ejecucin tenga xito en el rodapi de la pantalla aparecer la URL de conexin, al contrario aparecer el error en pantalla. Pulse el apply&Test de destino. Pulse NEXT.

En la gua de Models:

10

Conversin TOTVS | ECM

Marque todos los checks y pulse Capture Source Model de origen (en la parte de riba de la pantalla). Sern ledas todas las tablas y campos de la base, en el rodapi dar el mensaje Source Model done. Marque todos los checks y pulse Capture Source Model de destino (en la parte de abajo de la pantalla). Sern ledas todas las tablas y campos de la base, en el rodapi dar el mensaje Destination Model done. ATENCION: Si la base destino sea SQL SERVER, la opcin Use fully qualified table names debe ser desmarcada, para el Source y Destination Model. Y tambin en el campo Schema, del Destination Model, debe ser seleccionado el usuario DBO. Pulse NEXT.

En la PESTAA Table Mapping Estar comparando todas las tablas de origen con las nuevas de destino.

11

Conversin TOTVS | ECM

En la PESTAA Column Mapping - Estar comparando todos los campos de origen con las nuevas de destino. Pulse NEXT.

En la PESTAA Global String Filters deje desmarcados todos los checks. Pulse NEXT.

12

Conversin TOTVS | ECM

En la PESTAA Ejecute Plugin, pulse EJECUTE.

Al finalizar la conversin, aparecer en el rodapi el mensaje Execution done.

13

Conversin TOTVS | ECM

Verifique si ocurrieron errores analisando el directorio informado en el campo dir() en los pasos anteriores. Si haya ocurrido algn error, trate la situacin o llame el soporte para verificacin. No prosiga con el uso del producto mientras ocurrir errores en la copia de los datos, pues la base podr presentar inconsistencias causando errores en el producto. No ocurriendo errores, la conversin de la base de datos estar completa. Las bases intermediarias webdesk y wdkforms no son ms necesarias. Recordando que es de extrema importancia mantener backup de la versin antigua del Webdesk, para evetuales consultas. Para configurar su servidor de emails, entre en el directorio server\default\deploy, dentro del directorio de instalacin del TOTVS | ECM, en el archivo mail-service.xml, altere el mail.smtp.host (servidor de email) y si necesario, mail.smtp.port (porta servidor de email). Despus de concluir la conversin, empiece el servicio del TOTVS | ECM, entre en el administrador del SAAS con el login wdkAdmin y contrasea adm, y verifique si los parmetros generales estn correctos.

Prerrequisitos necesarios para utilizar Base de Datos tipo Open Edge (Progress): (para los otros tipos de base, no se aplica)
ATENCION: Bases Progress, debido a las caractersticas de su arquitectura, presentan un desempeo inferior a las otras bases validadas.

Creando y dando permiso de administrador para el usuario pub:

Si sea utilizada la Base de Datos Progress en el producto TOTVS | ECM, son necesarios algunos procedimientos: - Abrir un editor Progress, conectado en la base webdesk.db que acab de ser convertido.

14

Conversin TOTVS | ECM

- Acceder la opcin Tools, Data Administration

En la pantalla de Data Administration, seleccione Admin Security Edit User List.

En la pantalla Edit User List, pulse Add para aadir un usuario para la base de datos.

15

Conversin TOTVS | ECM

En la pantalla Add User, debe ser creado el usuario sysprogress. Informar una contrasea para este usuario. Despus de rellenar los campos pulse OK.

En la pantalla Password Verification, digite nuevamente la contrasea del usuario sysprogress y pulse OK.

Despus de crear el usuario sysprogress, pulse Add en la pantalla Edit User List para crear otro usuario.

16

Conversin TOTVS | ECM

En la pantalla Add User, debe ser creado el usuario pub. Inform e una contrasea para este usuario. Despus de rellenar los campos pulse OK.

En la pantalla Password Verification, digite nuevamente la contrasea del usuario pub y pulse OK.

Despus de estos pasos, los dos usuarios, sysprogress y pub, estarn creados. En la pantalla Edit User List, pulse OK para finalizar la creacin de los usuarios.

17

Conversin TOTVS | ECM

Para el correcto funcionamiento del TOTVS | ECM, es necesario que el usuario pub (informado en la instalacin del producto) tenga privilegios para actualizar tablas en la base de datos. Para permitir que el usuario pub tenga privilegios de administrador se debe pulsar Iniciar Todos los programas Seleccionar la versin del Progress pulse Proenv.

18

Conversin TOTVS | ECM

Ser presentada la pantalla Proenv.

19

Conversin TOTVS | ECM

En la pantalla Proenv, digite sqlexp -db <nombre_de_base> -S <puerta> -H <servidor> -user sysprogress -password <contrasea que fue catastrada> y pulse Enter. Despus de ejecutar este comando, el SQLExplorer ser habilitado en la lnea de comando. En el ejemplo fue utilizado sqlexp -db wdk3midia -S 38002 -H corp-luiz -user sysprogress -password sysprogress.

En SQLExplorer, digite: grant dba to pub;

20

Conversin TOTVS | ECM

Y pulse Enter. Este comando hace con que el usuario pub tenga privilegios administrativos en la base de datos.

Para ejecutar los privilegios del usuario pub como administrador, se debe digitar el comando commit en el SQLExplorer.

21

Conversin TOTVS | ECM

Para saber si el usuario pub obtuvo privilegios administrativos se puede visualizar la tabla de administradores de la base de datos. En SQLExplorer, digite: select * from sysdbauth; E pulse Enter. Despus de ejecutar ese comando, sern presentados todos los usuarios administradores de la base de datos.

Despus de concluir las alteraciones, digite quit y pulse Enter para salir del SQLExplorer. Por fin, digite exit y pulse Enter para cerrar la pantalla del Proenv.

Prerrequisitos necesarios para utilizar Base de Datos Oracle

Antes de empezar el servicio abajo es necesario que el administrador de la base Oracle (DBA) haga algunas alteraciones de seguridad en la base de datos Oracle, haciendo con que el usuario (schema) informado en la instalacin del producto TOTVS | ECM (archivo <INSTALL_ECM>\server\default\deploy\wdk-ds.xml) no posea permiso de lectura/alteracin en otros schemas de la base Oracle, si existan. Debe poseer permiso de lectura/alteracin (dba) slo en el usuario (schema) utilizado por el producto TOTVS | ECM.

Alteracin de contrasea de los usuarios

Despus de migracin del Webdesk 2.04 para el TOTVS | ECM la contrasea de todos los usuarios es invalidada.

22

Conversin TOTVS | ECM

La alteracin de la contrasea de los usuarios debe ser realizada por la funcionalidad Forgot Password disponible en la tpantalla de login del producto. Informe el login del usuario y pulse el link Forgot Password. Un mensaje de confirmacin ser presentad. Confirme la alteracin de la contrasea y una nueva contrasea ser enviada para el usuario por email. Con la nueva contrasea en manos el usuario puede acceder su perfil y alterar su contrasea para una de su preferencia. En los casos en que la funcionalidad no est accesible es posible alterar directamente en la base de datos. Este procedimiento debe ser realizado por el administrador de la base de datos. Altere el campo contrasea de la tabla empleado. IMPORTANTE: La contrasea del usuario debe ser criptografada usando el algoritmo MD5.

Indexacin
Cuando el TOTVS | ECM es instalado a partir de la migracin del Webdesk 2.04 es necesario reindexar el contenido del repositorio del producto. Para reindexar el repositorio acceda GED > Indexacin. Dos opciones estn disponibles: Todo el repositorio: realiza la indexacin de todo el contenido creado en el repositorio. El tiempo de indexacin depiende de la dimensin del repositorio del producto; Slo documentos alterados o nuevos documentos: es el modo de indexacin de emergencia. Ejecuta la indexacin para documentos que fueron publicados y por alguna circunstancia no pudieron ser indexados en el momento de su publicacin.

Licenciamiento
Verifique el Gua de Instalacin ECM como configurar el servidor de licencias.

23

Conversin TOTVS | ECM

Third Party Trademarks
Adobe, Flash, Flex, Flex Builder, PostScript and Reader are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries. Apache is a trademark of The Apache Software Foundation. Apple is a trademark of Apple Inc., registered in the U.S. and other countries Firefox and Mozilla are registered trademarks of the Mozilla Foundation. Google, Android and Google Chrome are trademarks of the Google Inc. IOS is a trademark or registered trademark of Cisco in the U.S. and other countries and is used under license JavaScript is a trademark of Oracle Corporation. Liferay, Liferay Portal, and the Liferay logo are trademarks or registered trademarks of Liferay, Inc., in the United States and other countries. Linux is the registered trademark of Linus Torvalds in the U.S. and other countries. Microsoft, Active Directory, Excel, Internet Explorer, Outlook, PowerPoint, SQL Server, Windows and Windows Vista are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. MySQL is a trademark of Oracle Corporation and/or its affiliates. openDBcopy is an open-source project by Anthony Smith, published under the terms of the GNU General Public License OpenLDAP is a registered trademark of the OpenLDAP Foundation Oracle, Java and OpenOffice.org are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Progress and OpenEdge are trademarks or registered trademarks of Progress Software Corporation or one of its subsidiaries or affiliates in the U.S. and other countries. Red Hat and JBoss are registered trademarks of Red Hat, Inc. in the United States and other countries. This product includes software developed by the Visigoth Software Society (http://www.visigoths.org/).
Any other third party trademarks are the property of their respective owners.

24