Caro Cliente,

O TOTVS ECM 3.0 foi fundamentado na tecnologia de interface Flash, do qual a Adobe irá descontinuar seu suporte em 31/12/2020.

Recomendamos que nossos clientes avaliem a utilização do TOTVS Fluig Plataforma, que proporciona uma maior abrangência de recursos e importantes inovações tecnológicas. São inúmeras novidades não só em ECM e BPM que o Fluig entrega aos seus mais de 4 mil clientes, mas também conta com recursos de portais, social e identidade única.

Entre em contato com seu executivo de conta para saber mais detalhes desta oferta.

Índice


Objetivo

Este documento tem como objetivo instruir quem deseja converter o WebDesk 2.04 para o TOTVS | ECM. No exemplo citado no documento abaixo a conversão é feita de um banco de dados Progress® para um banco de dados MySQL™.


Realizar backup dos bancos do WebDesk 2.04.


Reparar Banco Progress®

Ao copiar o banco Progress® para outro diretório, não é possível conectar ao banco até que seja reparado. Para reparar o banco é necessário executar a seguinte linha de comando em uma script ou no prompt de comando:

c:\<dir_inst_Progress>\bin\_dbutil prostrct repair <nome_do_banco> <arquivo.st>.

Observe que o arquivo de estrutura (arquivo.st) deve ser alterado para que a nomenclatura das pastas esteja coerente com a nova localização do banco de dados.


Conectar bancos WebDesk e WdkForms em modo Mono-usuário

Edite o arquivo .pf e coloque o parâmetro “-1”.

Certifique-se de que os programas de conversão estejam no propath da sessão Progress®.


Executar programa de conversão



  • Abrir um editor Progress® conectado nos bancos acima citados e executar o seguinte script:

    RUN config\convgui-300.w.

 



  • O programa de conversão deverá ser executado duas vezes. Na primeira vez é realizada a conversão do dicionário de dados (definições) e na segunda vez a conversão dos dados (conteúdo das tabelas).

Ao executar o programa de conversão utilizar uma licença Progress® que permita alterar a definição do dicionário de dados.



  • Ao executar pela segunda vez deve ser informado o volume default no campo “Diretório do Volume Default”. Em seguida clique em Iniciar.

O programa valida se o local informado para volume default é valido.


  • Clique em sim e serão criados os diretórios de publicação automaticamente.

  • Assim que você executar novamente o script, ele informará eventuais diretórios inexistentes, necessários para concluir a conversão. Clique em “SIM”, eles serão criados automaticamente.

  • Após este passo a conversão dos dados será concluída, podendo fechar a sessão Progress® quando terminar.



  • Assim que concluído a conversão do dicionário e dos dados, você deverá, através do prompt de comando, executar o programa DBTools para corrigir os tamanhos dos campos (length). Entretanto, antes de executar o programa DBTools, você deve verificar se existe configurada a variável de ambiente DLC, apontando para o diretório da instalação do Progress®, por exemplo: c:\progress\openedge. Concluída a configuração da variável DLC, você deverá adicionar o diretório “bin" do Progress® ao valor da variável de ambiente PATH.

    Depois de concluída as configurações devidas nas variáveis, você deverá no prompt de comando acessar o diretório aonde se encontra o banco do TOTVS | ECM, dentro deste diretório digite dbtool <nome do banco>, como no exemplo abaixo:



  • Escolha a opção 2 SQL Width scan w/Fin Option na tela abaixo. Ele irá ler todas as tabelas e corrigi-las.



  • Escolha a conexão que será feita com o banco – a opção deverá ser a Singer User – “0” se o banco não estiver no ar.



  • Escolha a porcentagem que o banco poderá ser aumentado em proporção do que se tem hoje – “100” de 100%.



  • Quais tabelas serão lidas – Todas as tabelas – “all”.



  • Escolha todas as áreas – Todas as áreas – “all”.



  •  Nível de log mostrado em tela – de 0 a 3 – “3”.



  • A tela abaixo identifica o final do processo e identifica quantos erros foram encontrados e quantos erros foram corrigidos. Digite EXIT para sair do prompt de comando.




Migração dos dados WebDesk 2.04 para o TOTVS | ECM

