Índice

outline	true
style	none
exclude	.*ndice
style	none

Objetivo

El objetivo de este guía es instruir a los administradores de sistemas que desean realizar la conversión del TOTVS ECM para la plataforma Fluig.

Conversión para el Fluig

Siga a continuación las etapas y procedimientos necesarios para la conversión del TOTVS ECM para el Fluig.

Copia de Seguridad

Nota

A fin de preservar los recursos y datos del TOTVS ECM en el caso que ocurra algún error durante el proceso de conversión es importante realizar una copia de seguridad de los siguientes ítems:

Recursos utilizados en el TOTVS ECM: como Ficheros, Datasets personalizados, Procesos workflow, Eventos de ficheros, Eventos de Procesos, Eventos Globales, Servicios, Aplicaciones, Parámetros Generales, Templates de e-mail, Mecanismos de Atribución, y demás personalizaciones utilizadas en el TOTVS ECM. Es importante exportar el máximo de estos recursos, para una mejor manipulación durante el proceso de homologación después la conversión del TOTVS ECM para el Fluig, ademas de posibilitar la importación en el Fluig en caso que sea necesario posteriormente.
Banco de datos: Importante poseer una copia de seguridad del banco de datos para el caso que sea necesaria la restauración del último estado válido de la instalación del TOTVS ECM. Si desea mantener la instalación antigua es válido realizar la duplicación de la base de datos, de tal manera que el mismo contenido asuma un nuevo nombre. Por ejemplo, la base de datos del TOTVS ECM, por estándar se llama totvsecm, mientras para el Fluig se nombran como fluig.
Volumen: Si desea mantener la instalación antigua del TOTVS ECM, después de la conversión los volúmenes registrados en el TOTVS ECM aun se utilizarán. Con eso, los datos en los mismos podrán sufrir cambios en la utilización del Fluig, y al ser compartidos entre los dos sistemas puede causar conflictos y errores en la utilización. Para evitar esta situación es necesaria la copia de los volúmenes para un nuevo lugar. La copia de seguridad de los volúmenes también es necesaria en el caso que sea necesaria la restauración del último estado válido de la instalación del TOTVS ECM.

Antes de la Conversión

Nota

title	Importante

Para que el proceso de conversión se realice con éxito, es necesario que el TOTVS ECM esté en la versión más actual de los paquetes de actualización, disponible en el Portal de Clientes. En el caso que el ambiente esté desactualizado, se recomienda realizar la actualización y posteriormente proseguir con las etapas para conversión.

Realice las copias de seguridad descritas en el ítem anterior y en el caso que se utilice una nueva base de datos, restaure la copia de seguridad de la base de datos sobre esta nueva base.

Antes de realizar la conversión es necesario realizar algunos procedimientos:

...

Figura 1 - Parámetros de la Empresa en el ECM.

...

Image Removed

Figura 2 - Volume(s) de dados do TOTVS ECM.

...

El colaborador no puede poseer login, e-mail o matrícula duplicada;
El login del colaborador debe poseer solamente caracteres alfanuméricos, punto (.), guión ( - ) y guión bajo (_);
El nombre del colaborador no puede exceder el límite máximo de 255 caracteres;
El e-mail del colaborador debe ser un e-mail válido;
La contraseña del colaborador no puede ser en blanco.

...

Elimine todas las programaciones de tareas registradas en el TOTVS ECM.

Objective

The goal of this guide is to instruct system administrators who wish to perform the conversion of TOTVS ECM to the TOTVS Fluig Platform.

Conversion to platform

See the following steps and procedures necessary for the conversion of TOTVS ECM to TOTVS Fluig Platform.

Backup copy

Nota

In order to preserve the resources and data from TOTVS ECM in case there is an error during the conversion process, it is important to run a backup of the following items:

Resources used in TOTVS ECM: as Binders, customized Dataset, Workflow processes, Binder events, process events, global events, services, applications, general parameters, e-mail templates, attribute mechanisms, and other customizations used in TOTVS ECM. It is important to export as many of these resources as possible, for better handling during the approval process after the conversion of TOTVS ECM to TOTVS Fluig Platform in addition to enabling the import to platform, if necessary, later on.
Database: It is important to have a backup copy of the database to restore the last valid state of installation of TOTVS ECM, if necessary. If you want to keep the old installation, it is a good idea to replicate the database so that the same content assumes a new name. For example, the database of TOTVS ECM, by default, is called totvsecm, while for platform, they are named fluig.
Volume: If you wish to keep the old installation of TOTVS ECM, after conversion, the volumes registered in TOTVS ECM will still be used. With this, the data in them may suffer changes in the use of TOTVS Fluig Platform, and this sharing between the two systems can cause conflicts and errors during use. To avoid this situation it is necessary to copy the volumes to a new location. It is important to have a backup copy of the volume to restore the last valid state of installation of TOTVS ECM, if necessary.

