Вы находитесь на странице: 1из 24
Conversión TOTVS | ECM Guía de Conversión TOTVS | ECM

Conversión TOTVS | ECM

Guía de Conversión TOTVS | ECM

Conversión TOTVS | ECM Copyright © 2009 TOTVS S.A. Todos los derechos reservados. Ninguna parte

Conversión 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 electrónico o mecánico, en su totalidad o en parte, sin la previa autorización 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

2

Conversión TOTVS | ECM Objetivo El objetivo de este documento es la instrucción para quien

Conversión TOTVS | ECM

Objetivo

El objetivo de este documento es la instrucción para quien desea convertir el WebDesk 2.04 para el TOTVS | ECM. En el ejemplo citado en el documento abajo la conversión 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 línea 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 localización de la base de datos.

Conecte bases WebDesk y WdkForms en modo Mono-usuario

Edite el archivo .pf y ponga el parámetro “-1”.

IMPORTANTE : Certifíquese de que los programas de conversión estén en el propath de la sesión Progress®.

Ejecutar programa de conversión

Abrir un editor Progress® conectado en las bases arriba citados y ejecutar el siguiente script:

RUN config\convgui-300.w.

3

Conversión TOTVS | ECM El programa de conversión deberá ser ejecutado dos veces. En la

Conversión TOTVS | ECM

Conversión TOTVS | ECM El programa de conversión deberá ser ejecutado dos veces. En la primera

El programa de conversión deberá ser ejecutado dos veces. En la primera vez es realizada la conversión del diccionario de datos (definiciones) y en la segunda vez la conversión de los datos (contenido de las tablas).

IMPORTANTE: Al ejecutar el programa de conversión utilizar una licencia Progress® que permita alterar la definición del diccionario de datos.

que permita alterar la definición del diccionario de datos. Al ejecutar por la segunda vez debe

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 válido.

4

Conversión TOTVS | ECM Pulse sí y serán creados los directorios de publicación automáticamente. Así

Conversión TOTVS | ECM

Conversión TOTVS | ECM Pulse sí y serán creados los directorios de publicación automáticamente. Así que

Pulse sí y serán creados los directorios de publicación automáticamente. Así que usted ejecutar nuevamente el script, él informará eventuales directorios inexistentes, necesarios para concluir la conversión. Pulse SI”, ellos serán creados automáticamente. Después de este paso la conversión de los datos será concluida, pudiendo cerrar la sesión Progress® cuando terminar.

pudiendo cerrar la sesión Progress® cuando terminar. Así que concluida la conversión del diccionario y de

Así que concluida la conversión del diccionario y de los datos, usted deberá, a través del prompt de comando, ejecutar el programa DBTools para corregir los tamaños 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 instalación del Progress®, por ejemplo: c:\progress\openedge. Concluida la configuración de la variable DLC,

5

Conversión TOTVS | ECM usted deberá añadir el directorio “bin" del Progress® al valor de

Conversión TOTVS | ECM

usted deberá añadir el directorio “bin" del Progress® al valor de la variable de ambiente PATH. Después 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.

<nombre de la base>, como en el ejemplo abajo. Elija la opción 2 SQL Width scan

Elija la opción 2 SQL Width scan w/Fin Option en la pantalla abajo. Él lerá todas las tablas y corregirlas.

la pantalla abajo. Él lerá todas las tablas y corregirlas. Elija la conexión que será hecha

Elija la conexión que será hecha con la base la opción deberá ser la Singer User – “0” si la base no estuviere en el aire.

User – “0” si la base no estuviere en el aire. Elija el porcentaje que la

Elija el porcentaje que la base podrá ser aumentada en proporción de que se tiene hoy – “100” de 100%.

6

Conversión TOTVS | ECM Cuáles tablas serán leídas – Todas las tablas – “all”. Elija

Conversión TOTVS | ECM

Conversión TOTVS | ECM Cuáles tablas serán leídas – Todas las tablas – “all”. Elija todas

Cuáles tablas serán leídas Todas las tablas – “all”.