Após o banco de dados Progress® ter sido convertido do WebDesk 2.04 para o TOTVS | ECM, este banco ainda não estará pronto para ser utilizado. Será necessário criar um banco vazio com a estrutura das tabelas do TOTVS | ECM e copiar esta base intermediária para a base de destino.

 Mesmo que o banco de dados utilizado no TOTVS | ECM seja Progress®, faça os passos de criação de uma banco vazio, ou seja, não utilize o banco recém convertido. Verifique os pré-requisitos específicos para os bancos Progress®, descritos no capítulo abaixo, antes de iniciar o serviço do TOTVS | ECM


  • Para isso, acesse o programa de serviços do Windows® (services.msc) e inicie o service “TOTVS ECM” (byyouecm ou jboss_webdesk nas versões anteriores). Como esta carga pode demorar um pouco, aguarde de três a cinco minutos, abra o sistema de gerenciamento de Banco de Dados que você optou na instalação do TOTVS | ECM e verifique se as tabelas foram criadas. Em caso positivo pode interromper o serviço do TOTVS | ECM. Eventuais erros podem ser consultados no arquivo de log do servidor de aplicação do ECM.


  • Com o banco Progress® recém convertido carregado, execute o programa openDbcopy. Neste programa serão conectadas as bases origem (Progress® recém convertida) e a base de destino (aquela escolhia na mídia de instalação do produto). Ele fará a cópia dos dados da base origem para a base de destino.
  •  Este programa pode ser obtido no endereço:  http://opendbcopy.sourceforge.net.
  •  Após a sua instalação, será necessário registrar o driver JDBC do Progress® nesta ferramenta.

  •  Copiar os arquivos base.jar, openedge.jar e util.jar, do diretório “lib" da instalação do TOTVS | ECM (<INSTALL_ECM>\server\default\lib) para o diretório “lib” da instalação do openDbcopy (Ex: C:\Arquivos de programas\openDBcopy\lib).

  • Alterar o arquivo SQLDrivers.xml das configurações no openDbcopy, disponível no diretório de configurações do usuário no sistema operacional (Ex: C:\Documents and Settings\administrator\.opendbcopy\conf), adicionando as linhas abaixo:


<driver name="OpenEdge Driver">
<class name="com.ddtek.jdbc.openedge.OpenEdgeDriver" />
<url value="jdbc:datadirect:openedge://SERVER:PORT;databaseName=DATABASENAME" />
</driver>


Para mais informações pode ser consultada a documentação disponível no site da ferramenta, tanto para a instalação do software como para o registro de novos drivers. Para utilizar o openDbcopy, execute o script start.bat, localizado na pasta “bin” do diretório de instalação do openDbcopy. Entre em “Plugin→ Select new Plugin→ Copy data from a source into a destination database”.


  • Clique em ”dir ()” e defina um diretório onde serão gerados os logs de erros. Clique em NEXT.

  • Na ABA Database Connection – Será definido os parâmetros de conexão do banco de origem (Progress®) e de destino (no caso MySQL™). Lembrando que o banco de destino pode ser de qualquer tipo (Oracle®, Microsoft® SQL Server™, etc...).
  • Clicar no apply&Test de origem, caso a execução seja bem sucedida no rodapé da tela irá aparecer a URL de conexão, caso contrário aparecerá o erro em tela.

  • Clicar no apply&Test de destino.

  • Clique em NEXT.


Na guia de Models:

  • Marcar todos os checks e clicar em Capture Source Model de origem (na parte de cima da tela). Serão lidas todas as tabelas e campos do banco, no rodapé irá dar a mensagem Source Model done.
  • Marcar todos os checks e clicar em Capture Source Model de destino (na parte de baixo da tela). Serão lidas todas as tabelas e campos do banco, no rodapé irá dar a mensagem Destination Model done.


Caso o banco destino seja SQL SERVER a opção “Use fully qualified table names” deve ser desmarcada, para o Source e Destination Model. E também no campo Schema, do Destination Model, deve ser selecionado o usuário “DBO”.


  • Clique em NEXT.


  • Na ABA Table Mapping – Estará comparando todas as tabelas de origem com as novas de destino.



  • Na ABA Column Mapping - Estará comparando todos os campos de origem com as novas de destino.



  • Na ABA Global String Filters deixar desmarcado todos os checks.



  • Clique em NEXT.


  • Na ABA Execute Plugin, clique em EXECUTE.



  • Ao finalizar a conversão irá aparecer no rodapé à mensagem Execution done.



  • Verifique se ocorreram erros analisando o diretório informado no campo dir() nos passos anteriores. Caso tenha ocorrido algum erro, trate a situação ou acione o suporte para verificação. Não prossiga com a utilização do produto enquanto ocorrer erros na cópia dos dados, pois o banco poderá apresentar inconsistências ocasionando erros no produto.
  • Não ocorrendo erros, a conversão do banco de dados estará completa. Os bancos intermediários webdesk e wdkforms não são mais necessários. Lembrando que é de extrema importancia manter um backup da versão antiga do Webdesk, para evetuais consultas.
  • Para configurar o seu servidor de e-mails, entre no diretório server\default\deploy, dentro do diretório de instalação do TOTVS | ECM, no arquivo mail-service.xml, altere o mail.smtp.host (servidor de e-mail) e se for preciso, mail.smtp.port (porta servidor de e-mail).
  • Após concluir a conversão, inicie o serviço do TOTVS | ECM, entre no administrador do SAAS com o login wdkAdmin e senha adm, e verifique se os parâmetros gerais estão corretos.