Before conversion

Nota

title	Important

In order to carry out the conversion process successfully, it is necessary that TOTVS ECM is in its most current version update package, available in the Customer Portal. If the environment is outdated it is recommended to update it and then proceed with the steps for conversion.

Run backups described in the previous item and, if a new database is used, restore the backup copy of the database on this new one.

Before executing the conversion, it is necessary to follow some procedures:

Make sure that TOTVS Fluig Platform will respond on the same IP address and HTTP/HTTPS port as the current version of TOTVS ECM. If you do not use these same access criteria, start the TOTVS ECM service for this new database, if applicable. When you start the TOTVS ECM service, access the TOTVS ECM companies registers and change access settings, i.e. the Web server and Web port fields, as shown in Figure 1.

Image Added
Figure 1- Company's parameters in the ECM.
If you wish to change the location of the volumes, it is important that you execute the action before the conversion so access the Volume tab and make the necessary changes.
Image Added
Figure 2 - Data volume of TOTVS ECM.
The number of registered users in TOTVS ECM cannot exceed the number of available users in the License Service.
Make sure that all the users that are registered in TOTVS ECM meet the following requirements:
1. The user cannot possess duplicate login, email or registration;
2. The user's login must have only alphanumeric characters, period (.), hyphen (-) and underscore (_);
3. The name of the user cannot exceed the maximum limit of 255 characters;
4. The user's email must be a valid email address;
5. The user's password cannot be blank;
If any of the users do not meet the requirements provided, it is necessary to adapt them to these requirements;
Remove any global event or other customization that handles the posting of documents or other features of TOTVS ECM. For example: a global event beforeDocumentPublisher that does not allow posting in the root folder;
Remove all scheduled tasks registered in TOTVS ECM;

When you finish these procedures, disconnect and stop the TOTVS ECM service.

From this point on, the installation of Fluig can be executed according to the instructions in the guide Platform installation (Installer) -Windows or Linux

Starting Fluig

For the migration process, when Fluig is initialized on a database used by TOTVS ECM, table structures belonging to the latter remain the same. However, Fluig will create its tables separately.

Informações

title	Info

In the case of a new service initialization or failure on reboot, it may be necessary to terminate processes with Image name equal to soffice.bin and the location of the file is for the Fluig installation directory in the Windows Task Manager. This is accessible through the CTRL + SHIFT + ESC shortcut keys or by right-clicking on the task bar and in the pop-up menu selecting the Start the Task Manager option. If these processes exist, they should be terminated.

Nota

title	Important

It is mandatory that the user used to boot the system by the console mode or as operating system service has permission to change the Fluig setup folders and volume used by Fluig.

Check the startup modes below and choose the one you want to use to start Fluig:

Deck of Cards

effectDuration	0.5
history	false
id	samples

Al finalizar estos procedimientos, desconecte y pare el servicio del TOTVS ECM.

A partir de eso, se puede realizar la instalación del fluig conforme a instrucciones disponibles en la guía Instalación Fluig (Instalador) - Windows o Instalación Fluig (Instalador) - Linux.

Iniciando el Fluig

Para el proceso de migración, cuando el Fluig se inicializa sobre una base de datos utilizada por el TOTVS ECM las estructuras de las tablas de este último permanecen de la misma forma. Sin embargo, el Fluig creará sus tablas, separadamente.

Informações

title	Observación

En el caso de que una nueva inicialización del servicio o fallas en la reinicialización puede ser necesario finalizar los procesos con Nombre de la Imagen igual a soffice.bin y el lugar del archivo esté para el directorio de instalación del Fluig en el Administrador de Tareas del Windows (Task Manager). Este es accesible por las teclas de atajo CTRL+SHIFT+ESC o haciendo clic con el botón derecho del mouse sobre la barra de tareas y en el menú popup seleccionar la opción de Iniciar el Administrador de Tarefas. Si estos procesos existen se deben finalizar.

Nota

title	Importante

Es obligatorio que el usuario utilizado para inicializar el sistema por el modo console o como servicio del sistema operativo posea permiso de modificación de las carpetas de la instalación del Fluig y del(de los) Volumen(es) utilizado(s) por los Fluig.

Verifique los modos de inicialización a seguir y elija aquel que desea utilizar para iniciar el Fluig:

Deck of Cards

effectDuration	0.5
id	samples
history	false
effectType	fade

Card

default	true
id	1
label	Modo Console Mode (Windows)

