Nota |
---|
O uso de um servidor de locks de arquivo é necessário para contornar uma limitação referente ao acesso e uso exclusivo de acesso direto a arquivos e pastas em ambiente Linux. Não se trata de lock de registros de tabelas de dados, mas sim da abertura de arquivos no disco em modo exclusivo ou compartilhado, usados por exemplo pelas funções fCreate / fOpen, para que estas funções e os demais acessos a API de arquivos feitas pelo TOTVS | Application Server tenham o comportamento esperado, necessário para o correto funcionamento da aplicação. |
Nota |
---|
O servidor de locks deve ser um dos primeiros servidores de aplicação a ser inicializado e um dos últimos a ser finalizado. Caso o serviço não esteja ativo, ou caso ele seja finalizado enquanto os demais serviços que o utilizam estejam executando aplicações Advpl, todos os outros serviços que realizarem uma requisição ao LockServer serão interrompidos com uma ocorrência de erro de conexão com o LockServer. |
Estrutura
Veja a seguir as chaves relacionadas à seção [LockServer]:
Informações |
---|
Normalmente o servidor de aplicação utilizado como Master para balanceamento de carga é configurado automaticamente como servidor de locks, entretanto é possível iniciar uma nova instância exclusivamente para atuar como LockServer. |
Exemplos
Instância única
Em ambientes onde somente um único servidor de aplicação atende todos os usuários (pequenos ambientes de produção ou ainda ambientes de desenvolvimento), somente é necessário configurar a seção [LockServer] como abaixo:
Sem Formato |
---|
[LockServer]
Enable=1
Server=192.168.1.100
Port=1234 |
Nota |
---|
Supondo que o IP do servidor de aplicação (que é o servidor de locks) seja 192.168.1.100, e a chave Port corresponde à porta do servidor de aplicação que recebe as requisições. |
Múltiplas instâncias/ambientes balanceados
Em ambientes balanceados e em ambientes que separamos um servidor de aplicação para algum serviço específico, é necessário configurar um LockServer e nos demais indicar o uso do LockServer configurado.
Configuração do LockServer:
Sem Formato |
---|
[General]
CanAcceptFSRemote=1
[LockServer]
Enable=1
Server=192.168.1.100
Port=1234
; chaves opcionais:
WorkThreadQtdMin=1000
WorkThreadStackSize=131072 |
Supondo que o IP do servidor de locks seja 192.168.1.100
A chave Port corresponde à porta do servidor de aplicação que recebe as requisições.
A chave de configuração CanAcceptFSRemote deve ser habilitada na seção [GENERAL] do serviço configurado para ser o LockServer, para que este esteja habilitado a aceitar as conexões dos demais serviços do TOTVS | Application Server que apontam para este servidor de locks.
A chave de configuração [LockServer] WorkThreadQtdMin é opcional e, nesta configuração, substitui o valor da chave [General] WorkThreadQtdMin.
A chave de configuração [LockServer] WorkThreadStackSize é opcional.
Configuração nos demais servidores:
Sem Formato |
---|
[LockServer]
Enable=0
Server=192.168.1.100
Port=1234 |
A chave Port corresponde à porta que o servidor de locks que recebe as requisições.