tablas serán leídas – Todas las tablas – “all”. Elija todas las áreas – Todas las

Elija todas las áreas Todas las áreas – “all”.

todas las áreas – Todas las áreas – “all”. Nivel de log mostrado en pantalla –

Nivel de log mostrado en pantalla de 0 hasta 3 – “3”.

de log mostrado en pantalla – de 0 hasta 3 – “3”. La pantalla abajo identifica

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.

7

Conversión TOTVS | ECM Migración de los datos WebDesk 2.04 para el TOTVS | ECM

Conversión TOTVS | ECM

Conversión TOTVS | ECM Migración de los datos WebDesk 2.04 para el TOTVS | ECM Después

Migración de los datos WebDesk 2.04 para el TOTVS | ECM

Después de la base de datos Progress® haber sido convertido del WebDesk 2.04 para el TOTVS | ECM, esta base aún no estará lista para ser utilizado. Será necesario crear una base vacía con la estructura de las tablas del TOTVS | ECM y copiar esta base intermediaria para la base de destino.

ATENCIÓN: Mismo que la base de datos usada en el TOTVS | ECM sea Progress®, haga los pasos de creación de una base vacía, o sea, no use la base recién convertida. Verifique los prerrequisitos específicos para las bases Progress®, descritas en el capítulo 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 trés a cinco minutos, abra el sistema de gerenciamiento de Base de Datos que usted eligió en la instalación 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 aplicación del ECM.

Con la base Progress® recién convertida cargada, ejecute el programa openDbcopy. En este programa serán conectadas a las bases origen (Progress® recién convertida) y a base de destino (aquella elegida en la media de instalación del producto). Él hará la copia de los datos de la base origen para la base de destino.

Este

programa

puede

ser

obtenido

en

la

dirección:

Después de su instalación, 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 instalación del TOTVS | ECM (<INSTALL_ECM>\server\default\lib) para el directorio “lib” de la instalación 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), añadiendo las líneas abajo:

8

Conversión TOTVS | ECM <driver name="OpenEdge Driver"> <class

Conversión 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 más informaciones puede ser consultada la documentación disponible en el sitio de la herramienta, tanto para la instalación 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 instalación del openDbcopy.

Entre en Plugin/Select new Plugin/ Copy data from a source into a destination database.

Copy data from a source into a destination database ” . Pulse “ dir ()” y

Pulse dir ()” y defina un directorio donde serán generados los logs de errores. Pulse NEXT.

9

Conversión TOTVS | ECM En la PESTAÑA Database Connection – Serán definidos los parámetros de

Conversión TOTVS | ECM

Conversión TOTVS | ECM En la PESTAÑA Database Connection – Serán definidos los parámetros de conexión

En la PESTAÑA Database Connection Serán definidos los parámetros de conexión 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 ejecución tenga êxito en el rodapié de la pantalla aparecerá la URL de conexión, al contrario aparecerá el error en pantalla. Pulse el apply&Test de destino. Pulse NEXT.

al contrario aparecerá el error en pantalla. Pulse el apply&Test de destino. Pulse NEXT. En la

En la guía de Models:

10

Conversión TOTVS | ECM Marque todos los checks y pulse Capture Source Model de origen

Conversión TOTVS | ECM

Marque todos los checks y pulse Capture Source Model de origen (en la parte de riba de la pantalla). Serán leídas 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). Serán leídas 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 opción “Use fully qualified table names” debe ser desmarcada, para el Source y Destination Model. Y también en el campo Schema, del Destination Model, debe ser seleccionado el usuario “DBO”.

Pulse NEXT.

debe ser seleccionado el usua rio “DBO”. Pulse NEXT. En la PESTAÑA Table Mapping – Estará

En la PESTAÑA Table Mapping Estará comparando todas las tablas de origen con las nuevas de destino.

11

Conversión TOTVS | ECM En la PESTAÑA Column Mapping - Estará comparando todos los campos

Conversión TOTVS | ECM

Conversión TOTVS | ECM En la PESTAÑA Column Mapping - Estará comparando todos los campos de