Bancos Progress®, devido às características de sua arquitetura, apresentam um desempenho inferior aos demais bancos homologados.

Criando e dando permissão de administrador para o usuário “pub”:

Caso seja utilizado o Banco de Dados Progress® no produto TOTVS | ECM, faz-se necessário alguns procedimentos:


- Abrir um editor Progress®, conectado no banco “webdesk.db” que acabou de ser convertido.
- Acessar a opção “Tools”, “Data Administration


  • Na tela de Data Administration, selecione Admin → Security → Edit User List.



  • Na tela Edit User List, clique em Add para adicionar um usuário para o banco de dados.



  •  Na tela Add User, deve ser criado o usuário “sysprogress”. Informar uma senha para este usuário. Após preencher os campos clique em OK.


  •  Na tela Password Verification, digite novamente a senha do usuário “sysprogress” e clique em OK.


  • Após criar o usuário “sysprogress”, clicar em Add na tela Edit User List para criar um outro usuário.



  •  Na tela Add User, deve ser criado o usuário “pub”. Informar uma senha para este usuário. Após preencher os campos clique em OK.



  •  Na tela Password Verification, digite novamente a senha do usuário “pub” e clique em OK.


  • Após estes passos os dois usuários, “sysprogress” e “pub”, estarão criados. Na tela Edit User List, clique em OK para finalizar a criação dos usuários.
  •  Para o correto funcionamento do TOTVS | ECM, é necessário que o usuário “pub” (informado na instalação do produto) tenha privilégios para atualizar tabelas no banco de dados. Para permitir que o usuário “pub” tenha privilégios de administrador deve-se clicar em Iniciar → Todos os programas → Selecionar a versão do Progress® → clicar em Proenv.

 


  • Será apresentada a tela Proenv.



Na tela Proenv, digite:

sqlexp -db <nome_do_banco> -S <porta> -H <servidor> -user sysprogress -password <senha que foi cadastrada> e aperte Enter.

Após executar este comando, o SQLExplorer será habilitado na linha de comando.

No exemplo foi utilizado “sqlexp -db wdk3midia -S 38002 -H corp-luiz -user sysprogress -password sysprogress”.



Em SQLExplorer, digite: grant dba to pub; E aperte Enter. Este comando faz com que o usuário “pub” tenha privilégios administrativos no banco de dados



 Para efetuar os privilégios do usuário “pub” como administrador, deve-se digitar o comando commit no SQLExplorer.



 Para saber se o usuário “pub” obteve privilégios administrativos pode-se visualizar a tabela de administradores do banco de dados. Em SQLExplorer, digite: select * from sysdbauth; E aperte Enter. Após executar esse comando, serão apresentados todos os usuários administradores do banco de dados.


Após concluir as alterações, digite “quit” e aperte Enter para sair do SQLExplorer. Por fim, digite “exit” e aperte Enter para fechar a tela do Proenv.



Pré-requisitos necessários para utilizar Banco de Dados Oracle®

Antes de iniciar o serviço abaixo é necessário que o administrador do banco Oracle® (DBA) efetue algumas alterações de segurança no banco de dados Oracle®, fazendo com que o usuário (schema) informado na instalação do produto TOTVS | ECM (arquivo <INSTALL_ECM>\server\default\deploy\wdk-ds.xml) não possua permissão de leitura/alteração em outros schemas do banco Oracle®, caso existam.
Deve possuir permissão de leitura/alteração (dba) somente no usuário (schema) utilizado pelo produto TOTVS | ECM.


Alteração de senha dos usuários

Após a migração do Webdesk 2.04 para o TOTVS | ECM a senha de todos os usuários é invalidada. A alteração da senha dos usuários deve ser realizada pela funcionalidade “Forgot Password” disponível na tela de login do produto.

Informe o login do usuário e clique sobre o link “Forgot Password”. Uma mensagem de confirmação será apresentada. Confirme a alteração da senha e uma nova senha será enviada para o usuário por email.

Com a nova senha em mãos o usuário pode acessar o seu perfil e alterar sua senha para uma de sua preferência.

Nos casos em que a funcionalidade não está acessível é possível alterar diretamente no banco de dados. Este procedimento deve ser realizado pelo administrador do banco de dados. Altere o campo senha da tabela colaborador.


A senha do usuário deve ser criptografada usando o algoritmo MD5.

Indexação

Quando o TOTVS | ECM é instalado a partir da migração do Webdesk 2.04 é necessário reindexar o conteúdo do repositório do produto. Para reindexar o repositório acesse GED > Indexação.Duas opções estão disponíveis são elas:



Licenciamento

Verifique o Guia de Instalação ECM como configurar o servidor de licenças.