Índice
Objetivo
O objetivo deste documento é auxiliar os clientes da linha RM na atualização do
TAF - TOTVS Automação Fiscal e
TSS - TOTVS Service SOA utilizando a ferramenta
TOTVS Developer Studio.
Tipos de Arquivos disponíveis para atualização
Existem três extensões de arquivos para atualização do TAF e do TSS:
Antes de realizar a atualização, identifique a qual aplicativo a mesma está relacionada.
Atualização do RPO
Se o seu arquivo de atualização possuir a extensão .rpo, verifique a qual aplicativo ele pertence, antes de prosseguir com a atualização.
Deck of Cards |
---|
|
Card |
---|
label | Verificação de sistema TAF |
---|
| Na tela de download é possível identificar o sistema que será atualizado. Veja o exemplo abaixo: Download arquivo TAF: ![](/download/attachments/344461282/image2018-3-9_16-32-56.png?version=1&modificationDate=1520623978000&api=v2)
|
Card |
---|
label | Atualização RPO - TAF |
---|
| Após certificar-se que se trata de um RPO do TOTVS Automação Fiscal, acesse o diretório apo na pasta de instalação do sistema (C:\totvs\TAF\apo) e crie uma pasta com o nome "Backup". Mova o arquivo antigo para este diretório (C:\totvs\TAF\apo\Backup). Em seguida coloque o novo arquivo no diretório (C:\totvs\TAF\apo). ![](/download/attachments/344461282/image2018-3-9_15-47-42.png?version=1&modificationDate=1520621263000&api=v2)
|
Card |
---|
label | Verificação de sistema TSS |
---|
| Na tela de download é possível identificar o sistema que será atualizado. Veja o exemplo abaixo: Download arquivo TSS: ![](/download/attachments/344461282/image2018-3-9_16-37-5.png?version=1&modificationDate=1520624226000&api=v2)
|
Card |
---|
label | Atualização RPO - TSS |
---|
| Após certificar-se que se trata de um RPO do TSS - TOTVS Service SOA, acesse o diretório apo na pasta de instalação do sistema (Por padrão, o mesmo é instalado em C:\totvssped\apo, porem alguns clientes utilizaram o caminho C:\totvs\TAF\totvssped\apo, como consta no documento de instalação) e crie uma pasta com o nome "Backup". Mova o arquivo antigo para este diretório (...totvssped\apo\Backup). Em seguida coloque o novo arquivo no diretório (...totvssped\apo). ![](/download/attachments/344461282/image2018-3-9_16-53-41.png?version=1&modificationDate=1520625222000&api=v2)
|
|
Atualização do TAF utilizando o Devstudio.exe - Arquivo .ptm
Importante: Antes de realizar a atualização, certifique-se que o arquivo que será utilizado corresponde ao ambiente utilizado.
Recomendamos que seja utilizado o arquivo com o nome igual ou terminado em ...TTTP120.PTM para ambientes em português da linha RM.
Deck of Cards |
---|
|
Card |
---|
| Crie uma pasta com o nome “Atualização” (ou outro de sua preferência) no caminho C:\totvs\TAF e extraia os arquivos que serão utilizados para a atualização do sistema. ![](/download/attachments/344461282/image2018-3-9_17-17-7.png?version=1&modificationDate=1520626628000&api=v2)
|
Card |
---|
| Pare o serviço do TAF-WS nos serviços do Windows. Caso o serviço não seja parado automaticamente, apresentando a mensagem abaixo, realize o procedimento indicado na aba “Dica!” antes de prosseguir: ![](/download/attachments/344461282/image2018-3-9_17-2-22.png?version=1&modificationDate=1520625743000&api=v2)
|
Card |
---|
| Procedimento para parar o serviço através do DOS: Acesse o “Gerenciador de tarefas do Windows” > aba “Serviços” e localize o código PID do mesmo. No prompt de comando do DOS (cmd) digite: taskkill /pid XXXX /f (onde XXXX é o PID do serviço) e tecle “Enter”. Neste momento o serviço será interrompido. ![](/download/attachments/344461282/image2018-3-9_17-2-7.png?version=1&modificationDate=1520625728000&api=v2)
Realizado o procedimento de parada do serviço, voltamos para a atualização do sistema. |
Card |
---|
| Acesse o diretório C:\totvs\TAF\bin\smartclient, localize o aplicativo devstudio.exe no diretório C:\totvs\TAF\bin\smartclient e execute. A tela abaixo será apresentada. Clique em “Ok” para que o sistema seja executado. ![](/download/attachments/344461282/image2018-3-9_17-3-14.png?version=1&modificationDate=1520625796000&api=v2)
|
Card |
---|
| Neste momento o sistema que será utilizado para a atualização será aberto. Caso a informação referente ao “Ambiente” a ser atualizado esteja em branco, conforme imagem abaixo, siga os procedimentos para a configuração do mesmo. Caso já esteja preenchida com a informação “TAF”, vá para o "9º Passo". ![](/download/attachments/344461282/image2018-3-9_17-3-56.png?version=1&modificationDate=1520625838000&api=v2)
|
Card |
---|
| Acesse o menu “Arquivo > Configurações” para que a tela de apontamento do ambiente seja apresentada. ![](/download/attachments/344461282/image2018-3-9_17-4-25.png?version=1&modificationDate=1520625866000&api=v2)
|
Card |
---|
| Na tela de “Configurações de Compilação”, clique em “Adicionar” e preencha as informações exatamente como no exemplo abaixo clique em “Ok”: ![](/download/attachments/344461282/image2018-3-9_17-5-12.png?version=1&modificationDate=1520625913000&api=v2)
|
Card |
---|
| Após a realização da configuração anterior, a tela abaixo será apresentada, clique em “Ok” para finalizar a configuração: ![](/download/attachments/344461282/image2018-3-9_17-5-41.png?version=1&modificationDate=1520625943000&api=v2)
|
Card |
---|
| Verifique se a informação referente a configuração realizada será apresentada na parte superior no sistema. Caso não tenha sido apresentada automaticamente, utilize o seletor para selecionar o Alias criado: ![](/download/attachments/344461282/image2018-3-9_17-6-31.png?version=1&modificationDate=1520625992000&api=v2)
|
Card |
---|
| Após o preenchimento da informação referente ao ambiente a ser atualizado, acesse o menu “Ferramentas > Atualização de Repositório” para que o processo de atualização seja iniciado. ![](/download/attachments/344461282/image2018-3-9_17-26-19.png?version=1&modificationDate=1520627181000&api=v2)
|
Card |
---|
| A tela para digitação de usuário e senha será apresentada. Importante: Mesmo que tenha sido cadastrada uma senha para o usuário “admin” no sistema, neste momento não será necessário informa-la. Digite o usuário “admin” e clique em “Ok”: ![](/download/attachments/344461282/image2018-3-9_17-8-18.png?version=1&modificationDate=1520626100000&api=v2)
|
Card |
---|
| Neste momento será apresentada a tela referente ao diretório raiz do servidor para atualização. O sistema automaticamente irá direcionar para a pasta TAF, apresentando as pastas contidas neste diretório. Conforme indicado no início do manual, selecione a pasta criada “Atualização” para que o arquivo a ser utilizado para atualização do sistema seja apresentado. ![](/download/attachments/344461282/image2018-3-9_17-9-48.png?version=1&modificationDate=1520626189000&api=v2)
|
Card |
---|
| Selecione o arquivo a ser utilizado para que o botão “Ok” seja ativado: ![](/download/attachments/344461282/image2018-3-9_17-27-49.png?version=1&modificationDate=1520627271000&api=v2)
|
Card |
---|
| Após clicar em “Ok”, o sistema validará o arquivo selecionado e apresentará a tela informando que alguns fontes estão mais atualizados do que os que estão no RPO atual. Selecione a opção “Aceito somente fontes atualizados” ![](/download/attachments/344461282/image2018-3-9_17-28-38.png?version=1&modificationDate=1520627320000&api=v2)
|
Card |
---|
| Neste momento será apresentada uma mensagem informando que as informações referentes a este procedimento serão gravadas no arquivo RPO para posterior auditoria. Clique em “Ok” para prosseguir. ![](/download/attachments/344461282/image2018-3-9_17-29-9.png?version=1&modificationDate=1520627351000&api=v2)
|
Card |
---|
| O sistema executará a atualização e apresentará na aba mensagens (canto inferior) o status da operação e a finalização da conexão com o serviço. Image Modified
|
Card |
---|
| Após a atualização, reinicie o serviço TAF-WS nos serviços do Windows. ![](/download/attachments/344461282/image2018-3-9_17-49-38.png?version=1&modificationDate=1520628579000&api=v2)
|
|
Atualização do TSS utilizando o Devstudio.exe - Arquivo .ptm
Importante: Antes de realizar a atualização, certifique-se que o arquivo que será utilizado corresponde ao ambiente utilizado.
Recomendamos que seja utilizado o arquivo com o nome igual ou terminado em ...TTTP120.PTM para ambientes em português da linha RM.
Deck of Cards |
---|
|
Card |
---|
| Crie uma pasta com o nome “Atualização” (ou outro de sua preferência) no caminho de instalação do TSS (Por padrão, o mesmo é instalado em C:\totvssped, porem alguns clientes utilizaram o caminho C:\totvs\TAF\totvssped, como consta no documento de instalação) e extraia os arquivos que serão utilizados para a atualização do sistema. ![](/download/attachments/344461282/image2018-3-12_10-33-41.png?version=1&modificationDate=1520861622000&api=v2)
|
Card |
---|
| Pare o serviço do TSS-Appserver12 nos serviços do Windows. Caso o serviço não seja parado automaticamente, apresentando a mensagem abaixo, realize o procedimento indicado na aba “Dica!” antes de prosseguir: ![](/download/attachments/344461282/image2018-3-12_10-34-57.png?version=1&modificationDate=1520861698000&api=v2)
|
Card |
---|
| Procedimento para parar o serviço através do DOS: Acesse o “Gerenciador de tarefas do Windows” > aba “Serviços” e localize o código PID do mesmo. No prompt de comando do DOS (cmd) digite: taskkill /pid XXXX /f (onde XXXX é o PID do serviço) e tecle “Enter”. Neste momento o serviço será interrompido. ![](/download/attachments/344461282/image2018-3-12_10-36-28.png?version=1&modificationDate=1520861788000&api=v2)
Realizado o procedimento de parada do serviço, voltamos para a atualização do sistema. |
Card |
---|
| Acesse a pasta appserver (...bin\appserver) no diretório de instalação do TSS (Por padrão, o mesmo é instalado em C:\totvssped, porem alguns clientes utilizaram o caminho C:\totvs\TAF\totvssped, como consta no documento de instalação) e localize o arquivo appserver.ini. Edite este arquivo com um editor de texto, localize a tag [ONSTART], comente a mesma e salve o arquivo. Após este procedimento, inicie o serviço TSS-Appserver12. ![](/download/attachments/344461282/image2018-3-12_10-38-14.png?version=1&modificationDate=1520861895000&api=v2)
|
Card |
---|
| Após comentar a tag e iniciar o serviço, acesse o diretório smartclient (...\bin\smartclient), localize o aplicativo devstudio.exe e execute. A tela abaixo será apresentada. Clique em “Ok” para que o sistema seja executado. ![](/download/attachments/344461282/image2018-3-12_10-38-42.png?version=1&modificationDate=1520861923000&api=v2)
|
Card |
---|
| Neste momento o sistema que será utilizado para a atualização será aberto. Caso a informação referente ao “Ambiente” a ser atualizado esteja em branco, conforme imagem abaixo, siga os procedimentos para a configuração do mesmo. Caso já esteja preenchida com a informação “SPED”, vá para o 10º passo. ![](/download/attachments/344461282/image2018-3-12_10-39-15.png?version=1&modificationDate=1520861956000&api=v2)
|
Card |
---|
| Acesse o menu “Arquivo > Configurações” para que a tela de apontamento do ambiente seja apresentada. ![](/download/attachments/344461282/image2018-3-12_10-39-37.png?version=1&modificationDate=1520861977000&api=v2)
|
Card |
---|
| Na tela de “Configurações de Compilação”, clique em “Adicionar” e preencha as informações exatamente como no exemplo abaixo clique em “Ok”: ![](/download/attachments/344461282/image2018-3-12_10-40-14.png?version=1&modificationDate=1520862015000&api=v2)
|
Card |
---|
| Após a realização da configuração anterior, a tela abaixo será apresentada, clique em “Ok” para finalizar a configuração: ![](/download/attachments/344461282/image2018-3-12_10-40-49.png?version=1&modificationDate=1520862050000&api=v2)
|
Card |
---|
| Verifique se a informação referente a configuração realizada será apresentada na parte superior no sistema. Caso não tenha sido apresentada automaticamente, utilize o seletor para selecionar o Alias criado: ![](/download/attachments/344461282/image2018-3-12_10-41-19.png?version=1&modificationDate=1520862080000&api=v2)
|
Card |
---|
| Após o preenchimento da informação referente ao ambiente a ser atualizado, acesse o menu “Ferramentas > Atualização de Repositório” para que o processo de atualização seja iniciado. ![](/download/attachments/344461282/image2018-3-12_10-42-3.png?version=1&modificationDate=1520862123000&api=v2)
|
Card |
---|
| A tela para digitação de usuário e senha será apresentada. Importante: Mesmo que tenha sido cadastrada uma senha para o usuário “admin” no sistema, neste momento não será necessário informa-la. Digite o usuário “admin” e clique em “Ok”: ![](/download/attachments/344461282/image2018-3-12_10-43-28.png?version=1&modificationDate=1520862211000&api=v2)
|
Card |
---|
| Neste momento será apresentada a tela referente ao diretório raiz do servidor para atualização. O sistema automaticamente irá direcionar para a pasta totvssped, apresentando as pastas contidas neste diretório. Conforme indicado no início do manual, selecione a pasta criada “Atualização” para que o arquivo a ser utilizado para atualização do sistema seja apresentado. ![](/download/attachments/344461282/image2018-3-12_10-45-14.png?version=1&modificationDate=1520862315000&api=v2)
|
Card |
---|
| Selecione o arquivo a ser utilizado para que o botão “Ok” seja ativado: ![](/download/attachments/344461282/image2018-3-12_10-46-19.png?version=1&modificationDate=1520862379000&api=v2)
|
Card |
---|
| Após clicar em “Ok”, o sistema validará o arquivo selecionado e apresentará a tela informando que alguns fontes estão mais atualizados do que os que estão no RPO atual. Selecione a opção “Aceito somente fontes atualizados” ![](/download/attachments/344461282/image2018-3-12_10-46-52.png?version=1&modificationDate=1520862413000&api=v2)
|
Card |
---|
| Neste momento será apresentada uma mensagem informando que as informações referentes a este procedimento serão gravadas no arquivo RPO para posterior auditoria. Clique em “Ok” para prosseguir. ![](/download/attachments/344461282/image2018-3-12_10-47-20.png?version=1&modificationDate=1520862441000&api=v2)
|
Card |
---|
| O sistema executará a atualização e apresentará na aba mensagens (canto inferior) o status da operação e a finalização da conexão com o serviço. Image Modified
|
Card |
---|
| Acesse novamente o diretório appserver no diretório de instalação do TSS (...bin\appserver) e localize o arquivo appserver.ini. Edite este arquivo com um editor de texto, localize a tag [ONSTART], retire o comentário da mesma e salve o arquivo. ![](/download/attachments/344461282/image2018-3-12_10-48-33.png?version=1&modificationDate=1520862513000&api=v2)
|
Card |
---|
| Após a alteração, reinicie o serviço TSS-Appserver12. ![](/download/attachments/344461282/image2018-3-12_10-48-56.png?version=1&modificationDate=1520862537000&api=v2)
|
|
Atualização do Dicionário - Arquivos .txt
A atualização do dicionário é composta por três fases:
1º - Substituição dos arquivos
2º - Execução do UPDDISTR
3º - Execução do UPDTAF
Para que a atualização seja realizada com sucesso, execute todos os procedimentos listados.
Backup e aplicação dos novos arquivos:
Para atualizar o "Dicionário de Dados" do TAF, realize os procedimentos abaixo:
Deck of Cards |
---|
id | Atualização Dicionário de Dados |
---|
|
Card |
---|
| Na tela de download é possível identificar que o arquivo que será baixado se trata de um "Dicionário Diferencial" do TAF. Veja abaixo: ![](/download/attachments/344461282/image2018-3-12_11-27-35.png?version=1&modificationDate=1520864855000&api=v2)
|
Card |
---|
| Após certificar-se que se trata de um Dicionário do TAF - TOTVS Automação Fiscal, acesse o diretório systemload na pasta de instalação do sistema (C:\totvs\TAF\systemload) e crie uma pasta com o nome "Backup". ![](/download/attachments/344461282/image2018-3-12_11-32-32.png?version=1&modificationDate=1520865153000&api=v2)
|
Card |
---|
| Pare o serviço do TAF-WS nos serviços do Windows Caso o serviço não seja parado automaticamente, apresentando a mensagem abaixo, realize o procedimento indicado na aba “Dica!” antes de prosseguir: ![](/download/attachments/344461282/image2018-3-12_11-22-43.png?version=1&modificationDate=1520864564000&api=v2)
|
Card |
---|
| Procedimento para parar o serviço através do DOS: Acesse o “Gerenciador de tarefas do Windows” > aba “Serviços” e localize o código PID do mesmo. No prompt de comando do DOS (cmd) digite: taskkill /pid XXXX /f (onde XXXX é o PID do serviço) e tecle “Enter”. Neste momento o serviço será interrompido. ![](/download/attachments/344461282/image2018-3-12_11-24-30.png?version=1&modificationDate=1520864671000&api=v2)
Realizado o procedimento de parada do serviço, voltamos para a atualização do dicionário. |
Card |
---|
| Mova os arquivos antigos (hlpdfpor.txt e sdfbra.txt) para este diretório (C:\totvs\TAF\systemload\Backup). Em seguida coloque o novo arquivo no diretório (C:\totvs\TAF\systemload). ![](/download/attachments/344461282/image2018-3-12_11-37-52.png?version=1&modificationDate=1520865472000&api=v2)
|
Card |
---|
| Coloque o novo arquivo no diretório C:\totvs\TAF\systemload. ![](/download/attachments/344461282/image2018-3-12_11-40-18.png?version=1&modificationDate=1520865618000&api=v2)
|
|
Execução do UPDDISTR e UPDTAF
Importante: Antes de executar estes procedimentos, certifique-se que o serviço TAF-WS está parado.
UPDDISTR
Deck of Cards |
---|
|
Card |
---|
| Acesse o diretório C:\totvs\TAF\bin\smartclient e localize o aplicativo “smartclient.exe” e execute o mesmo: ![](/download/attachments/344461282/image2018-3-12_16-22-43.png?version=1&modificationDate=1520882563000&api=v2)
|
Card |
---|
| Na tela de parâmetros iniciais, digite UPDDISTR na opção “Programa Inicial” e confira as demais informações. As mesmas deverão estar de acordo com a imagem abaixo. Clique em “Ok” para iniciar o processo de atualização das informações: ![](/download/attachments/344461282/image2018-3-12_15-9-15.png?version=1&modificationDate=1520878155000&api=v2)
|
Card |
---|
| Neste momento, a tela referente a atualização das informações presentes no dicionário será apresentada. Realize o backup dos diretórios informados antes de prosseguir. Clique em “Avançar” para continuar o wizard: ![](/download/attachments/344461282/image2018-3-12_15-9-37.png?version=1&modificationDate=1520878178000&api=v2)
|
Card |
---|
| A tela de termo de aceite será apresentada. Clique em “Avançar” par a prosseguir com a atualização. ![](/download/attachments/344461282/image2018-3-12_15-10-4.png?version=1&modificationDate=1520878204000&api=v2)
|
Card |
---|
| Marque a opção aceite das alterações realizadas na versão que será aplicada pelo wizard e clique em “Avançar”. ![](/download/attachments/344461282/image2018-3-12_15-10-26.png?version=1&modificationDate=1520878227000&api=v2)
|
Card |
---|
| Marque a opção referente a realização dos backups sugeridos anteriormente e clique em “Avançar”. ![](/download/attachments/344461282/image2018-3-12_15-10-58.png?version=1&modificationDate=1520878259000&api=v2)
|
Card |
---|
| Marque a opção referente a validação de possíveis customizações existentes e clique em “Avançar” para prosseguir: ![](/download/attachments/344461282/image2018-3-12_15-11-53.png?version=1&modificationDate=1520878314000&api=v2)
|
Card |
---|
| Clique novamente em “Avançar” para prosseguir com a atualização ou em “Cancelar” para sair do atualizador: ![](/download/attachments/344461282/image2018-3-12_15-12-25.png?version=1&modificationDate=1520878346000&api=v2)
|
Card |
---|
| A tela de início do processo de atualização será exibida: ![](/download/attachments/344461282/image2018-3-12_15-33-45.png?version=1&modificationDate=1520879626000&api=v2)
|
Card |
---|
| Neste momento, caso tenha alterado a senha do usuário “Administrador”, informe a mesma e clique em “Avançar”. Caso a senha não tenha sido alterada/cadastrada, utilize a tecla “Tab” para habilitar o botão “Avançar” e clique no mesmo para prosseguir: ![](/download/attachments/344461282/image2018-3-12_15-34-2.png?version=1&modificationDate=1520879642000&api=v2)
|
Card |
---|
| Nesta tela, verifique se as informações referentes ao diretório de dados se encontram vazias (conforme imagem abaixo). Caso estejam preenchidas, dê um duplo clique no campo, apague as informações e utilize a tecla “Tab” para salvar a alteração. Clique em “Avançar” para prosseguir: ![](/download/attachments/344461282/image2018-3-12_15-35-39.png?version=1&modificationDate=1520879740000&api=v2)
|
Card |
---|
| Na tela referente aos logs do processo de atualização, deixe somente a opção “” desmarcada e clique em “Avançar”: ![](/download/attachments/344461282/image2018-3-12_15-36-1.png?version=1&modificationDate=1520879762000&api=v2)
|
Card |
---|
| Todas as validações que serão realizadas pela atualização serão apresentadas neste momento. Clique em “Avançar” para iniciar o processamento: ![](/download/attachments/344461282/image2018-3-12_15-36-22.png?version=1&modificationDate=1520879782000&api=v2)
|
Card |
---|
| O sistema iniciará a atualização das informações do ambiente. ![](/download/attachments/344461282/image2018-3-12_15-36-43.png?version=1&modificationDate=1520879804000&api=v2)
|
Card |
---|
| Este processo pode levar alguns minutos. Aguarde até a conclusão da atualização. ![](/download/attachments/344461282/image2018-3-12_15-37-2.png?version=1&modificationDate=1520879822000&api=v2)
|
Card |
---|
| Ao final do processo, será exibida a tela de conclusão do mesmo. Clique em finalizar para concluir a atualização. ![](/download/attachments/344461282/image2018-3-12_15-59-15.png?version=1&modificationDate=1520881156000&api=v2)
|
Card |
---|
| A tela abaixo será exibida para informar que o sistema será finalizado. ![](/download/attachments/344461282/image2018-3-12_16-0-13.png?version=1&modificationDate=1520881213000&api=v2)
|
|
UPDTAF
Deck of Cards |
---|
|
Card |
---|
| Acesse o diretório C:\totvs\TAF\bin\smartclient e localize o aplicativo “smartclient.exe” e execute o mesmo. ![](/download/attachments/344461282/image2018-3-12_16-23-40.png?version=1&modificationDate=1520882621000&api=v2)
|
Card |
---|
| Na tela de parâmetros iniciais, digite UPDTAF na opção “Programa Inicial” e confira as demais informações. As mesmas deverão estar de acordo com a imagem abaixo. Clique em “Ok” para iniciar o processo de atualização das informações (a apresentação da tela de UPDATE pode levar alguns minutos). ![](/download/attachments/344461282/image2018-3-12_16-16-41.png?version=1&modificationDate=1520882202000&api=v2)
|
Card |
---|
| Selecione as atualizações que estiverem como “Pendente” e clique em “Processar”. ![](/download/attachments/344461282/image2018-3-12_16-17-47.png?version=1&modificationDate=1520882267000&api=v2)
|
Card |
---|
| Neste momento serão apresentadas as atualizações que serão realizadas. Clique em "Finalizar para" concluir a atualização do “Dicionário de dados”. ![](/download/attachments/344461282/image2018-3-12_16-19-8.png?version=1&modificationDate=1520882348000&api=v2)
|
Card |
---|
| Após a execução de todos os passos da atualização (UPDDISTR e UPDTAF), reinicie o serviço TAF-WS nos serviços do Windows. ![](/download/attachments/344461282/image2018-3-12_16-27-36.png?version=1&modificationDate=1520882857000&api=v2)
|
|