Ejecute el archivo Run the file <<FLUIG_HOME_PATH>> \jboss\bin\standalone.bat. Con eso una ventana del Prompt de Comando se abre exhibiendo las informaciones de la inicialización y mensajes del servidor JBoss. Cuando haya necesidad de parar la ejecución del sistema, presione las teclas CTRL+C.

With this a command prompt window opens displaying the startup information and messages of the JBoss server. When it is necessary to stop the execution of the system, press the CTRL + C keys.

Card

id	2
label	Modo Serviço Service Mode (Windows)

Access Windows Services through Control Panel and Administrative Tools group, or execute the services.msc command in Command prompt. Locate the Fluig service and click the Start the service button, on the menu bar, or Start in the pop-up menu displayed by right-clicking on the service.

Image Added

Acceda los Servicios del Windows a través del Panel de Control y grupo Herramientas Administrativas o ejecute el comando services.msc en el Prompt de Comando. Localice el servicio Fluig y haga clic sobre el botón Iniciar el servicio, en la barra de menús, o en Iniciar en el menú popup exhibido al hacer clic con el botón derecho del mouse sobre el servicio.

Image Removed

Figura 3 - Ventana de Servicios del Windows. Servicio del Fluig seleccionado e inicializado.

La verificación de la inicialización del Fluig se puede observar a través del archivo de log en

Figure 3 - Windows Services window. Fluig service selected and initialized.

The Fluig startup conference can be observed through the log file in

<<FLUIG_HOME_PATH>> \jboss\standalone\log\server.log,

cuando posea cerca de 1,0 MB y contenga la inscripción

when it has about 1.0 MB and contains the inscription:

HH:MM:SS,mmm INFO [com.fluig.startup.service.FluigStartupBean] (EJB default - x) ===============================================
HH:MM:SS,mmm INFO [com.fluig.startup.service.FluigStartupBean] (EJB default - x) == Fluig is up and running right now. ==
HH:MM:SS,mmm INFO [com.fluig.startup.service.FluigStartupBean] (EJB default - x) ===============================================

El tiempo para inicialización del servicio puede variar de acuerdo con los recursos del servidor en que el Fluig se ejecutará.

Card

id	3
label	Modo Console (Linux)

The time for service startup may vary according to the capabilities of the server on which Fluig will be executed.

Ejecute el archivo

Run the file

<<FLUIG_HOME_PATH>>\jboss\bin\standalone.sh.

Con esto el log de inicialización se exhibirá, en la terminal, con las informaciones de la inicialización y mensajes del servidor JBoss. Cuando haya necesidad de parar la ejecución del sistema, presione las teclas CTRL+C.

Conversión

...

With this the boot log is displayed in the terminal, with the boot information and messages of the JBoss server. When it is necessary to stop the execution of the system, press the CTRL + C keys.

Conversão

Neste momento, pode ser iniciado o processo de conversão.

Nota

title

...

Este es un proceso irreversible, pues el Fluig realizará la lectura de las tablas del TOTVS ECM y transportará sus datos a las respectivas tablas del Fluig. Algunas tablas del TOTVS ECM se excluirán en este proceso de conversión.
Durante el proceso pueden ocurrir fallas y comprometer la base de datos. En el caso que eso ocurra, utilice la copia de seguridad, creada anteriormente, para restaurar la base de datos.
En el caso de utilizar el banco de datos SQL Server, mire la configuración en el ítem Configuración del banco de datos SQL Server.
Los documentos del tipo Portal y PortalPage no se convertirán. Su conversión se deberá realizar manualmente, es decir, será necesario crear las páginas en el Fluig, a través del ítem Mis páginas presente en la guía Panel de Control, pestaña WCM.

Esté atento a los pasos a seguir para iniciar la conversión:

...

Image Removed

Figura 4 - Proceso de conversión de la base ECM para Fluig.

...

Image Removed

...

Important

This is an irreversible process, because TOTVS Fluig Platform will do the reading of the tables of TOTVS ECM and transport its data to the respective tables of TOTVS Fluig Platform. Some tables of TOTVS ECM will be deleted in this conversion process.
Failures can occur during the process, and compromise the database. If this happens use the backup copy created earlier, to restore the database.
In case of use of the SQL Server database, refer to the settings in item SQL Server database settings.
The Portal and PortalPage type of documents will not be converted. Its conversion must be executed manually, i.e. you will need to create the pages on Fluig, through the My Pages item in the Control Paneltab, WCMtab.

Pay attention to the following steps to start the conversion:

After initializing Fluig, it is necessary to login using the user name wcmadmin and password adm;
Once you've logged in, access the Control Panelmenu item and click on the ECM tab, in that tab access the Base converter option;
With this, the base validation to verify that the conversion can be started will be executed. Figure 4 illustrates this process;

