Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice

Índice
outlinetrue
stylenone
exclude.*ndice
stylenone

Objective

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

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 Fluigplatform, 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 Fluigplatform, 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
titleImportant

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:


  1. 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.


    Figure 1- Company's parameters in the ECM.


  2. 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.

    Figure 2 - Data volume of TOTVS ECM.


  3. The number of registered users in TOTVS ECM cannot exceed the number of available users in the License Service.
  4. 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;
  5. 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;
  6. Remove all scheduled tasks registered in TOTVS ECM;

...

From this point on, the installation of Fluig can be executed according to the instructions in the guideFluig the guide Platform installation (Installer) -Windows or  Fluig installation (Installer) - 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
titleInfo

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.

...

Deck of Cards
effectDuration0.5
historyfalse
idsampleshistoryfalse
effectTypefade
Card
defaulttrue
id1
labelConsole Mode (Windows)

Run the file <<FLUIG_HOME_PATH>> \jboss\bin\standalone.bat. 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
id2
labelService 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.

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, 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) ===============================================

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

Run the file <<FLUIG_HOME_PATH>>\jboss\bin\standalone.sh. 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
titleImportant
  • 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:

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

    Figure 4 - Process of conversion of ECM base to Fluig.


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

    Figure 5 - Conversion process started.

  6. To track the conversion process, access the file: <<FLUIG_HOME_PATH>> \jboss\standalone\log\conversion.log;
  7. The phrase "Conversion completed successfully" appears at the end of the log file and indicates the end of the conversion process;
  8. 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:

  1. Indexation of volume.
  2. 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.
  3. 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
    titleAttention

    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
    languagehtml/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
    titleObservaçã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
    titleAlternative 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.

     

     



  4. Re-add the global events or other customizations that have been removed before starting the conversion;
  5. Re-register the task schedules that were removed before starting the conversion, if they are still needed;
  6. 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.