Dúvida
Como migrar o TSS para a última release (12.1.2510)? 

Ambiente
Cross Segmentos - TSS Transmissão de Documentos Eletrônicos - Todas as versões

Solução
O TSS 12.1.2510 é um produto diferente das versões anteriores e é compatível com diferentes versões de ERP, sendo necessário que seja efetuada uma nova instalação e não seja reutilizado nenhum arquivo de configuração referente as releases anteriores (pastas, appserver.ini e etc.).

Mesmo que não seja reaproveitado o arquivo appserver.ini, é possível reutilizar APENAS as portas de conexões TCP, HTTP e até mesmo a URL do serviço.

Para essa nova versão devem atualizar o DBAccess antes de migração e checar se o banco de dados utilizado no ambiente é compatível:
- Framework - Linha Protheus - Atualização do DBAccess
- Engenharia - Linha Protheus - Banco de Dados Homologados

Após a migração, é necessário que atualizem o arquivo do dbapi.dll (para Windows) ou dbapi.so (para Linux) dentro da pasta do Appserver do TSS, de acordo com a versão do DBAccess utilizada. (Giff com o processo de atualização: clique aqui.)

O banco de dados poderá ser o mesmo, pois ao subir o novo serviço o próprio sistema fica encarregado de atualizar os índices e estruturas das tabelas.

É necessário notar que a versão 12.1.2510 possui um binário e um RPO especifico para essa versão, deve-se atentar para não aplicar atualizações referente a releases diferentes. 

O uso do smartclient foi descontinuado na release 2510, desta forma no processo de funcionamento padrão do sistema não será possível utilizar o smartclient de versões anteriores. Sendo assim, o acesso deverá ser realizado via WebApp: detalhes clicando aqui.

Após a migração deverá ser instalado o webagent e atualizar o webapp.dll na pasta appserver para ter acesso as interfaces gráficas do TSS, que a partir dessa versão será via web:
- https://tdn.totvs.com/display/tec/2.+WebApp+-+WebAgent

Webapp
- https://suporte.totvs.com/portal/p/10098/download#detail/1168455 (Windows 64)
- https://suporte.totvs.com/portal/p/10098/download#detail/1168456 (Linux)

Instaladores Release 12.1.2510:
- Windows: clique aqui.
- Linux: clique aqui.

Importante

Após Instalação, será necessário aplicar as ultimas atualizações do binário e fontes (RPO) disponibilizados conforme consta na documentação abaixo:
- MP - TSS - Atualização do Appserver (binário) do TSS
- MP - TSS - Atualização do Repositório (RPO) do TSS
- TSS - Atualização dos SCHEMAS
- TSS - Atualização das URLs do TSS
- TSS Transmissão de Documentos Eletronicos - NFSe - Configuração do NEWNFSE

Processo de instalação do TSS:
- Instalação TSS on-line
- Instalação do TSS off-line

Atenção: A versão off-line do TSS deve ser utilizada apenas para os clientes que utilizam o módulo do loja para comunicação dos caixas com a retaguarda.

Recomendação, leia o processo abaixo antes de começar a realizar a migração da versão do seu TSS.

A partir da release 12.1.2510, o TSS adota uma gestão unificada de usuários, centralizando os dados exclusivamente no banco de dados (tabelas SYS_USR e derivações).

Anteriormente, o sistema utilizava dois arquivos separados para o gerenciamento de credenciais:

• sigapss.spf: Para acesso ao APSDU e VSCode.
• smallapppss.spf: Para rotinas do TSS (TSSInterface, TSSMonitor, TSSManager).

Com essa mudança, o acesso a todas essas ferramentas passa a utilizar um único cadastro. A rotina de gestão de usuários também foi atualizada. Para mais detalhes, consulte: TSS0077 - Novo processo de manutenção de usuário através das interfaces do TSS.

Pré-requisitos e Cuidados na Migração

Devido à mudança estrutural, a migração de ambientes na release 12.1.2410 ou inferiores para a 12.1.2510 (ou superiores) exige preparações específicas. É altamente recomendado executar os procedimentos abaixo antes de iniciar a migração:

1. Backup Completo: Realize o backup integral do banco de dados, do arquivo appserver.ini e do RPO do TSS.
2. Atualização do RPO: Atualize o RPO (com as LIBs atualizadas) para a versão mais recente disponível na Central de Downloads.
   • Link RPO TSS 2510: https://suporte.totvs.com/portal/p/10098/download?e=1224121
3. Atualização do AppServer: Atualize o binário do AppServer para a última versão disponível ou, no mínimo, para a versão 24.3.1.2.
4. Uso do Instalador Correto: Se utilizar um instalador para a migração, certifique-se de usar o instalador específico do TSS (disponível na Central de Downloads), e não o instalador do ERP Protheus.

Aviso Importante (O que NÃO fazer):

Ao utilizar o instalador para migrar o TSS para novas releases, nunca inicie o serviço do TSS antes de ter concluído todas as atualizações descritas nos passos acima.


 

Comportamento Esperado Durante a Subida do Serviço

 

Se os pré-requisitos forem cumpridos, ao iniciar o serviço do TSS pela primeira vez, o sistema entrará automaticamente em modo exclusivo para atualizar tabelas, campos, índices e realizar a carga de processos internos.


 

Início da Atualização: O processo será indicado no console/log pela mensagem:

Conclusão Estrutural: O término da atualização do dicionário de dados será indicado pela mensagem:

Criação de Usuários: Em seguida, o sistema iniciará a criação das tabelas de usuários no banco de dados e a geração do usuário Administrador padrão.

 

Atenção em caso de Falhas:

Se durante o processo ocorrer um erro com a descrição "Falha ao carregar a senha do arquivo para o banco de dados" (ou similar), pare o serviço, restaure os backups realizados anteriormente e acione a equipe de Suporte Técnico da TOTVS para análise.

 

Continuidade e Validação

Se o processo for concluído com sucesso, o sistema seguirá com as demais atualizações padrão do TSS (como URLs e municípios de NFS-e).

Como validar a migração: Execute uma consulta SQL diretamente na tabela SYS_USR. O primeiro registro retornado na tabela deve ser obrigatoriamente o usuário "Administrator".

Configuração de Segurança Inicial: Por padrão, o usuário criado na migração será o admin com a senha em branco. Por motivos de segurança, altere essa senha imediatamente através do TSSINTERFACE. (Consulte o documento TSS0077 para o passo a passo).

Configuração de appserver.ini: Após atualização, o arquivo appserver.ini do TSS passa a ter a tag StartSysInDB com conteúdo igual à 1 (um). Isso faz com que o sistema entenda que deve-se usar autenticação utilizando as tabelas do banco de dados e não os arquivos locais sigapss.spf.

Importante: Para que o processo de criação das tabelas de usuário no banco de dados do TSS seja realizado, esta tag não deve existir no appserver.ini.

Conclusão

Com a migração finalizada, você poderá utilizar o mesmo usuário e senha unificados para acessar o APSDU, aplicar pacotes via IDE e logar nas rotinas nativas do TSS (TSSMonitor, TSSInterface, etc).

Uma vez que esta migração ocorra, este processo não será mais realizados nas próximas migrações de release do TSS.