Image Added
Figure 4 - Process of conversion of ECM base to Fluig.
If non-conformities are not found, click Convert;
When you click Convert, a message is displayed, as shown in Figure 5, indicating the beginning of the conversion;

Image Added
Figure 5 - Conversion process started.
To track the conversion process, access the file:

...

Image Removed

Figura 6 - Pantalla de login Fluig.

Posconversión o migración

Cuando un proceso de conversión se realiza, algunos procedimiento son necesarios para que los servicios del Fluig puedan presentar sus funcionalidades correctamente. Se recomiendan los siguientes pasos:

...

<<FLUIG_HOME_PATH>> \jboss\standalone\log\conversion.log;

...

The phrase "Conversion completed successfully" appears at the end of the log file and indicates the end of the conversion process;
From this moment, it is possible to connect Fluig with users and passwords that existed in TOTVS ECM. To manage companies, the user wcmadmin is used and not wdkAdmin any longer.

Post conversion or migration

When a conversion process is executed, some procedures are necessary so that Fluig services can present its features properly. The following steps are recommended:

Indexation of volume.
Data services update for TOTVS ECM. This is the modification of these services for the recreation of stubs, in case of changes in the webservice URLs used.
For migration and where TOTVS ECM was integrated with TOTVS ECM/HCM, see if the folder

<<FLUIG_HOME_PATH>> \jboss\modules\com

...

contains the directories progress\main

...

with libraries (JAR)

...

of their Progress.

Nota
title

...

Attention
This is not the JAR generated by ProxyGen (Proxy Generator),

...

they are the old environment libraries registered in TOTVS ECM. This procedure is necessary, because in this version of the product such register of environments and indication of libraries no longer exist. The JBoss AS 7, requires that access to these common JAVA classes of Progress are initialized as a module of JBoss.

Inside this folder next to libraries there must be a file called "module.xml." Within its contents, all these libraries must be related. Remember that the file must be saved with UTF-8 code (without BOM). The file follows the standard

...

:

Bloco de código

language	html/xml

<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.1" name="com.progress">
   <properties>
        <property name="jboss.api" value="private"/>
   </properties>

...


   <resources>
        <resource-root path="o4glrt.jar"/>
        <resource-root path="common.jar"/>
        <resource-root path="commonj.sdo.jar"/>
        <resource-root path="ecore.change.jar"/>
        <resource-root path="ecore.jar"/>
        <resource-root path="ecore.resources.jar"/>
        <resource-root path="ecore.sdo.jar"/>
        <resource-root path="ecore.xmi.jar"/>
        <resource-root path="openedge.jar"/>
        <resource-root path="progress.jar"/>
   </resources>
</module>

Informações

title

...

Observação

After this setting the restart of Fluig is mandatory so that these libraries are loaded into the classpath of JBoss AS 7. Until this is executed, the operations will return an error like: JavaException: java.lang.ClassNotFoundException: com.progress.open4gl.ProDataGraphHolder.

...

Or another class in an attempt to create an object in the package com.progress.*.
Nota
title

...

Alternative Treatment

A way to enable the use of these classes by the proxy generated is to add the contents of these libraries within the package of this proxy, that is, the files of type and extension JAR are compressed files like ZIP, each of these libraries can be opened by your preferred file compression application (WinZIP, WinRAR, 7-ZIP,

...

among others) and their contents copied into the .JAR file of the proxy. Only the folders and their "META-INF" contents should be ignored, not copied.
Re-add the global events or other customizations that have been removed before starting the conversion;
Re-register the task schedules that were removed before starting the conversion, if they are still needed;
If, when accessing Fluig, targeting occurs to the address <host>:<port> which belonged to TOTVS ECM, that means the address of access was not changed before the conversion (as mentioned in the session Before conversion) and therefore it will be necessary to change the access address in Fluig, entering as wcmadmin and going to the ControlPanel tab, WCM tab, System settingsitem

...

.

Árvore de páginas

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave

Índice

Objetivo

Conversión para el Fluig

Copia de Seguridad

Antes de la Conversión

Objective

Conversion to platform

Backup copy

Before conversion

Starting Fluig

Iniciando el Fluig

Conversión

Conversão

Posconversión o migración

Post conversion or migration

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 1

Nova versão Atual

Chave

Índice

Objetivo

Conversión para el Fluig

Copia de Seguridad

Antes de la Conversión

Objective

Conversion to platform

Backup copy

Before conversion

Starting Fluig

Iniciando el Fluig

Conversión

Conversão

Posconversión o migración

Post conversion or migration