📅 Data de publicação
02/04/2026
🎯 Objetivo
Orientar o processo de instalação e atualização do TSS 12.1.2410, destacando os cuidados técnicos necessários para a migração a partir de versões anteriores e os pontos obrigatórios de validação após a implantação. (Central de Atendimento TOTVS)
🖥️ Ambiente
Cross Segmentos - TOTVS Backoffice (Linha RM) - Documentos Eletrônicos
Aplicável ao TSS a partir da versão 12.1.2210. (Central de Atendimento TOTVS)
🧩 Visão geral
A release 12.1.2410 do TSS deve ser tratada como um produto diferente das versões anteriores. Por esse motivo, a TOTVS orienta que seja feita uma nova instalação, sem reaproveitar arquivos de configuração antigos, como pastas da instalação anterior, appserver.ini e demais componentes herdados de releases passadas. (Central de Atendimento TOTVS)
Embora a estrutura anterior não deva ser reutilizada, é permitido reaproveitar as portas de conexão TCP, HTTP e até a mesma URL do serviço, desde que a nova instalação seja feita corretamente. (Central de Atendimento TOTVS)
⚠️ Premissas importantes da release 12.1.2410
1. Nova instalação obrigatória
Na migração para o TSS 12.1.2410, não se deve simplesmente copiar a estrutura de uma release anterior. O procedimento correto é instalar uma nova instância do produto e configurar novamente o ambiente. (Central de Atendimento TOTVS)
2. Não reutilizar arquivos antigos
A TOTVS deixa claro que não devem ser reutilizados arquivos de configuração de releases anteriores, inclusive appserver.ini e pastas antigas. Isso evita inconsistências de ambiente e problemas de compatibilidade. (Central de Atendimento TOTVS)
3. Banco de dados pode ser mantido
O banco de dados pode ser o mesmo da instalação anterior, pois ao subir o novo serviço o próprio sistema executa a atualização dos índices e das estruturas das tabelas necessárias ao funcionamento da nova versão. (Central de Atendimento TOTVS)
4. Binário e RPO devem ser específicos da release
A versão 12.1.2410 possui binário e RPO próprios, e não devem ser aplicadas atualizações de releases diferentes nesse ambiente. Misturar componentes de versões distintas pode comprometer o funcionamento do TSS. (Central de Atendimento TOTVS)
🔄 Atualização do DBAccess
Após a migração, é necessário atualizar o arquivo da DBApi dentro da pasta do AppServer do TSS, respeitando o sistema operacional em uso:
Windows:
dbapi.dllLinux:
dbapi.so
Essa atualização deve ser compatível com a versão do DBAccess utilizada no ambiente. (Central de Atendimento TOTVS)
🌐 Alteração de interface na release 2410
A TOTVS informa que o uso do SmartClient foi descontinuado na release 2410. Com isso, o acesso padrão às interfaces gráficas do TSS passa a ocorrer via web. (Central de Atendimento TOTVS)
Após a migração, torna-se necessário instalar o WebAgent na máquina para viabilizar esse acesso web ao sistema. (Central de Atendimento TOTVS)
✅ Procedimento recomendado de instalação e atualização
1. Preparar a nova instalação
Realize a instalação do TSS 12.1.2410 como um novo produto, sem copiar a estrutura anterior. Caso necessário, mantenha apenas as mesmas portas TCP, HTTP e a mesma URL do serviço. (Central de Atendimento TOTVS)
2. Validar o banco de dados
A base de dados pode ser reaproveitada, desde que a nova instância do TSS seja iniciada corretamente para promover a atualização das estruturas e índices. (Central de Atendimento TOTVS)
3. Atualizar a DBApi
Após a instalação, substitua a biblioteca correspondente ao banco no diretório do AppServer do TSS, de acordo com o sistema operacional e a versão do DBAccess em uso. (Central de Atendimento TOTVS)
4. Instalar o WebAgent
Como a interface do TSS nessa release passa a operar via web, instale o WebAgent no servidor ou estação apropriada para acesso às telas do sistema. (Central de Atendimento TOTVS)
5. Aplicar as atualizações obrigatórias
Depois da instalação, a TOTVS orienta aplicar as últimas atualizações de:
binário do AppServer
repositório (RPO)
schemas
URLs do TSS
configuração do NEWNFSE, quando aplicável ao cenário da empresa. (Central de Atendimento TOTVS)
🛠️ Cuidados técnicos essenciais
Para reduzir riscos durante a migração, recomenda-se observar os seguintes pontos:
não reaproveitar arquivos antigos de configuração;
utilizar somente componentes compatíveis com a release 12.1.2410;
garantir a atualização da DBApi após a migração;
validar a instalação do WebAgent;
revisar as atualizações complementares de binário, RPO, schemas e URLs após a instalação. (Central de Atendimento TOTVS)
📌 Conclusão
A atualização para o TSS 12.1.2410 não deve ser tratada como uma simples sobreposição de arquivos. Trata-se de uma nova instalação, com arquitetura e premissas próprias, exigindo atenção especial à não reutilização de arquivos antigos, à atualização da DBApi, ao uso de binário/RPO específicos da release e à adoção do acesso via WebAgent, já que o SmartClient foi descontinuado nessa versão. (Central de Atendimento TOTVS)
❓ FAQ
1. Posso atualizar o TSS 12.1.2410 reaproveitando a pasta da versão anterior?
Não. A orientação é realizar nova instalação, sem reutilizar pastas, appserver.ini ou arquivos de configuração de releases anteriores. (Central de Atendimento TOTVS)
2. Posso manter o mesmo banco de dados?
Sim. O banco pode ser o mesmo, pois o novo serviço atualiza automaticamente os índices e estruturas das tabelas necessárias. (Central de Atendimento TOTVS)
3. Posso usar binário ou RPO de outra release?
Não. A release 12.1.2410 possui binário e RPO específicos, e não devem ser aplicados componentes de outras versões. (Central de Atendimento TOTVS)
4. O SmartClient continua sendo utilizado nessa release?
Não. O uso do SmartClient foi descontinuado na release 2410. O acesso às interfaces passa a ser realizado via web. (Central de Atendimento TOTVS)
5. O que preciso instalar para acessar a interface gráfica do TSS?
É necessário instalar o WebAgent, pois a interface do TSS nessa release passa a funcionar via navegador/web. (Central de Atendimento TOTVS)
6. A atualização da DBApi é obrigatória?
Sim. Após a migração, deve-se atualizar o arquivo dbapi.dll no Windows ou dbapi.so no Linux, conforme a versão do DBAccess utilizada. (Central de Atendimento TOTVS)
👤 Autor
Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria
“Conectamos tecnologia, processos e pessoas para acelerar resultados com excelência em sistemas TOTVS.”