En la PESTAÑA Column Mapping - Estará comparando todos los campos de origen con las nuevas de destino. Pulse NEXT.

los campos de origen con las nuevas de destino. Pulse NEXT. En la PESTAÑA Global String

En la PESTAÑA Global String Filters deje desmarcados todos los checks. Pulse NEXT.

12

Conversión TOTVS | ECM En la PESTAÑA Ejecute Plugin, pulse EJECUTE. Al finalizar la conversión,

Conversión TOTVS | ECM

Conversión TOTVS | ECM En la PESTAÑA Ejecute Plugin, pulse EJECUTE. Al finalizar la conversión, aparecerá

En la PESTAÑA Ejecute Plugin, pulse EJECUTE.

TOTVS | ECM En la PESTAÑA Ejecute Plugin, pulse EJECUTE. Al finalizar la conversión, aparecerá en

Al finalizar la conversión, aparecerá en el rodapié el mensaje Execution done.

13

Conversión TOTVS | ECM Verifique si ocurrieron errores analisando el directorio informado en el campo

Conversión TOTVS | ECM

Conversión TOTVS | ECM Verifique si ocurrieron errores analisando el directorio informado en el campo dir()

Verifique si ocurrieron errores analisando el directorio informado en el campo dir() en los pasos anteriores. Si haya ocurrido algún error, trate la situación o llame el soporte para verificación. 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 conversión de la base de datos estará completa. Las bases intermediarias webdesk y wdkforms no son más necesarias. Recordando que es de extrema importancia mantener backup de la versión antigua del Webdesk, para evetuales consultas.

Para configurar su servidor de emails, entre en el directorio server\default\deploy, dentro del directorio de instalación 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).

Después de concluir la conversión, empiece el servicio del TOTVS | ECM, entre en el administrador del SAAS con el login wdkAdmin y contraseña adm,

y verifique si los parámetros generales están 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 características de su arquitectura, presentan un desempeño 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

Conversión TOTVS | ECM - Acceder la opción “Tools”, “Data Administration” En la pantalla de

Conversión TOTVS | ECM

- Acceder la opción “Tools”, “Data Administration”

- Acceder la opción “Tools”, “Data Administration” En la pantalla de Data Administration, seleccione Admin 

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

seleccione Admin  Security  Edit User List. En la pantalla Edit User List, pulse Add

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

15

Conversión TOTVS | ECM En la pantalla Add User, debe ser creado el usua rio

Conversión TOTVS | ECM

Conversión TOTVS | ECM En la pantalla Add User, debe ser creado el usua rio “sysprogress”.

En la pantalla Add User, debe ser creado el usuario “sysprogress”. Informar una contraseña para este usuario. Después de rellenar los campos pulse OK.

para este usuario. Después de rellenar los campos pulse OK. En la pantalla Password Verification, digite

En la pantalla Password Verification, digite nuevamente la contraseña del usuario “sysprogress” y pulse OK.

la contraseña del usua rio “sysprogress” y pulse OK. Después de crear el usua rio “sysprogress”,

Después de crear el usuario “sysprogress”, pulse Add en la pantalla Edit User List para crear otro usuario.

16

Conversión TOTVS | ECM En la pantalla Add User, debe ser creado el usua rio

Conversión TOTVS | ECM

Conversión TOTVS | ECM En la pantalla Add User, debe ser creado el usua rio “pub”.

En la pantalla Add User, debe ser creado el usuario “pub”. Informe una contraseña para este usuario. Después de rellenar los campos pulse OK.

para este usuario. Después de rellenar los campos pulse OK. En la pantalla Password Verification, digite

En la pantalla Password Verification, digite nuevamente la contraseña del usuario “pub” y pulse OK.

la contraseña del usua rio “pub” y pulse OK. Después de estos pasos, los dos usua

Después de estos pasos, los dos usuarios, “sysprogress” y “pub”, estarán creados. En la pantalla Edit User List, pulse OK para finalizar la creación de los usuarios.

17

Conversión TOTVS | ECM Para el correcto funcionamiento del TOTVS | ECM, es necesario que

Conversión TOTVS | ECM

Conversión TOTVS | ECM Para el correcto funcionamiento del TOTVS | ECM, es necesario que el

Para el correcto funcionamiento del TOTVS | ECM, es necesario que el usuario “pub” (informado en la instalación 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 versión del Progress® pulse Proenv.

18

Conversión TOTVS | ECM Será presentada la pantalla Proenv. 19

Conversión TOTVS | ECM

Conversión TOTVS | ECM Será presentada la pantalla Proenv. 19

Será presentada la pantalla Proenv.

19

Conversión TOTVS | ECM En la pantalla Proenv, digite sqlexp -db <nombre_de_base> -S <puerta> -H

Conversión TOTVS | ECM

Conversión TOTVS | ECM En la pantalla Proenv, digite sqlexp -db <nombre_de_base> -S <puerta> -H

En la pantalla Proenv, digite sqlexp -db <nombre_de_base> -S <puerta> -H <servidor> -user sysprogress -password <contraseña que fue catastrada> y pulse Enter. Después de ejecutar este comando, el SQLExplorer será habilitado en la línea de comando.

En el ejemplo fue utilizado “sqlexp -db wdk3midia -S 38002 -H corp-luiz -user sysprogress -password sysprogress”.

wdk3midia -S 38002 -H corp-luiz -user sysprogress - password sysprogress”. En SQLExplorer, digite: grant dba to

En SQLExplorer, digite: grant dba to pub;

20

Conversión TOTVS | ECM Y pulse Enter. Este comando hace con que el usua rio

Conversión TOTVS | ECM

Y pulse Enter.

Este comando hace con que el usuario “pub” tenga privilegios administrativos en la base de datos.

ten ga privilegios administrativos en la base de datos. Para ejecutar los privilegios del usua rio

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

los privilegios del usua rio “pub” como administrador, se debe digitar el comando commit en el

21

Conversión TOTVS | ECM Para saber si el usua rio “pub” obt uvo privilegios administrativos

Conversión 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.

Después de ejecutar ese comando, serán presentados todos los usuarios administradores de la base de datos.

todos los usuarios administradores de la base de datos. Después de concluir las alteraciones , digite

Después 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 instalación del producto TOTVS | ECM (archivo <INSTALL_ECM>\server\default\deploy\wdk-ds.xml) no posea permiso de lectura/alteración en otros schemas de la base Oracle®, si existan. Debe poseer permiso de lectura/alteración (dba) sólo en el usuario (schema) utilizado por el producto TOTVS | ECM.

Alteración de contraseña de los usuarios

Después de migración del Webdesk 2.04 para el TOTVS | ECM la contraseña de todos los usuarios es invalidada.

22

Conversión TOTVS | ECM La alteración de la contraseña de los usuarios debe ser realizada

Conversión TOTVS | ECM

La alteración de la contraseña 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 confirmación será presentad. Confirme la alteración de la contraseña y una nueva contraseña será enviada para el usuario por email.

Con la nueva contraseña en manos el usuario puede acceder su perfil y alterar su contraseña 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 contraseña de la tabla empleado. IMPORTANTE: La contraseña del usuario debe ser criptografada usando el algoritmo MD5.

Indexación

Cuando el TOTVS | ECM es instalado a partir de la migración del Webdesk 2.04 es necesario reindexar el contenido del repositorio del producto.

Para reindexar el repositorio acceda GED > Indexación. Dos opciones están disponibles:

Todo el repositorio: realiza la indexación de todo el contenido creado en el repositorio. El tiempo de indexación depiende de la dimensión del repositorio del producto;

Sólo documentos alterados o nuevos documentos: es el modo de indexación de emergencia. Ejecuta la indexación para documentos que fueron publicados y por alguna circunstancia no pudieron ser indexados en el momento de su publicación.

Licenciamiento

Verifique el Guía de Instalación ECM como configurar el servidor de licencias.

23

Conversión TOTVS | ECM Third Party Trademarks Adobe, Flash, Flex, Flex Builder, PostScript and Reader

Conversión 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